Roam-Control README

The project's README from github.com/seanhowarthdev/Roam-Control. As one markdown file: README.md.

Roam Control app icon

Roam Control

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

Public beta: 0.9.0 (Build 29) · Requires: iOS 27+

iOS 27+ SwiftUI Beta 0.9.0 Build 29 PolyForm Noncommercial 1.0.0

Roam Control is a source-available SwiftUI app for location-based development, quality assurance and responsible personal testing on an iPhone you own and control. It supports fixed locations, walking routes, favourites, history, native on-device pairing and LocalDevVPN-compatible sessions.

Screenshots

Roam Control welcome screen Selecting a fixed location in London Active simulated walking route

Welcome · Fixed location · Walking route

Privacy-first anonymous statistics choice Roam Control settings

Private by design · Settings

Highlights

Install the public beta

Roam Control is not distributed through the App Store or TestFlight. Download the IPA attached to the matching GitHub Release and sign it with SideStore using your own Apple account.

You will need:

Read the complete installation guide before installing. Free Apple accounts remain subject to Apple's app-count and seven-day refresh limits.

First-time setup

  1. Install and open Roam Control.
  2. Complete the four-page introduction.
  3. Tap Pair This iPhone on Device Setup.
  4. Open Settings → Privacy & Security → Developer Mode → Pair with Roam Control.
  5. Enter the six-digit code shown in Roam Control.
  6. Install and connect LocalDevVPN.
  7. Choose a location or walking route.

The pairing record is stored in the iPhone Keychain and is never uploaded.

Privacy

Locations, coordinates, searches, favourites, history, walking routes and pairing records stay on the iPhone.

Anonymous usage statistics are optional and off by default. When enabled, a narrow first-party sender reports only a fixed set of activity events, the app version/build and a hashed random installation identifier. It never sends locations, searches, routes, pairing data, device names or diagnostics. No third-party analytics SDK is embedded.

The public project has no live analytics destination or Apple signing team. A checkout therefore sends no statistics unless the builder deliberately supplies a private local configuration.

Read Privacy for the exact event and retention disclosure.

Responsible use

Roam Control is intended for development and testing on a device you own and control. Location simulation can affect every app using the iPhone's reported position. Restore the real location before using navigation, emergency, safety, transport or location-sharing features.

Do not use Roam Control to mislead another person, falsify evidence, access something you are not entitled to use, evade safeguards or breach a third-party service's rules. See Responsible Use.

Build from source

  1. Clone the repository and open RoamControl.xcodeproj in Xcode 27 or newer.
  2. Select the Roam Control target.
  3. Choose your own Apple development team under Signing & Capabilities.
  4. Select a connected iPhone and press Run.

The iPhone simulator is useful for interface work but cannot complete the physical pairing handshake or start a location session.

Normal builds use the included Frameworks/RoamPairingFFI.xcframework. The framework contains arm64 iPhone and Apple Silicon simulator slices. Rebuild it only after changing Native/RoamPairingFFI; instructions are in the build and release guide.

How it works

Roam Control generates or imports an RPPairing record for the same iPhone and stores it in the device-only Keychain. When a location starts, it discovers that iPhone's remote-pairing service through LocalDevVPN, verifies the device identity and opens the encrypted developer session used to set or clear a simulated location.

The native engine is a narrow Rust-to-Swift bridge around the MIT-licensed idevice library, pinned to an exact revision.

Documentation

Community

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

For bugs and reproducible issues, please use GitHub Issues. For security-sensitive reports, use GitHub Security Advisories.

Contributing

Bug reports and focused improvements are welcome. Read CONTRIBUTING.md before opening an issue or pull request, and never upload pairing records, signing material, credentials or private location information.

Licence

Roam Control's current source is available under the PolyForm Noncommercial License 1.0.0. It may be used, modified and redistributed for non-commercial purposes under those terms. Commercial use requires separate permission from the project owner.

Roam Control 0.9.0 Beta 1 was released under the MIT Licence and remains available under those terms. The licence change applies to development after Beta 1 and does not revoke rights already granted for that release.

See Licensing for details. Bundled dependencies retain their own licences; see Third-party notices.

Roam-Control (seanhowarthdev/Roam-Control)

Searching Database…

1.1K ·GitHub
Roam-Control
Что это такое?Roam Control — приложение для iOS на SwiftUI, которое позволяет выбирать, тестировать и менять сообщаемую iPhone GPS-локацию для разработки, QA и ответственного личного тестирования.
Это самостоятельное приложение или что-то, что я добавляю в Xcode?Это самостоятельное приложение для iOS, которое вы устанавливаете и запускаете на своём iPhone, а не библиотека и не плагин для Xcode. Его нативный движок — мост Rust-to-Swift вокруг библиотеки idevice, который обрабатывает сопряжение с устройством и сессию локации.
Как его установить, если его нет в App Store?Скачайте IPA из соответствующего GitHub Release и подпишите его через SideStore (или соберите из исходников в Xcode) под своим Apple-аккаунтом, затем выполните сопряжение с iPhone через Developer Mode с помощью шестизначного кода, показанного в приложении.
Что мне нужно, прежде чем я смогу этим пользоваться?iPhone с iOS 27 или новее с включённым Developer Mode, установленным и подключённым LocalDevVPN, а также SideStore или Xcode на Mac для подписания/установки приложения.
Есть ли подводные камни при установке, о которых стоит знать?Бесплатные Apple-аккаунты ограничены правилами Apple по количеству приложений и семидневному обновлению, а симулятор iPhone годится только для работы с интерфейсом, так как не может завершить физическое рукопожатие сопряжения или запустить настоящую сессию локации.
Покидают ли телефон мои данные о локации?Нет. Локации, поиски, избранное, история, маршруты и записи о сопряжении остаются на устройстве; опциональная анонимная статистика использования по умолчанию выключена и никогда не включает данные о локациях, поисках или сопряжении.
Что можно делать с симулированной локацией помимо установки фиксированной точки?Можно просматривать и запускать пешие маршруты Apple Maps, а затем в ходе сессии ставить их на паузу, возобновлять, разворачивать или менять направление; кроме того, можно сохранять именованные избранные точки и возвращаться к недавним локациям.
Нужно ли делать джейлбрейк iPhone, чтобы этим пользоваться?Нет, оно работает на нетронутом iPhone через сайдлоадинг с SideStore (или Xcode) и рукопожатие сопряжения на устройстве через LocalDevVPN, без джейлбрейка.
Для чего здесь используется LocalDevVPN?Roam Control использует LocalDevVPN, чтобы обнаружить сервис удалённого сопряжения спаренного iPhone и открыть зашифрованную developer-сессию, которая применяется для установки или сброса симулированной локации.
Можно ли отменить изменение локации, когда тестирование закончено?Да, приложение позволяет явно восстановить реальную локацию по окончании тестирования, а также содержит обработку восстановления, если фиксированная или пеших сессий прервана.
What are similar projects?sill, iOS-GPS-Spoofer, zhoop, firefox-ios, zulu, omarchy-apple-dev, Signal-iOS, animated-tab-bar
Which topics is it in?beta, ffi, qa, iphone, geolocation, testing-tools, ios-app, swiftui, xcode, privacy-first, vpn, apple
Creator
seanhowarthdev
Size
20.2 MB
Stars
1.1K
Updated
CommitOct 08Releasev0.9.7Oct 08
Age
1mo
Commits · 90 Days