Home Inventory Photo Log Organizer

WHAT IT DOES

This userscript helps you create a comprehensive home inventory by organizing photos of household items. It scans image gallery or upload pages—Google Photos, iCloud, Dropbox, local file listings, or any page with images—and provides an organizing interface to tag, categorize, and annotate each item. You can assign items to rooms (Living Room, Bedroom, Kitchen, etc.), categories (Furniture, Electronics, Appliances, Art, Jewelry, etc.), and add purchase date, estimated value, serial number, and notes. The script automatically suggests categories based on filenames and can detect missing key fields, highlighting items that need more information for insurance purposes. The inventory can be exported as CSV, JSON, or PDF for record-keeping or insurance claims.

WHERE IT RUNS

The script works on any webpage containing 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 inventory 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). Click "Scan page for images" to manually scan the page. The panel displays a list of detected images with thumbnails, filenames, suggested categories, and status indicators (✅ for complete, ⚠️ for missing fields). Use the export dropdown to choose your format—CSV, JSON, or PDF (text). Click "Export inventory" to download the inventory file. The export includes name, filename, category, room, purchase date, value, serial number, notes, tags, and image URL.

THE TECHNICAL MECHANISM

This script uses DOM traversal to extract image elements from the page. It collects each image's src URL, filename, alt text, title, and dimensions. Filenames are parsed from URLs and cleaned (removing extensions and replacing underscores/hyphens with spaces). The script includes a keyword-based category suggestion engine with over 40 keywords across 9 categories (Furniture, Electronics, Appliances, Art, Jewelry, Clothing, Tools, Kitchen, Outdoor). For example, "chair" → Furniture, "laptop" → Electronics, "fridge" → Appliances. The inventory is stored in memory as an array of image objects with fields for name, filename, category, room, purchase date, value, serial number, notes, and tags. The export function formats the data as CSV (with proper quoting), JSON, or a text-based PDF representation. Missing field detection highlights items without category, room, or value.

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—export 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 category suggestion is based on filenames and may not always be accurate—review and adjust categories as needed. The PDF export is a text-based report, not a graphical PDF. 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.