Set a place, build a route, and make your iOS Simulators move.
Simulator Location Tools is a native macOS app for developers who need reliable, repeatable location scenarios while building and testing iOS apps. Instead of repeatedly opening Simulator's location menu or typing coordinates into a terminal, choose a real place from a country-organized library, search Apple Maps, or play a driving route across one or more booted simulators.
It is particularly useful for testing location-aware experiences such as delivery tracking, travel apps, map views, nearby search, geofencing, and location-driven onboarding.
Select a country and city, preview it on Apple Maps, then apply it to a booted iOS Simulator.
Preview and play a driving route with progress, speed controls, and an estimated current position.
- Set a location quickly — choose a bundled capital or city, save your own places, preview them on a map, and apply the location to one or many booted iOS Simulators.
- Browse by country — start with a built-in offline catalog covering 196 countries, including national capitals, U.S. state capitals, and 42 additional cities. Pin frequently used countries to Favorites.
- Search real places — use Apple Maps to find an address or point of interest, preview it, and save it in the appropriate country group.
- Test movement, not just a pin — calculate an Apple Maps driving route or import a GPX file, then play it on selected simulators.
- Control route playback — use constant, accelerating, or variable-speed profiles; change constant speed live; repeat a route; view progress and an estimated current position.
- Import and export GPX — import track points, route points, or waypoints, and export Xcode-compatible waypoint GPX files. Elevation and timestamps are retained when GPX data provides them.
- Stay native — the app is built with SwiftUI, MapKit, SwiftData, and the Xcode command-line tools already used by iOS developers.
- Launch one or more iOS Simulators.
- Open Simulator Location Tools; booted devices appear automatically.
- Select a country and place, search Apple Maps, or add a custom coordinate.
- Select the simulators you want to control and choose Apply Location.
- For movement scenarios, create or import a route and choose Play Route.
The app targets each device by its UDID, so the same location or route can be applied to several simulators at once.
Create a driving route by searching for a start and destination. Simulator Location Tools asks Apple Maps for the route, displays its polyline, and stores the route with its distance, estimated duration, endpoints, and point count.
You can also import GPX files containing <trkpt>, <rtept>, or <wpt> points. Imported routes are organized under their starting country; the app reverse-geocodes the endpoints when possible. GPX exports use Xcode-compatible waypoints.
Simulator location playback accepts latitude and longitude, but not elevation. The app preserves elevation for display and GPX export. Playback progress and the moving map marker are estimates because simctl does not provide live route telemetry.
- macOS 26 or later
- Xcode 26 or later, including iOS Simulator and command-line tools
- At least one booted iOS Simulator to apply a location or play a route
- Clone this repository.
- Open
SimulatorLocationTools.xcodeprojin Xcode. - Select the Simulator Location Tools scheme and the My Mac destination.
- Build and run.
The project resolves Sparkle through Swift Package Manager for app updates.
Simulator Location Tools does not collect analytics, tracking data, or usage information. The bundled catalog is based on GeoNames data, licensed under CC BY 4.0. The offline catalog lets you browse common testing locations without a separate location-data service. Apple Maps is used only when you choose to search or calculate a route.
Created by Adrian Kajda and released under the MIT License.