Allowance Ledger Tracker for Parents

WHAT IT DOES

This userscript helps parents manage children's allowances by providing a complete ledger tracking system. It scans any webpage for text-based lists of children's names, chore completions, or allowance amounts, or allows manual entry. It provides a ledger interface to record earnings (chores, rewards) and spending (purchases, gifts), calculates running balances, and generates a visual summary of each child's allowance history. The script sets up recurring allowances (e.g., weekly), tracks savings goals, and exports the ledger as CSV or PDF. It also highlights overspending and suggests savings progress. The "Pay Weekly Allowance" button automatically adds the weekly allowance for all children who have a set amount.

WHERE IT RUNS

The script works on any webpage—family pages, chore lists, or any page with children's names. 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 allowance data is processed and stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Add children using the "Add Child" button. Set a weekly allowance amount for each child. Record transactions: select a child, enter a description, and enter the amount (positive for earnings, negative for spending). Use "Pay Weekly Allowance" to automatically add the weekly allowance for all children with set amounts. Set savings goals for each child to track progress. The summary shows each child's current balance and savings goal progress. View transaction history for each child. Use the export dropdown to choose your format—CSV or PDF (text)—and click "Export Ledger" to download the data.

THE TECHNICAL MECHANISM

This script uses a JSON-based data model stored locally in GM_setValue. The data includes children objects with weekly allowance amounts, transactions (child, description, amount, date), and savings goals. The balance calculation sums all transactions for a child. The "Pay Weekly Allowance" button adds a transaction for each child with a weekly allowance set. The CSV export generates a structured spreadsheet with columns: Date, Child, Description, Amount. The PDF export creates a formatted text report with each child's balance, transactions, and savings progress. The UI is built using BGPanel with sections for children management, transactions, goals, and history. The script auto-detects child names from page text using regex for capitalized words. 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 transaction data are persisted locally using GM_setValue, so your ledger remains intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script is designed for allowance tracking—it uses positive amounts for earnings and negative amounts for spending. The weekly allowance feature adds the same amount each time the button is clicked; be careful not to double-pay. The page-scanning feature extracts names from the current page but may not capture all names correctly. Always review and adjust the data as needed. 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.