xweiba/location-spoofer

What it solves

Location Spoofer is a framework designed for iOS location service research, software development testing, and QA verification. It allows developers to simulate different geographical locations and positioning scenarios without modifying the target application's source code, helping them verify how their apps behave in various global locations.

How it works

The project uses a proxy layer to intercept and modify responses from Apple's location services. It offers two distinct operating modes:

• APP Mode: Runs a local Go-based proxy within the device. It requires the user to configure a manual HTTP proxy for the current Wi-Fi network and trust a local CA certificate. It only covers the Wi-Fi network.
• Third-Party Proxy Mode: The app acts as a controller for selecting coordinates on a map and syncing them to a supported third-party proxy client (like Shadowrocket, Surge, or Quantumult X). The third-party client then handles the MITM (Man-in-the-Middle) interception and coordinate injection into the location service responses.

Who it’s for

This tool is primarily for iOS developers, QA engineers, and researchers studying iOS location services.

Highlights

• Native Map Interaction: Uses MapKit for intuitive coordinate selection, searching, and saving favorite locations.
• Coodinate Management: Supports both WGS-84 (international standard) and GCJ-02 (Chinese map standard) to prevent position offset.
• Non-Invasive: Does not require modifying the target app's code or using a VPN (in APP mode).
• Environment Diagnostics: Includes built-in tools to detect proxy status, certificate trust, and request links to help troubleshoot configuration issues.
• ** uma l-based Proxy**: Leverages a Go-based core for efficient handling of location service requests.