A browser extension for extending the experience of GeoGuessr.
Original extension created by Andrei Onea. Extenssr Reloaded continues that project with maintenance and feature updates.
- Core visual effects
- Pixelate (strength slider)
- Toon (strength slider)
- Grayscale
- Invert colours
- Sepia
- Mirror
- Fish-eye
- CRT filter (chromatic aberration)
- Edge filter
- Drunk mode
- Vignette
- Water
- Bloom
- Min filter
- Motion blur
- Screen scrambler
- Blink mode with multiple timing modes:
- Fixed time
- Decrease each round (step + minimum)
- Random time per round (max up to 8s)
- Focus area
- Hide compass
- Special effects
- Snow on Street View
- AI car masking (heavier performance cost)
- Seed generator (Makes randomizer outputs deterministic so others can use the same sequence)
- Battle Royale extras
- Show visited locations at the end of round
- Country streaks in regular maps
- This feature is not vetted for Geotips world record attempts
- Saving locations and routes found during regular rounds
- Co-op functionality
The project is always developing new ideas, so bugs are expected. If you encounter a reproducible bug, please do the following:
- (optional - see last bullet point) obtain a bugreport json
- enable debugging (from the debugging panel of the extension pop-up menu)
- reproduce the issue
- download full bug report (same debugging panel)
- there is no process to anonymise the contents or strip unnecessary personal data; the data is only used for the purpose of fixing bugs, ands is not shared with other parties. If that still makes you uncomfortable, you can skip this step.
- send the bug report (if you're ok with the caveats) alongside a description of the issue to either My Discord or to my Github.
Building requires additional secrets and assets that are not included in the repository.
There is a sample .env file in .env.template. That contains the CLIENT_ID for connecting to the Twitch bot, a manifest key for the Chrome extension (required for keeping a stable appid when developing locally) and a GUID required if developing a Firefox add-on.
To build, simply run
npm install
npm run chrome # Chrome build
npm run firefox # Firefox build
During the development cycle, you can use a webpack watch command
npm run watch-chrome # Chrome, with key
npm run watch-chrome-nokey # Chrome, no key
npm run watch-firefox # Firefox
Load the extenssr_chrome or extenssr_firefox directory as an unpacked extension.
The Chrome extension published to the Web Store is built with npm run chrome-nokey (the key is added automatically by the submission process).
This is a project cloned from Andrei and now maintained by myself, I want to thank him and anyone else involved in the original project. I loved the extension but felt it was time to update it after inactivity. All the original contributors are within this file and I will NEVER take credit for their work.
Extenssr contributors:
Some of the folks below have donation links, just saying 😀.
- @kyarosh_ who designed the Extenssr icon.
- Chatguessr folks, who conceived the original mod. This extension started off as an attempt to reimplement Chatguessr as an extension (to help out non-Windows streamers).
- GeoGuessr Pro Community which inspired a lot of the functionality. None of the scripts were copied, either due to licence incompatibility or because the extension uses different approaches.
- ZackC__ who documented many of the Geoguessr API calls
- drparse who created a bunch of map filter effects.
- SubSymmetry and theroei who created the original country streak scripts.
- Possibly others I forgot! Please send a pull request to add credit, or DM/email me.
- The Geoguessr community over on Twitch. Some folks who have helped either by suggesting features, or by alpha testing some of the functionality.
This extension is distributed under Apache 2.0 license, with the exception of:
- Shrug by Kimi Lewis from the Noun Project which is licensed under Creative Commons. Taken from The Noun Project
- Snow shader is licensed under Creative Commons Attribution-NonCommercial-ShareAlike. Original shader by Andrew Baldwin.
- Flying Santa Animation has no specified license, but giving it a hat tip here.
- Bundled countries GeoJson data is from datahub.io, originally from Natural Earth is licensed under the Open Data Commons Public Domain Dedication and License. The original data is public domain.
