Home Maintenance Seasonal Checklist Generator

WHAT IT DOES

This userscript helps homeowners stay on top of seasonal maintenance by generating structured checklists from any webpage or manual entry. It scans any webpage for text-based lists of home maintenance tasks, seasonal reminders, or repair schedules, then extracts task names and seasonal categories (Spring, Summer, Fall, Winter). It creates a structured checklist with completion tracking for each season. The script suggests tasks based on the current season, generates printable checklists, and exports as CSV or HTML. It tracks completed tasks, highlights overdue or upcoming maintenance items, and provides quick actions to mark all tasks as done or clear completed items.

WHERE IT RUNS

The script works on any webpage with text-based maintenance lists—home improvement blogs, repair schedules, seasonal checklists, or any page with task lists. 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 checklist data is processed and stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Click "Scan page for tasks" to extract maintenance tasks and their seasonal categories from the current page. The script detects spring, summer, fall, and winter tasks. Switch between seasons using the dropdown to view each season's checklist. Check tasks off as you complete them—the progress bar updates automatically. Manually add tasks using the "Add Task" form with name and season. Use the export dropdown to choose your format—HTML (printable checklist) or CSV. Click "Export Checklist" to download. Use "Mark all as done" to complete all tasks for the current season, or "Clear completed" to reset completed tasks.

THE TECHNICAL MECHANISM

This script uses text extraction to identify maintenance tasks from page content. It scans lines for season names (Spring, Summer, Fall, Winter) and extracts task names from bulleted or numbered lists. Tasks are stored with name, season, and completion status. The current season is auto-detected based on the month (March-May: Spring, June-August: Summer, September-November: Fall, December-February: Winter). The checklist renders tasks with checkboxes—each checkbox toggles the completed state which is persisted using GM_setValue. The HTML export generates a styled checklist with task status indicators and a summary header. The CSV export provides a spreadsheet-ready format with task, season, and status columns. All data is persisted across sessions.

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 and checklist data are persisted locally using GM_setValue, so your checklist remains intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script extracts tasks from page text—it may not capture all tasks correctly. Review and adjust extracted tasks as needed. The season detection is based on the current month and default task lists. 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.