A clean, lightweight GeoGuessr companion for Steam
Live coordinates · Country · Region · Road · Postcode · Flag · Map preview
Note
Project status: NPU — No Planned Updates
GeoHelper remains available for use, but active development has been put on hold indefinitely. No new features or regular updates are currently planned.
GeoHelper is a desktop companion for GeoGuessr on Steam. While you play, it shows live round information in a clean sidebar: coordinates, country, region, road, postcode, flag, and a map preview.
Built for custom maps, singleplayer, solo practice, and learning geography.
- Live round data — coordinates and rich location details, updated as you play
- Fully customizable layout — drag & drop widgets, per-text fonts/sizes/colors, custom marker styling
- Map preview — OpenStreetMap out of the box, optional Google Maps with your own API key
- Tiny footprint — ~6 MB app built with Tauri
- Non-invasive — no injection, no DLLs, no browser extensions; it reads Steam's own Chrome DevTools Protocol
GeoHelper connects to the Chrome DevTools Protocol endpoint that Steam exposes (--remote-debugging-port=34788 --remote-allow-origins=*) and listens to the game's own network RPC traffic.
Everything is processed locally on your machine — nothing is sent anywhere.
-
Download the latest release from Releases
-
In Steam, right-click GeoGuessr → Properties → Launch Options and add:
--remote-debugging-port=34788 --remote-allow-origins=* -
Launch GeoHelper and start playing
Supported platforms: Windows 10/11 · Linux · macOS 11+
The .deb package installs its WebKitGTK dependencies automatically.
On Arch-based distros such as Arch or CachyOS, use the included package recipe:
git clone https://github.com/wiktorekdev/geohelper.git
cd geohelper/packaging/arch
makepkg -siRunning the AppImage or raw binary directly? Install the runtime dependencies manually:
sudo pacman -S --needed webkit2gtk-4.1 libsoup3 gtk3 libayatana-appindicatorBuilding from source on Arch requires the full Tauri development set:
sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg xdotoolClick the pencil icon in the sidebar to enter Edit Mode:
- Drag & drop to reorder widgets
- Style any text — 20 bundled fonts, size, bold/italic/underline, custom colors
- Customize the map marker — fill, border, and size
- Resize the sidebar
- Hide the map
- Switch between light and dark themes
| Feature | OpenStreetMap (default) | Google Maps (optional) |
|---|---|---|
| Availability | Built-in | Requires API key |
| Pricing | Completely free | Google Cloud free tier |
| Styles | Multiple CartoDB styles | Roadmap, Satellite, Dark |
bun install
bun run dev # development with hot reload
bun run build # create release builds
bun run test # frontend unit tests
bun run check # lint, tests, and frontend buildGeoHelper is currently marked as NPU — No Planned Updates.
The project is still available and may continue to work as-is, but it is not under active development. There is currently no roadmap, release schedule, or commitment to future updates.
Critical fixes may still happen at the maintainer's discretion, but they should not be expected.
If you enjoy GeoHelper and want to support the project:
GeoHelper is a personal, educational practice tool.
Using helpers in ranked or competitive modes may violate GeoGuessr's Terms of Service and may result in account penalties. Use responsibly.