iOS-GPS-Spoofer README

The project's README from github.com/SegFault42/iOS-GPS-Spoofer. As one markdown file: README.md.

iosgpsspoof

Spoof the GPS location of a connected iPhone (iOS 17+) for as long as the tool runs. The fake location is cleared automatically on exit, and re-applied automatically if the device disconnects and reconnects.

Ships as two front-ends over a shared core (SpooferCore):

It drives Apple's developer location-simulation service — the same mechanism Xcode's Product ▸ Scheme ▸ Simulate Location uses. On iOS 17+ that service lives behind the encrypted CoreDevice tunnel, so the actual transport is handled by pymobiledevice3; this tool is the user-facing wrapper (CLI, device selection, the "keep it spoofed while connected" supervision loop, clean teardown).

Download

No build required — grab the DMG from the Releases page:

⬇ Download the latest release

Open the DMG, drag iOS GPS Spoofer to Applications. First launch: right-click ▸ Open (the app is ad-hoc signed, so Gatekeeper asks once). Then prepare your iPhone — see IPHONE-SETUP.md.

Want to build it yourself instead? See Setup / Package as a DMG.

Screenshots

Fixed GPS location

Click a spot on the map (or type coordinates / pick a preset) and the connected iPhone reports that exact location for as long as the tool runs.

Fixed-point mode

The spoofed position as the iPhone itself sees it — Apple Park, the mid-Atlantic, and the Eiffel Tower:

Apple Park North Atlantic Eiffel Tower

Route

Drop waypoints A → B and any points in between, set a duration (h : m : s) or a speed (km/h), and the iPhone moves along the path at constant speed. Optionally loops.

Route mode

Requirements

Setup

./setup.sh          # creates .venv with pymobiledevice3, builds release binary

The binary lands at .build/release/iosgpsspoof. Copy it onto your PATH if you like (cp .build/release/iosgpsspoof /usr/local/bin/). It looks for pymobiledevice3 in ./.venv/bin, then next to the binary, then on $PATH; use --python-path to point at a specific one.

GUI

./run-gui.sh          # or: .build/release/iosgpsspoofer-gui

Stopping is immediate, and cleanup is robust: closing the window / Cmd-Q clears the simulated location; a kill (SIGTERM/SIGINT) still kills the tunnel child; and if the app is ever kill -9'd, the next launch reaps the orphaned pymobiledevice3 process automatically.

Automation: set SPOOF_UDID=<udid> and/or SPOOF_START="lat,lon" in the environment to preselect a device and auto-start spoofing on launch.

Package as a DMG

./package-dmg.sh              # → dist/iOS-GPS-Spoofer-<version>.dmg
./package-dmg.sh --no-venv    # lean build; app expects pymobiledevice3 on PATH

Builds iOS GPS Spoofer.app (generated icon, ad-hoc signed) and a drag-to-install DMG. By default it bundles ./.venv inside the app, so the app finds pymobiledevice3 on its own — it looks for Contents/Resources/venv, then $PYMOBILEDEVICE3, then a .venv beside it, then $PATH.

The bundled venv's Python still references this machine's Homebrew Python, so the default DMG runs on this Mac and Macs with the same brew install [email protected]. For a portable build use --no-venv and have users install pymobiledevice3 themselves. First launch of an ad-hoc-signed app: right-click ▸ Open.

Publishing a release (maintainer):

VERSION=1.0.0 ./package-dmg.sh
gh release create v1.0.0 "dist/iOS-GPS-Spoofer-1.0.0.dmg" \
  --title "v1.0.0" --notes "iOS GPS Spoofer 1.0.0"

The Download link points at releases/latest, so it always resolves to the newest published release.

CLI

# list paired devices
iosgpsspoof list

# spoof to a fixed point (Eiffel Tower). Holds until Ctrl-C, then restores real GPS.
iosgpsspoof spoof 48.8584 2.2945
iosgpsspoof spoof "48.8584,2.2945"          # single-token form also works

# choose a device / link explicitly
iosgpsspoof spoof 37.3349 -122.0090 --udid 00008110-000815C10CD1801E --connection usb

# drive the device along a GPX track, looping forever
iosgpsspoof route ./drive.gpx --loop --timing-randomness 200

# manually clear a simulated location (e.g. if a previous run was killed hard)
iosgpsspoof clear

While spoof / route is running it:

Options (spoof / route)

option default meaning
--udid <id> first device target device
--connection any|usb|network any which link to use / require
--transport native|tunneld|userspace native tunnel mechanism. native = no root (macOS). tunneld needs sudo pymobiledevice3 remote tunneld running. userspace = in-process, no root, slower
--retry-interval <s> 5 delay before re-establishing after a drop
--no-clear-on-exit off keep the fake location after exit
--python-path <path> auto explicit pymobiledevice3 binary

Notes / limitations

iOS-GPS-Spoofer (SegFault42/iOS-GPS-Spoofer)

Searching Database…

240 ·GitHub
IOS-GPS-Spoofer
Что это такое?Инструмент, который заставляет подключённый iPhone сообщать поддельные GPS-координаты, пока он запущен, и автоматически возвращает настоящие, когда вы его останавливаете. Он использует сервис Apple для симуляции местоположения у разработчиков — тот же механизм, что и Simulate Location в Xcode.
Это приложение для Mac или утилита командной строки?И то и другое, на общем ядре: приложение для macOS на SwiftUI со списком устройств, определяемым автоматически, картой, где точку можно поставить кликом, пресетами и живым логом — плюс CLI с командами spoof, route, list и clear.
Нужно ли делать джейлбрейк iPhone или запускать что-то с правами root?Нет — на стандартном нативном транспорту Mac не требует root, так как использует собственный туннель Apple remotepairingd. iPhone тоже не взломан: достаточно, чтобы он был сопряжён и доверял Mac, и чтобы был включён Developer Mode.
Будет ли работать с iPhone на iOS 16?Нет, не со стандартными нативным и tunneld транспортами — им нужен iOS 17+. Для iOS 16 и старше README отсылает к developer simulate-location из pymobiledevice3 напрямую через usbmux.
Можно запустить с Windows или Linux?Нет — только macOS: графический интерфейс — это приложение для Mac на SwiftUI, и даже чтобы собрать инструмент, нужен macOS с тулчейном Xcode / Swift 6.
Он только ставит фейковую точку или умеет имитировать движение?В режиме маршрута на карту ставятся точки A → B и промежуточные между ними, после чего iPhone движется по пути с постоянной скоростью — заданной длительностью (ч:м:с) или скоростью в км/ч, с опциональным повторением по кругу. Точки можно менять местами и редактировать прямо во время движения по маршруту.
Что произойдёт, когда я его остановлю или телефон отключится?При остановке или закрытии фейковая локация сбрасывается сразу, а если телефон отвалился и переподключился, подмена применяется заново автоматически. Очистка срабатывает даже после kill -9 — осиротевший процесс туннеля подчищается при следующем запуске — а флаг --no-clear-on-exit сохраняет фейковую точку, если нужно, чтобы она осталась.
Зачем ему Python и pymobiledevice3?На iOS 17+ сервис симуляции местоположения Apple спрятан за зашифрованным туннелем CoreDevice, который и обрабатывает pymobiledevice3; этот инструмент оборачивает его, добавляя выбор устройства, цикл удержания подмены и аккуратное завершение. Учтите: встроенный venv из DMG ссылается на Homebrew Python машины сборки — на других Mac соберите с --no-venv и поставьте pymobiledevice3 сами.
Насколько полной получается подменённая локация?Подделываются только широта и долгота — высота, курс и скорость не задаются, как и в simulate-location в Xcode. Первый запуск может занять несколько секунд, пока монтируется DeveloperDiskImage и устанавливается туннель.
What are similar projects?omarchy-apple-dev, Roam-Control, CodeEdit, AirCard-macOS, textream, zulu, NetNewsWire, opendisplay
Which topics is it in?swift-ui, geolocation, maps, ios-app, xcode, apple, macos-app, swift, testing, utility, mobile, ios
Creator
SegFault42
Size
5.8 MB
Stars
240
Updated
CommitSep 02Release1.0.0Sep 01
Age
1mo
Commits · 90 Days