Vacation Photo Geotagging Organizer

WHAT IT DOES

This userscript helps travelers organize vacation photos by geographic location. It scans photo gallery pages, travel albums, or image listings for geotag metadata (GPS coordinates from EXIF or embedded location data), filename location hints, or alt text location mentions. It automatically organizes photos into a visual map or location-based album view, grouping by city, region, or country. The script detects location gaps or missing geotags and highlights photos that need manual location assignment. It can assign location names to photos without GPS using filename patterns (e.g., "paris_2024.jpg" → Paris, France), generate a trip timeline, and export the organized album as an HTML map page or CSV catalog. It can also suggest the optimal order of photos based on a travel route.

WHERE IT RUNS

The script works on any webpage with images—Google Photos, iCloud, Dropbox, travel blogs, or any image gallery. It runs entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All photo data is processed locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. The script auto-scans the page for images on load (toggle this on/off). Choose your grouping mode—City, Country, or Region. Click "Organize Photos" to scan and sort the images. The gallery displays photos grouped by location with geographic headers. Photos without location data are highlighted with an orange border. Use the export dropdown to choose your format—HTML (photo map) or CSV (catalog). Click "Export Album" to download the organized album.

THE TECHNICAL MECHANISM

This script uses DOM traversal to extract image elements from the page. For each image, it extracts the src URL, filename, alt text, and title. It attempts to determine location from three sources: filename patterns (checking against a built-in location database with over 25 cities and their countries/regions), alt text, and title text. The location database maps city names to city, country, and region. Images are grouped by the selected mode (city, country, or region). The gallery renders each group with a header and thumbnail grid. Photos without location data are tagged as "Unknown" and highlighted with an orange border for easy identification. The HTML export generates a self-contained styled page with all images and grouped sections. The CSV export provides a catalog with filename, city, country, region, geotag status, and URL. All settings are persisted locally.

THE PANEL

The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—grouping mode and auto-scan—are persisted locally using GM_setValue, so your preferences remain intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script works on any page with images but is most useful on photo gallery and travel album pages. The location detection relies on filename patterns and alt text—it may not capture all locations correctly. The built-in location database covers 25+ major cities; for other locations, photos will be marked as "Unknown" and need manual assignment. The script does not access EXIF data directly from image files; it only reads what is visible on the page. Always review the organized album for accuracy. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.