ios-location-spoofer is a standalone iOS app to spoof GPS location without jailbreak. Includes Shadowrocket/Surge/Loon/QX/Stash module.

This project is based on the core research of `acheong08/ios-location-spoofer`. The original project is an independent iOS App written in Go, using a self-built VPN + MITM proxy to implement location spoofing.

This repository ports its core logic to JavaScript and adapts it to five proxy platforms: Shadowrocket / Surge / Loon / Quantumult X / Stash. It requires no compiling and no developer account: import and use.

### What it does

iPhone looks at Wi‑Fi signals and cellular base-station signals, then asks Apple where these devices are by sending a BSSID list. Apple returns a coordinate list, and iOS calculates where it is based on these coordinates.

This configuration intercepts the coordinates on the way back from Apple and changes them all to the numbers you want. After the iPhone receives the modified coordinates, the calculated location becomes the place you specified.

### Added compared with the original version

- **Multi-platform support** — expanded from a single iOS App to five proxy apps.

- **Cell tower coordinate modification** — the original Go version only modified Wi‑Fi hotspot coordinates; the JS version also handles CellTower coordinate replacement.

- **Multiple response-format compatibility** — automatically detects Apple response wrapper formats such as ARPC / synthetic / marker / bare.

- **Motion state spoofing** — also rewrites `motionActivityType` and `motionActivityConfidence`.

### Supported software

- Shadowrocket: `ios-location-spoofer.sgmodule`

- Surge: `ios-location-spoofer-surge.sgmodule`

- Loon: `ios-location-spoofer.lnplugin`

- Quantumult X: `ios-location-spoofer.snippet`

- Stash: `ios-location-spoofer.stoverride`

### Basic usage

1. Enable HTTPS decryption / MITM in the proxy app.

2. Install and trust the CA certificate.

3. Import the module file and enable it.

4. Disconnect and reconnect the VPN, then toggle Location Services.

5. Open the Maps app to verify.

Default location is Apple Park: `37.3349, -122.00902`.