# spoof26

> Free, open-source iOS location spoofer for macOS. One command install, web-based map UI, instant GPS changes.

## What it does

spoof26 lets you set a fake GPS location on your iPhone from your Mac. It opens a web-based map where you click to pick a location, and your iPhone's GPS updates instantly. No jailbreak, no Xcode required.

## Install

```bash
curl -fsSL https://spoof26.pages.dev/install.sh | sh
```

## Usage

```bash
sudo spoof26                    # launch (opens web UI with map)
sudo spoof26 --enable-dev-mode  # first-time: enable Developer Mode on iPhone
sudo spoof26 --uninstall        # remove spoof26
sudo spoof26 --help             # show help
```

## Requirements

- macOS (Apple Silicon or Intel)
- iPhone with iOS 17 or later (including iOS 18 and 26)
- USB cable (Lightning or USB-C)
- Python 3.13+ and uv are installed automatically

## First-time setup

1. Turn off Face ID and passcode on iPhone (temporarily)
2. Run `sudo spoof26 --enable-dev-mode`
3. Accept the Developer Mode dialog on iPhone after reboot
4. Re-enable Face ID and passcode

## How it works

spoof26 uses pymobiledevice3 to communicate with the iPhone over USB. It mounts the developer disk image, creates a secure tunnel, and uses the DVT LocationSimulation service to set a simulated GPS coordinate. A persistent connection means location changes are instant after initial setup.

## Key features

- One command install (curl | sh) — installs uv, Python, and all dependencies automatically
- Web-based Leaflet map UI with search, geolocation, and city presets
- Persistent DVT connection — no delay between location changes
- Auto-reconnect if the device connection drops
- Works on iOS 17, 18, and 26
- No Xcode or jailbreak required

## Links

- Website: https://spoof26.pages.dev/
- Install script: https://spoof26.pages.dev/install.sh