v3.0 (Same Mission, Sexier Shell, More Recon, Now with Cameras)

v3.0 : "Same Mission, Sexier Shell, More Recon, Now with Cameras"

Full rebuild of 2.0, camera intelligence added, and significantly less pretending the old layout was fine.

What's new:

• Full UI rebuild into a proper geospatial recon console
• Better command-center layout with live map HUDs, panel toggles, and resizable workspace controls
• Camera intelligence via OSM, Shodan, and Insecam
• Camera-feed comparison against your uploaded reference image
• Metadata stripping on upload because source images love snitching
• Session import and export so you can save the whole mess and come back later
• Match CSV export for when you need receipts
• Clean reference download flow
• Better scan progress, status handling, and live map feedback
• Backend validation fixes so bad input stops failing like an asshole
• Clearnet deployment support with HTTPS because she escaped the onion dungeon

Requirements:

• Windows 10/11 if you're running the packaged build
• Python 3.10+ if you're running from source
• A browser
• Provider keys if you want to use Mapillary, Google, Baidu, or Shodan
• An image that is hopefully less of a blurry little fucker than most of the ones people bring

Known issues:

• Third-party APIs can still wake up and decide to be evil
• Some provider paths are more field-tested than others
• Public camera data is messy because the public internet is a haunted landfill
• If you draw half the planet as your search area, The Cat will know you are being unreasonable
• If the source image is absolute dogshit, GeoScout may need you to tighten the area, raise the threshold, or switch surfaces before it stops judging you

(The Cat remains under-credited.)

Windows note:

-Windows SmartScreen may warn you before launching GeoScout.exe because the app is unsigned.
-That does not mean the build is malicious. It means I have not code-signed the executable.
-If you trust the release and downloaded it from this repo:

1. Click More info
2. Click Run anyway

GeoScout is a browser-based local app if you decide to download it rather than use the website. When it launches correctly, it starts a local server and opens in your browser.

v2.0 - me: "i cant find geoscout" claude: "it's in program files" me: "no it's not" me: "...oh"

🌍 v2.0 : "She Found The Files"

The geolocation tool that can pinpoint a building from a blurry photo taken in the middle of nowhere in Kyrgyzstan was missing on its own creator's hard drive for days.

It was in C:\Program Files (x86). The whole time.

What's included:

• 🔍 app.py (the whole backend)
• 🗺️ templates/index.html (the whole frontend)
• 🧩 Leaflet + Leaflet.Draw bundled locally
• 📦 requirements.txt (three dependencies. three.)
• 🔨 build.bat (one-click exe builder)
• 💀 GeoScout.exe (pre-built, just unzip and double-click)
• 🫠 My dignity (not included cuz it doesnt exist)

Search modes:

• 🟢 Mapillary (free, global, honestly insane that it's free)
• 🔵 Google Street View (paid, best quality, no China)
• 🟣 Baidu Panorama (free tier, best China coverage)
• 🟡 Satellite (overhead, ESRI/Sentinel-2/Google tiles)

Requirements:

• For the exe: nothing. unzip it, double-click it, and you're done
• For source: Python 3.10+, flask, pillow, numpy
• Tor for the website: rbu3z2ag3w4q7el6gnssyvwdv2ig3vuo2q7rldrkkm3th2qftfu76kad.onion
• An API key for your chosen provider
• The ability to draw a rectangle on a map

Known issues:

• The tool that finds things could not find itself.
• It will work until it doesn't, and then you should open an issue.
• The Cat remains uncredited and unbothered.

Run it locally with the exe or python app.py, or use the live Tor instance. See the README for setup, API keys, and the FAQ where I pretend I have my life together.

🐾