explaingit

yu9191/wloc

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

⭐ Rising2,754JavaScriptAudience · generalComplexity · 2/5ActiveLicenseSetup · moderate

TLDR

Fake your iPhone's network-based location without jailbreaking. Pick a spot on a map and your phone reports that location instead of your real one, using popular iOS proxy tools.

Mindmap

mindmap
  root((repo))
    What it does
      Spoofs iPhone location
      No jailbreak needed
      Works with proxy apps
    How it works
      Intercepts Apple location server
      Swaps in chosen coordinates
      Web map or Shortcut input
    Helper service
      Parses map links
      Converts coordinate formats
      Stores no data
    Use cases
      Social app check-ins
      Test location features
      Region-restricted content
    Deployment
      Cloudflare free tier
      Open source
    Caveats
      iOS 26 needs restart
      Best indoors
      Network positioning only
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

Fake your iPhone location to check in at different places on social apps.

USE CASE 2

Test location-based features in your app from a different spot.

USE CASE 3

Access region-restricted content by appearing in another location.

USE CASE 4

Spoof WiFi-based location indoors where satellite GPS signal is weak.

What is it built with?

JavaScriptCloudflare WorkersSurgeQuantumult XLoonStashShadowrocket

How does it compare?

yu9191/wlocforward-future/loopycloudflare/security-audit-skill
Stars2,7542,3452,252
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-272026-07-032026-07-03
MaintenanceActiveActiveActive
Setup difficultymoderatemoderateeasy
Complexity2/52/52/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 a compatible iOS proxy tool like Surge or Quantumult X, and a Cloudflare account if you want to self-host.

Open source, you can use, modify, and deploy it freely, including running your own instance on Cloudflare.

In plain English

This project lets you fake your iPhone's location without jailbreaking or installing shady apps. You pick a spot on a map, and your phone's network-based location (WiFi and cell tower positioning) reports that spot instead of where you actually are. It works with popular iOS proxy tools like Surge, Quantumult X, Loon, Stash, and Shadowrocket, apps that many people already run to manage network traffic. The way it works is clever but straightforward. Apple's devices ask a server (gs-loc.apple.com) to estimate location based on nearby WiFi networks and cell towers. This tool intercepts that response and swaps in your chosen coordinates before the phone sees them. You set your desired location through a web-based map page or an iOS Shortcut, and the tool remembers it. There's also a helper service that parses map links from Apple Maps or AutoNavi (a Chinese map app) and handles coordinate format conversions, since China uses a special offset coordinate system. The helper doesn't store any data, it just translates links to coordinates and throws everything away. The main audience is iPhone users in China who want to spoof their location for things like checking in to different places on social apps, testing location-based features, or accessing region-restricted content. Since it only affects network positioning (not the GPS hardware chip), it works best indoors where WiFi-based location dominates. If you're standing outside with strong GPS signal, your phone might override the fake location with real satellite data. One important caveat: starting with iOS 26, Apple added aggressive caching to the location system. Even after setting up the spoof, you may need to restart your device for changes to take effect, toggling airplane mode or location services won't cut it anymore. On iOS 15 through 18, changes usually apply without a reboot. The project is open source, and you can deploy your own instance on Cloudflare's free tier to avoid hitting the public server's request limits. The privacy model is clean: the link-parsing service processes requests without logging or storing anything.

Copy-paste prompts

Prompt 1
Help me set up wloc to spoof my iPhone location using Surge or Quantumult X. I want to appear in a specific city, walk me through the proxy configuration and web map setup.
Prompt 2
I want to deploy my own wloc instance on Cloudflare Workers so I don't hit the public server's request limits. Give me step-by-step deployment instructions.
Prompt 3
I'm on iOS 26 and my spoofed location isn't updating even after toggling airplane mode. Help me troubleshoot the aggressive caching issue and get the fake location to stick.
Prompt 4
How do I use an Apple Maps or AutoNavi link to set my fake location with wloc? Explain how the link-parsing helper works and what coordinate conversion it handles.

Frequently asked questions

What is wloc?

Fake your iPhone's network-based location without jailbreaking. Pick a spot on a map and your phone reports that location instead of your real one, using popular iOS proxy tools.

What language is wloc written in?

Mainly JavaScript. The stack also includes JavaScript, Cloudflare Workers, Surge.

Is wloc actively maintained?

Active — commit in last 30 days (last push 2026-06-27).

What license does wloc use?

Open source, you can use, modify, and deploy it freely, including running your own instance on Cloudflare.

How hard is wloc to set up?

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

Who is wloc for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub yu9191 on gitmyhub

Verify against the repo before relying on details.