Household Manual Quick-Reference Binder Builder

WHAT IT DOES

This userscript helps homeowners create a comprehensive quick-reference binder for household appliances by extracting key information from product pages, user manuals, warranty documents, and maintenance guides. It scans the page for appliance details—name, model number, serial number, purchase date, warranty period, maintenance schedule, error codes, and support contacts. It also extracts troubleshooting tips and maintenance intervals. The script provides a digital binder-building interface to compile, organize, and format the information into a quick-reference binder. You can add custom notes to each appliance and export the compiled binder as HTML, Markdown, or PDF text. The script also generates a printable quick-reference card for each appliance.

WHERE IT RUNS

The script works on appliance product pages, user manual pages, warranty documents, and maintenance guides. 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 appliance 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 pages for appliance information on load (toggle this on/off). Click "Scan page for appliances" to manually scan the page. The panel displays a list of detected appliances with model and serial numbers. Use the export settings to choose your format—HTML (web page), Markdown, or PDF (text). Toggle whether to include maintenance schedule, troubleshooting, and error codes. Click "Build & Export Binder" to generate and download the quick-reference binder. The export includes all appliance details in a clean, organized format with sections for each appliance.

THE TECHNICAL MECHANISM

This script uses DOM traversal and pattern matching to extract appliance data from page text. It scans for appliance elements using selectors like .product, .appliance, .manual, [class*="product"], and [class*="appliance"]. For each element, it extracts the appliance name from title elements, model number using "model #: X" patterns, serial number using "serial #: X" patterns, purchase dates using a regex cascade for MM/DD/YYYY, YYYY-MM-DD, and named month formats, and warranty periods using "X years warranty" patterns. It also extracts maintenance schedule items, error codes using "error code: X" patterns, troubleshooting tips, and support contact information. The binder export formats the data as HTML with styling, Markdown with structured headings, or PDF text with clear sections. 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—export format, include maintenance, include troubleshooting, include error codes, 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 best on well-structured product and manual pages with clear labels. It may not capture all data from poorly formatted or scanned text. Always review extracted information for accuracy before using it for maintenance or repairs. 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.