ChrisMack32 GitHub avatar

Locus

ChrisMack32

Locus is a free and open-source iOS app that spoofs GPS location system-wide by using Apple's developer location service, allowing users to teleport to any location on a map.

Stars

127

7-day growth

No data

Forks

13

Open issues

1

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a system-level location spoof that works with most apps (except those with anti-cheat like Pokémon GO), is fully on-device with no analytics, and uses official Apple developer tools, not jailbreak.

Who it is for

  • iOS developers testing location-based features
  • Privacy-conscious users wanting to mask real location
  • Travelers or remote workers simulating location for apps like Maps
  • Users of location-based games that do not have anti-spoof checks

Use cases

  • Teleport to a specific address or coordinate for app testing
  • Simulate a walking or driving route using real roads
  • Create and import/export GPX tracks for outdoor activity planning
  • Maintain a spoofed location in background with status bar indicator

Strengths

  • Uses official Apple developer location service (DVT) for reliable spoofing
  • Fully on-device, no data uploaded, no analytics
  • Supports live joystick with speed control, routing, GPX import/export
  • Open-source MIT license, can be built from source with free Apple account

Considerations

  • Does not work with Pokémon GO and similar games that have anti-cheat checks
  • Requires initial setup with LocalDevVPN and a pairing file (iOS 18-26) or on-device pairing (iOS 27)
  • File picker may not work inside LiveContainer; workarounds exist

README quick start

Locus

Free and open-source iPhone location teleport. Tap the map, search a place, or drive a route — Locus injects coordinates through Apple’s developer location service into locationd, so Maps and other apps see the spoofed GPS (not just a Wi‑Fi lookup that outdoor GPS will overwrite).

Features

  • One-tap teleport (map pin or place search)
  • Live joystick — walk / run / cycle / drive with light speed variation
  • Walk/Drive routing on real roads & footpaths (MapKit)
  • Draw a path or import / export GPX
  • Background keep-alive + live status bar + drop alerts
  • Favorites & recents
  • First-run setup walkthrough
  • Fully on-device — no analytics, nothing uploaded

Install

See SETUP.md for full steps. Grab a prebuilt IPA from Releases, or build from source below.

Bundle ID: com.chrismack.locus

LiveContainer

File pickers often don’t work inside LiveContainer. Use one of these:

  1. Long-press Locus → Settings → enable Fix File Picker, then try Import again.
  2. Share the pairing file into LiveContainer → Locus.
  3. Copy the RPPairing plist contents → in Locus use Paste RPPairing from clipboard (setup or Settings).

How it works

Locus uses the MIT-licensed idevice FFI to talk to Apple’s DVT location simulation over an on-device developer tunnel (the same class of mechanism Xcode uses).

iOS 27: Settings → Pair on this iPhone advertises _remotepairing-pairable-host._tcp. Confirm the 6-digit code under Settings › Privacy & Security › Developer Mode › Pair with Host — no computer.

iOS 18–26: import an RPPairing file once from idevice_pair.

Also install LocalDevVPN (loopback tunnel, default 10.7.0.1), then sideload Locus.

Start a teleport on Wi‑Fi first; the session can keep working on cellular afterward.

Pokémon GO & similar games

Locus spoofs location the same way Xcode’s developer tools do: it tells iOS “you’re here,” and other apps read that from the system. Apps that just trust GPS (Apple Maps, etc.) will follow it.

Pokémon GO is different. It runs its own location checks and often rejects developer / simulated GPS (e.g. “Failed to detect location”). That’s ex

Description

Free open-source iPhone location teleport (MIT)

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20