Open source

Open source, built on open source

Geovoya is free software under the GNU General Public License, version 3 or later. You can read, change and share the code.

Credit to Ghost

Geovoya is a fork of Ghost (ghost-location), an open-source Electron app by the Ghost contributors that sets a phone’s location over USB or Wi-Fi. Most of Geovoya’s core, including the device adapters, route playback and the recovery logic, comes from Ghost. Thank you to everyone who built it. Geovoya follows the same GPL-3.0-or-later license.

Get the source code

Building from source needs Node.js 24 and, to build the iPhone runtime, Python 3.12 or 3.13. You need to build on each target operating system (Windows x64, macOS Apple Silicon or macOS Intel). The repository README has the full instructions.

Geovoya Pro is an optional paid plan backed by the Geovoya Cloud account service. It doesn’t change the license of the desktop app. Anyone who receives a Geovoya binary is entitled to its corresponding source under the GPL.

Third-party components

These components keep their own copyright and license terms. The full notices ship with the app inTHIRD_PARTY_NOTICES.md and LICENSE.

Bundled and build-time components
ComponentRoleLicense
pymobiledevice3iPhone USB discovery, developer services and location simulationGPL-3.0-or-later
Appium SettingsAndroid mock-location helper app (bundled unmodified)Apache-2.0
Android Platform Tools (ADB)Android USB and Wi-Fi transportBundled NOTICE files
ElectronDesktop runtimeMIT, plus Chromium third-party notices
LeafletInteractive mapBSD-2-Clause
LucideInterface iconsISC
fast-xml-parserGPX and KML parsingMIT
joseVerifies signed account entitlement tokensMIT
ViteInterface build toolingMIT
electron-builderInstaller toolingMIT
PyInstallerPackages the Python iPhone runtimeGPL with a distribution exception

Online services and data

Online services used by the app
ServiceUsed forLicense
OpenStreetMapMap data and map tilesODbL (data)
PhotonPlace search (public demo API by default, configurable)Apache-2.0; OpenStreetMap data under ODbL
OSRMRoad routing (public demo API, only when you plan a route)BSD-2-Clause; OpenStreetMap data under ODbL

Map data © OpenStreetMap contributors. The public Photon and OSRM demo servers are meant for light use and don’t guarantee uptime. The app doesn’t use the public Nominatim API. No code from iDescriptor, GeoPort or LocationSimulator is included.

Contribute

Bug reports, device test results and pull requests are welcome on GitHub. Results from Windows computers and Android phones are especially useful, because those setups haven’t all been tested on real hardware yet.