A clean, lightweight GeoGuessr companion for Steam
Live coordinates · Country · Region · Road · Postcode · Flag · Map preview
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 (Arch, 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, size)
- Resize the sidebar, hide the map, switch light/dark theme
| 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 buildIf you enjoy GeoHelper and want to support development:
GeoHelper is a personal, educational practice tool. Using helpers in ranked or competitive modes violates GeoGuessr's Terms of Service and may result in a ban. Use responsibly.