Emergency Fund Goal Progress Tracker

WHAT IT DOES

This userscript helps you build an emergency fund by tracking your savings progress against a goal. It scans any webpage for text-based financial figures—bank balances, savings accounts, income, expenses—or allows manual entry, to track progress toward an emergency fund goal. It extracts current savings balances from the page, calculates the percentage of the goal achieved, shows the remaining amount needed, and displays a visual progress bar. The script projects the time to reach the goal based on your current savings rate, suggests monthly savings targets, and exports the progress report as CSV or HTML. It tracks multiple emergency fund goals (e.g., 3-month, 6-month, 12-month) and provides motivational milestones at 25%, 50%, 75%, and 100%.

WHERE IT RUNS

The script works on any webpage with financial figures—bank websites, savings account pages, budgeting apps, or any page with dollar amounts. 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 fund data is processed and stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Enter your goal amount, current savings, and monthly savings rate. The panel displays a progress bar, percentage complete, remaining amount, and time to goal. Milestones at 25%, 50%, 75%, and 100% are shown. Click "Add savings update" to record a new balance and update your progress history. Click "Extract from page" to scan the current page for balances and auto-fill your current savings. Use the export dropdown to choose your format—CSV or HTML (report). Click "Export" to download.

THE TECHNICAL MECHANISM

This script calculates progress as (current balance / goal amount) × 100. The remaining amount is goal minus current balance. Time to goal is calculated as remaining amount divided by monthly savings rate (in months). The progress bar is animated and color-coded (blue for progress, green for complete). The history chart shows the last 12 savings updates as a bar chart. The milestone markers display at 25%, 50%, 75%, and 100% of the goal. The status message provides motivational feedback based on progress level. All data is persisted using GM_setValue. The export generates CSV with metrics or HTML with a styled progress report.

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

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script extracts figures from page text—it may not capture all numbers correctly. Review and adjust extracted data as needed. The projections are estimates based on current savings rate and assume consistent savings. 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.