Family Photo Album Auto-Organizer by Date

WHAT IT DOES

This userscript helps families organize their digital photo collections by automatically sorting images by date. It scans image gallery pages, photo albums, or file listings for photo metadata—EXIF date taken, file modified date, or date patterns in filenames. It then organizes and sorts the photos into a chronological album view with visual date dividers. You can group photos by year, month, or day, detect gaps in dates, and highlight photos with missing or inconsistent date metadata. The script generates a timeline summary showing photo distribution over time, and exports the organized album as an HTML page or CSV catalog. It can also detect duplicate photos based on date and filename similarity.

WHERE IT RUNS

The script works on any webpage with images—Google Photos, iCloud, Dropbox, local file listings, 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—Year, Month, or Day. Choose your date format for display—MMM D, YYYY; MM/DD/YYYY; or DD/MM/YYYY. Click "Organize Photos" to scan and sort the images. The gallery displays photos in chronological order with date dividers. Use the export dropdown to choose your format—HTML (photo album) or CSV (catalog). Click "Export Album" to download the organized album. The HTML export creates a styled photo album with grouped sections.

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 the photo date from three sources: alt/title text containing date strings (e.g., "2024-01-15"), filename date patterns (YYYY-MM-DD, YYYYMMDD, MM-DD-YYYY, etc.), and falls back to the current date with an "unknown" marker. The date parser handles multiple formats. Images are sorted chronologically and grouped by the selected mode (year, month, or day). The gallery renders each group with a header and thumbnail grid. The HTML export generates a self-contained styled page with all images and grouped sections. The CSV export provides a catalog with filename, date, source, 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, date format, 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 cloud storage pages. The date extraction relies on filename patterns and alt/title text—it may not capture all dates correctly if photos lack consistent metadata. 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. The script does not access external APIs or store any data outside your browser. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.