explaingit

mekos2772/ios-location-spoofer

Analysis updated 2026-07-03 · repo last pushed 2026-07-03

⭐ Rising1,244JavaScriptAudience · generalComplexity · 3/5ActiveSetup · moderate

TLDR

A tool that tricks your iPhone into reporting a fake location without jailbreaking. It works by intercepting Apple's location data inside supported proxy apps and swapping in coordinates you choose.

Mindmap

mindmap
  root((repo))
    What it does
      Fake iPhone GPS
      No jailbreak needed
      Intercept Apple location
    Tech stack
      JavaScript
      Cloudflare
      Proxy app modules
    Use cases
      App testing
      Privacy protection
      Access restricted content
    How it works
      Swaps coordinates
      Fakes cell towers
      Adjusts motion data
    Setup
      Pick a proxy app
      Trust custom certificate
      Set latitude and longitude
    Extra tools
      Web map for picking spots
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Test location-based app features without physically traveling to a location.

USE CASE 2

Protect your privacy by preventing your iPhone from reporting your real location.

USE CASE 3

Access location-restricted content by spoofing a different country or region.

USE CASE 4

Visually pick a fake location on a map using the optional Cloudflare web tool.

What is it built with?

JavaScriptCloudflareShadowrocketSurgeLoonQuantumult X

How does it compare?

mekos2772/ios-location-spooferfoundzigu/gujumpgaterebel0789/codexpro
Stars1,2441,3451,134
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-07-032026-06-30
MaintenanceActiveActive
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires one of five paid proxy apps (Shadowrocket, Surge, Loon, Quantumult X, or Stash) and involves enabling HTTPS decryption plus trusting a custom certificate.

The license for this repository is not specified in the available information, so usage rights are unclear.

In plain English

iOS Location Spoofer is a tool that lets you trick your iPhone into thinking it's somewhere else in the world, without jailbreaking the device. You pick a set of coordinates, and your phone's location services will report that spot as your current position. Here's how it works under the hood. Your iPhone figures out where it is by looking at nearby Wi-Fi networks and cell towers, then asking Apple's servers where those networks are physically located. Apple sends back a list of coordinates, and the phone calculates its position from that data. This tool intercepts Apple's response mid-flight and swaps the real coordinates with whatever location you want. Your phone receives the modified data and calculates its position accordingly. To pull this off, the tool plugs into proxy apps like Shadowrocket, Surge, Loon, Quantumult X, or Stash, which handle the interception step. The people who'd use this are anyone who needs their iPhone to report a different location, for app testing, privacy, or accessing location-restricted content. You'd need to already use one of the five supported proxy apps, since the spoofer runs as a module inside them. Setup involves enabling HTTPS decryption in your proxy app, trusting a custom certificate, and importing the right module file. After that, you set your desired latitude and longitude, and toggle your location services to activate the spoof. What's notable is that the project goes beyond simple coordinate swapping. It also fakes cell tower coordinates, adjusts motion activity data to reduce the chance of iOS catching on, and handles multiple response formats that Apple uses. There's an optional web-based map tool (deployable on Cloudflare) for picking locations visually instead of looking up coordinates manually. The README includes a beginner-friendly walkthrough with step-by-step instructions and troubleshooting tips, acknowledging that the setup process involves several moving parts.

Copy-paste prompts

Prompt 1
Help me set up the iOS Location Spoofer module in Shadowrocket. I have HTTPS decryption enabled and the custom certificate trusted, what are the exact steps to import the module file and set my desired coordinates?
Prompt 2
I want to use the optional Cloudflare web map tool to pick a location visually. Walk me through deploying it and connecting it to my proxy app setup for iOS location spoofing.
Prompt 3
My iPhone keeps detecting that my location is spoofed when using this tool. How do I configure the cell tower faking and motion activity adjustment features to reduce detection?
Prompt 4
Compare the five supported proxy apps (Shadowrocket, Surge, Loon, Quantumult X, Stash) for running this iOS location spoofer. Which is easiest for a beginner who has never used a proxy app before?

Frequently asked questions

What is ios-location-spoofer?

A tool that tricks your iPhone into reporting a fake location without jailbreaking. It works by intercepting Apple's location data inside supported proxy apps and swapping in coordinates you choose.

What language is ios-location-spoofer written in?

Mainly JavaScript. The stack also includes JavaScript, Cloudflare, Shadowrocket.

Is ios-location-spoofer actively maintained?

Active — commit in last 30 days (last push 2026-07-03).

What license does ios-location-spoofer use?

The license for this repository is not specified in the available information, so usage rights are unclear.

How hard is ios-location-spoofer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ios-location-spoofer for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub mekos2772 on gitmyhub

Verify against the repo before relying on details.