How mekos2772/ios-location-spoofer works
This repository combines an iOS network-location spoofing module with an optional location-picker service. The main user workflow is to configure a target location, have a supported proxy intercept Apple’s WLOC response, and rewrite Wi-Fi and cell coordinates before iOS receives it. The picker offers Node and Cloudflare backends, plus token-based coordinate selection and administration. Edges reflect README statements and source-index references; some picker routes and platform wiring are documented but their full implementations were not sampled.
Main entry points: server.js Node picker API · admin.js Admin API · index.js Worker picker API · location-spoofer.js Response rewriter
Components 18
Location rewriting
- Platform modules
ios-location-spoofer.sgmodule - Response rewriter
location-spoofer.js - Quantumult X rewriter
location-spoofer-qx.js
Location picker
- Map picker UI
location-picker/server.js - Node picker API
location-picker/server.js - Picker database
location-picker/db.js - Remote location config
location-picker/server.js
Management
- Admin dashboard
location-picker/admin-page.js - Admin API
location-picker/admin.js
Cloudflare deployment
- Worker picker API
location-picker/worker/src/index.js - Worker map UI
location-picker/worker/src/page.js - Web UI Worker
location-picker/cloudflare-webui/worker.js - Worker KV
Other components
- iPhone user
- Proxy app
- Apple location service
- Picker user
- Map and geocoding
Connections 24
- iPhone user → Proxy app: configures
README.md - Proxy app → Apple location service: requests location
README.md - Apple location service → Proxy app: returns WLOC
README.md - Platform modules → Proxy app: configures interception
README.md - Proxy app → Response rewriter: runs response script
README.md - Proxy app → Quantumult X rewriter: runs QX script
README.md - Response rewriter → iPhone user: returns rewritten response
README.md - Quantumult X rewriter → iPhone user: returns rewritten response
README.md - Picker user → Map picker UI: selects coordinates
README.md - Map picker UI → Node picker API: saves location
location-picker/server.js - Node picker API → Picker database: reads and writes
location-picker/server.js - Node picker API → Remote location config: serves config
README.md - Remote location config → Response rewriter: provides coordinates
README.md - Remote location config → Quantumult X rewriter: provides coordinates
README.md - Map picker UI → Map and geocoding: searches and fetches elevation
README.md - Admin dashboard → Admin API: calls admin endpoints
location-picker/admin-page.js - Admin API → Admin dashboard: serves dashboard
location-picker/admin.js - Node picker API → Admin API: routes admin requests
location-picker/server.js - Admin API → Picker database: manages tokens and logs
location-picker/admin.js - Picker user → Worker map UI: selects coordinates
- Worker picker API → Worker map UI: serves page
location-picker/worker/src/index.js - Worker map UI → Worker picker API: saves selection
location-picker/worker/src/index.js - Worker picker API → Worker KV: reads and writes
location-picker/worker/src/index.js - Web UI Worker → Worker picker API: bundles worker implementation
location-picker/cloudflare-webui/worker.js