Teleport

Simulate iOS device locations from your Mac, on simulators and physical devices over USB or Wi-Fi.

--- Teleport is built with SwiftUI and MapKit. Click somewhere on the map, hit Simulate, and your device thinks it's there. ![Teleport – location simulation](Resources/screenshot-main.jpg) ![Teleport – route builder](Resources/screenshot-route.jpg) ## Install ### Homebrew ```sh brew tap samuelhe52/teleport brew trust --cask samuelhe52/teleport/teleport-location brew install --cask teleport-location ``` ### Direct download Download the latest `.dmg` from [Releases](https://github.com/samuelhe52/Teleport/releases), drag `Teleport.app` to Applications, and launch it. ## What It Does **Full device support** — works with iOS Simulators and real iPhones over USB or Wi-Fi, all from the same app. **Virtual joystick** — move the simulated location around in real time without picking a new point every time. Good for testing location-aware interactions on the fly. **Custom routes** — draw a straight-line path between any stops, or use Apple Maps navigation to snap the route to real roads. Both can be played back at fixed intervals, or a target travel speed. Save/load/edit routes are fully supported. **GPX import and export** — bring in existing routes or save yours out for use elsewhere. A few other things: - Click anywhere on the map, search by name, or type in coordinates to set a location - Save routes inside the app and reload, rename, edit, or duplicate them later - Session controls show clear status and let you stop or reset at any point ## Disclaimer Teleport is meant for developer testing and debugging. Using it for anything else is on you — the app and its developer aren't responsible for whatever happens. ## Requirements - macOS - Xcode installed and opened at least once (so `xcrun`, `simctl`, and `devicectl` are on your path) - For physical devices: Developer Mode enabled on the iPhone, plus `python3` and `pymobiledevice3 >= 5.0` - For Wi-Fi: pair over USB first, then keep the device unlocked on the same network If macOS says developer tools are missing: ```sh xcode-select --install ``` If `xcrun` is pointing at the wrong Xcode install: ```sh sudo xcode-select -s /Applications/Xcode.app/Contents/Developer ``` Then open Xcode once to let it finish setup. Install or upgrade the Python dependency with whichever `python3` your shell resolves: ```sh python3 -m pip install --upgrade pymobiledevice3 ``` Teleport requires `pymobiledevice3` 5.0 or newer for physical-device simulation. ## Build from Source ### Xcode 1. Open `Teleport.xcodeproj`. 2. Select the `Teleport` scheme. 3. Build and run. ### Command line ```sh xcodebuild -project Teleport.xcodeproj -scheme Teleport -destination 'platform=macOS' build ``` ## Basic Usage 1. Launch Teleport and select a device. 2. Connect to it. 3. Pick a location — click the map, search, or enter coordinates. 4. Hit `Simulate`. That's it. 5. Build a route if you need to simulate movement. 6. Save routes for later, or import/export GPX files. 7. Hit `Stop` when you're done. For physical devices, Teleport might ask for admin approval on first run, walk you through a missing Python dependency, or need a USB connection before Wi-Fi discovery kicks in. ## Development - `make format` runs `swift format -r -p -i .` - `make lint` runs `swift format lint -r -p .` ## Notes Teleport was originally called iOSAnywhere. If you're in mainland China, Apple Maps search tends to only return locations inside China. Searching for overseas places usually needs a VPN. You can still pan the map to anywhere and pick a spot manually.