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

Geovoya’s development repository is private, so the source is published as an archive with every release. That archive is the complete corresponding source for the installers on the download page, offered alongside them exactly as GPL-3.0 §6 requires — it is the whole app, build scripts included, not an extract.

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). README.md inside the archive has the full instructions.

If an archive is missing, incomplete or does not build, that is a licence problem and not a support ticket: write to [email protected] and it gets fixed.

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 in THIRD_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

There is no public issue tracker, because the development repository is private. Bug reports, device test results and patches go to [email protected] instead —what to include is on the FAQ. Results from Windows computers and Android phones are especially useful, because those setups haven’t all been tested on real hardware yet.

Patches are welcome as a git diff against the release archive above, attached to an email. The GPL gives you every right to fork it and publish your own version; a note about it is appreciated, not required.