Skip to content

wiktorekdev/geohelper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GeoHelper

GeoHelper

A beautiful & lightweight GeoGuessr Steam Helper

Live coordinates • Country • Region • Road • Postcode • Flag • Map preview

Stars Latest release Downloads Platforms Donate MIT

GeoHelper showing Paris

What is GeoHelper?

GeoHelper is a clean, customizable desktop helper for GeoGuessr on Steam.
It shows live round information: coordinates, country, region, road, postcode, flag and map preview.

Perfect for custom maps, singleplayer, solo practice and learning geography.

Key Features

  • Beautiful draggable & resizable widgets with full layout customization
  • Powerful custom theming system (JSON + CSS variables)
  • Live coordinates and rich location data
  • Map preview (OpenStreetMap default + Google Maps support)
  • Very small size (~6MB) thanks to Tauri
  • No injection, no DLLs, no browser extensions — uses Steam’s own Chrome DevTools Protocol (CDP)

How it works

GeoHelper connects to the Chrome DevTools Protocol endpoint exposed by Steam (--remote-debugging-port=34788 --remote-allow-origins=*) and reads the game’s own network RPC traffic. Everything is processed locally on your machine.

Getting Started

  1. Download the latest release from Releases
  2. Right-click GeoGuessr in Steam → Properties → Launch Options and add:
    --remote-debugging-port=34788 --remote-allow-origins=*
    
  3. Run GeoHelper and start playing

Supported platforms: Windows 10/11, Linux, macOS 11+

Linux dependencies

Ubuntu/Debian builds usually install the needed WebKitGTK dependencies automatically from the .deb package. On Arch-based distros such as Arch Linux and CachyOS, install the runtime dependencies first:

git clone https://github.com/wiktorekdev/geohelper.git
cd geohelper/packaging/arch
makepkg -si

If you prefer to run the AppImage or raw binary directly, install the runtime dependencies manually:

sudo pacman -S --needed webkit2gtk-4.1 libsoup3 gtk3 libayatana-appindicator

If you are building GeoHelper from source on Arch/CachyOS, install the full Tauri development dependency set:

sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg xdotool

Customization

Click the pencil icon to enter Edit Mode:

  • Drag & drop widgets anywhere on screen
  • Toggle and resize individual widgets
  • Custom Themes (built-in + fully custom via themes.json)
  • Per-widget styling (colors, fonts, padding, etc.)

GeoHelper Edit Mode - Drag and Drop

Map Providers

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

Build from Source

bun install
bun run dev          # development with hot reload
bun run build        # create release builds

Support

If you enjoy the project and want to support further development:

Buy me a coffee

Disclaimer

This 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.

License

MIT License

About

GeoGuessr Steam Helper — shows live coordinates, country, region, road, postcode, flag and map preview. Beautiful draggable UI with custom themes. Practice tool for custom maps (CDP, no injection).

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors