☰

GeoGuessr Auto-Save to Google Sheets

Automatically saves all solo games to Google Sheets and tracks current games

作者
WG-Flykii
日安装量
0
总安装量
18
评分
0 0 0
版本
1.1
创建于
2025-08-31
更新于
2025-08-31
大小
23.0 KB
许可证
MIT
适用于

GeoGuessr Auto-Stats - Installation Guide

Description

This Tampermonkey script automatically saves all your solo GeoGuessr games to a personal Google Sheets with detailed statistics by map and game mode.

Installation

Step 1: Install Tampermonkey

If you don't have Tampermonkey yet:

Step 2: Set up Google Apps Script

  1. Go to Google Apps Script: https://script.google.com/
  2. Create a new project: Click "New project"
  3. Remove everything in the code.
  4. Copy/paste this code : https://github.com/WG-Flykii/Google-Script---Geoguessr-games-stats/blob/main/script.js
  5. Save: Ctrl+S or File > Save
  6. Name your project: "Geoguessr Stats API" (or any name you prefer)

Step 3: Deploy the Google Script

  1. Click "Deploy" > "New deployment"
  2. Select type: "Web app"
  3. Configure:
    • Description: "GeoGuessr Stats API"
    • Execute as: "Me"
    • Who has access: "Anyone"
  4. Click "Deploy"
  5. Authorize the requested permissions
  6. Copy the deployment URL (format: https://script.google.com/macros/s/XXXXXXX/exec)

Step 4: Install the Tampermonkey Script

  1. Download this script
  2. Modify the CONFIG line:
    GOOGLE_SCRIPT_URL: 'YOUR_URL_HERE'
    Replace YOUR_URL_HERE with the URL copied in step 3
  3. Save: Ctrl+S

Step 5: Test and Usage

  1. Go to GeoGuessr: https://www.geoguessr.com/
  2. Play a solo game (any map, any mode)
  3. Wait for game completion: The script automatically detects and saves
  4. Check your Google Drive: A "GeoGuessr Stats Users" folder will be created with your personal sheet

How to find the web app link after an update ?

  1. Go to your script in https://script.google.com/home
  2. Click on the small arrow next to "unfold" in the top right corner
  3. Click on Manage Deployments
  4. Copy the WEB Application url, and paste it on your script on Tampermonkey !

Google Sheets Structure

Your sheet will contain several tabs:

Games

List of all your games with:

  • Date, Token, Map name, Map link
  • Game mode, Score, Distance, Number of rounds
  • Perfect game indicator (25000 pts)

Rounds

Detail of each round with:

  • Game information
  • Round score and distance
  • Actual country and location link

Country Recognition

Country recognition analysis:

  • Actual country vs guessed country
  • Guess accuracy
  • Links to actual and guessed locations

Statistics

Global statistics by map/mode:

  • Average, best and worst scores
  • Perfect game rate
  • Analysis of most difficult/easiest countries

Map/Mode Sheets

One sheet per map/mode combination with:

  • Left: Countries encountered and their frequency
  • Right: General statistics (average score, distance, perfect games)

Troubleshooting

Script not working

  1. Check that Tampermonkey is enabled on GeoGuessr
  2. Verify the Google Apps Script URL in CONFIG
  3. Open console (F12) to see error messages

No data being saved

  1. Only solo games are saved
  2. Check Google Apps Script permissions
  3. Test the Google Apps Script deployment

Permission errors

  1. Re-deploy the Google Apps Script
  2. Verify that "Who has access" is set to "Anyone"
  3. Re-authorize permissions

Important Notes

  • Multiplayer games not supported: The script automatically ignores duels (will add this soon !)
  • Private data: Each user has their own Google Sheets
  • Automatic scan: The script scans recent games on startup
  • No duplicates: Already saved games are not duplicated

Support

dm flykii on discord for any issue or suggestion.

The script works in the background and automatically saves all your solo games. You'll receive a notification on first use with the link to your Google Sheets.