Skip to content

Repository files navigation

Roam Control app icon

Roam Control

Choose, test and move an iPhone's reported location from one clean Apple Maps interface.

Current release: 0.9.6 Build 92 · Requires: iOS 27+

iOS 27+ SwiftUI Current release 0.9.6 PolyForm Noncommercial 1.0.0

About

Roam Control is an iPhone app for location-based development, quality assurance and responsible personal testing on a device you own and control.

It supports fixed reported locations, Walking, Driving and Cycling routes, Joystick movement, GPX import/export, favourites, history, on-device pairing and guided LocalDevVPN-compatible sessions.

Roam Control is distributed as a prebuilt IPA. The application source code is not publicly distributed.

Screenshots

Roam Control welcome screen Selecting a fixed location in London Walking route preview

Welcome · Fixed location · Walking route

Building a manual walking route Connection Health and Manual Diagnostics

Manual route drawing · Connection Health

Features

  • Search for places, enter coordinates or select a position on the map.
  • Start and update a fixed reported location.
  • Simulate Apple Maps Walking, Driving and Cycling routes.
  • Build manual routes with point-by-point or freehand drawing.
  • Import and export GPX routes.
  • Move freely with the Joystick without creating a route.
  • Pause, resume, reverse or redirect active route sessions.
  • Choose Miles/Kilometres and mph/km/h route units.
  • Save favourites and revisit recent locations.
  • Restore the iPhone's real location when testing is finished.
  • Recover from interrupted fixed, route or Joystick sessions.
  • Guided LocalDevVPN setup for Wi-Fi and mobile-data use.
  • Light, dark and automatic appearance.
  • Dynamic Type, VoiceOver and Reduce Motion support.

Install

Roam Control is not distributed through the App Store or TestFlight.

Download the IPA attached to the current GitHub Release and install it using SideStore, or import it into LiveContainer.

Important

Upgrading from Roam Control 0.9.4? Back up before installing 0.9.6.

Roam Control 0.9.6 uses the new app identifier, so your existing 0.9.4 app data will not automatically carry across.

Before installing 0.9.6, open Roam Control 0.9.4 and create a backup from Settings > Backup & Restore if you want to preserve your favourites, history and supported settings.

After installing 0.9.6, choose Restore Backup during the migration flow.

Pairing information is not included in backups, so this iPhone will need to be paired again.

If you install 0.9.6 without creating a backup first, Roam Control cannot automatically recover those items from the old app.

See the 0.9.5 Migration & SideStore FAQ for App ID, active-app slot and migration questions.

For LiveContainer installs, Fix Local Notifications must be enabled before Roam Control's first run so the pairing notification can be delivered correctly.

Read the Installation Guide before installing.

Only download Roam Control from the official GitHub repository. Unofficial mirrors, modified builds and redistributed copies are not authorised.

Documentation

Privacy

Locations, searches, favourites, history, route content and pairing records remain on the iPhone.

Anonymous Usage Statistics are optional and off by default. Separately, Roam Control 0.9.5 and later sends one anonymous install-count request per installation to estimate aggregate country-level installs. See the Privacy Policy for the exact details.

Responsible use

Roam Control is intended for development and testing on an iPhone you own and control.

Location simulation can affect every app that uses the iPhone's reported position. Restore the real location before using navigation, emergency, safety, transport or location-sharing features.

See Responsible Use.

Support and feedback

Bug reports, feature requests, testing results and technical findings are welcome through GitHub Issues.

Roam Control is maintainer-developed and is not accepting pull requests or unsolicited code contributions.

For casual help, beta discussion and feature ideas, join the Roam Control Discord:

https://discord.gg/fJrNvQ2Vdh

For security-sensitive reports, use GitHub Security Advisories.

Releases

Roam Control keeps the current stable IPA available and may retain an older IPA where it is still required for migration compatibility.

Older GitHub Releases may remain visible as historical records after their downloadable assets have been retired.

Licence and copyright

Roam Control is proprietary software.

Copyright © 2026 Sean Howarth. All rights reserved.

The public IPA may be downloaded and used personally subject to the terms in LICENSE. Redistribution, modification, repackaging, mirroring and unofficial releases are not permitted without prior written permission.

Historical source code that was previously published under other licences remains governed by the licence applicable to the specific version when it was published. Those historical grants are not revoked by the current distribution model.

About

Choose, test and move an iPhone’s reported location.

Topics

Resources

Contributing

Security policy

Stars

1.0k stars

Watchers

3 watching

Forks

Releases

Packages

Contributors