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.4 Build 74 · Requires: iOS 27+

iOS 27+ SwiftUI Current release 0.9.4 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, simulated walking routes, 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.
  • Preview and simulate Apple Maps walking routes, or build routes manually with point-by-point and freehand drawing.
  • Pause, resume, reverse or redirect an active walk.
  • Save favourites and revisit recent locations.
  • Restore the iPhone's real location when testing is finished.
  • Recover from interrupted fixed or walking 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.

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, walking routes and pairing records remain on the iPhone.

Anonymous usage statistics are optional and off by default. See the Privacy Policy for the exact information that may be reported when sharing is enabled.

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 normally keeps downloadable IPA assets for the current stable release and, where appropriate, the immediately previous stable release.

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

971 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors