Chore Rotation Wheel Generator

WHAT IT DOES

This userscript helps families, roommates, and teams fairly distribute chores by generating a colorful, interactive chore rotation wheel. It scans any webpage for text-based lists of names and chores, or allows manual entry, then creates a visual wheel that randomly assigns chores to members. The script extracts names (capitalized words) and chore-like phrases from the page, then builds a rotation schedule. It generates a printable schedule showing who is assigned to which chore each day, supports multiple weeks of rotation, and exports the rotation as HTML (printable wheel) or CSV. The script can also track completed chores and suggest fair rotations based on task difficulty or frequency.

WHERE IT RUNS

The script works on any webpage with text-based lists of names and chores—family pages, group chat logs, task lists, or any page with names and tasks. 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 data is processed locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Click "Scan page for names & chores" to automatically extract names and chores from the current page. Manually add members and chores using the input fields and "Add Member" / "Add Chore" buttons. Edit the members and chores lists directly in the text areas (one per line). The preview shows the current rotation assignments. Choose your export format—HTML (printable wheel with schedule) or CSV. Click "Generate Wheel" to download the rotation file. The HTML export creates a colorful card-based wheel with a weekly schedule table.

THE TECHNICAL MECHANISM

This script uses text extraction to identify names and chores from page content. It scans for capitalized words (names) and common chore keywords like "clean", "wash", "sweep", "mop", "vacuum", "organize", "fold", "water", "feed", "empty", and "load". Chore extraction filters out short lines and number-only lines. The rotation algorithm assigns chores to members by cycling through the chore list—each member gets a chore in order, and the schedule repeats weekly. The HTML export generates a color-coded card view with each member's assigned chore and a full weekly schedule table. Colors are assigned from a palette of 10 vibrant colors. CSV export provides a simple member, chore, week format. Member and chore lists are saved locally using GM_setValue for persistence 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—members list and chores list—are persisted locally using GM_setValue, so your data remains intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script is designed for chore rotation—it extracts names and chores from page text but may not capture all items correctly. Review and adjust the extracted lists before generating the wheel. The rotation is based on a simple cycling algorithm; for more complex scheduling (e.g., task difficulty balancing), you may need to manually adjust assignments. 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.