Budgeting App Overspend Alert Badge

WHAT IT DOES

Budgeting App Overspend Alert Badge scans the current page for budget category data including assigned amounts, spent amounts, available balances, and overspend indicators. It extracts category names, budgeted amounts, actual spending, and remaining balances from budgeting apps (YNAB, EveryDollar, Mint, etc.). The floating panel shows categories that are overspent or approaching their limits with visual alerts (red for overspent, yellow for near limit). An overspend summary shows total overspent amount, number of overspent categories, and the most urgent alert. Custom alert thresholds can be set (percentage of budget remaining), overspent categories can be highlighted directly on the page, and overspend reports can be exported as text or CSV. Quick action buttons provide one-click access to view details or reallocate funds.

WHERE IT RUNS

Works on any budgeting app page, including YNAB, EveryDollar, Mint, and other zero-based budget platforms. The script intelligently detects budget categories using common selectors and can also fall back to general number pattern matching on any page with structured budget data. It works best on YNAB and EveryDollar but can detect categories on most web-based budgeting tools.

HOW TO USE

The panel displays an alert summary showing total overspent amount, number of overspent categories, near-limit totals, and the most urgent alert. The alerts list shows each category with its status (Overspent or Near Limit), amount, and visual indicator. Adjust the near-limit threshold slider to control when categories trigger yellow alerts (default 20%). Toggle "Highlight alerts on page" to visually mark overspent and near-limit categories directly on the budget page. Export the full alert report as text or CSV for sharing or analysis. The panel shows a notification count badge when alerts are detected, and desktop notifications can be enabled for immediate awareness.

MECHANISM — BUDGET DATA EXTRACTION WITH STATUS CALCULATION

The script uses a multi-strategy approach to extract budget data and calculate alert status. It first attempts to find category containers using common budgeting app selectors (.category, .budget-category, .category-row). From each container, it extracts category names and amount values using targeted sub-selectors. The available balance is calculated as assigned minus spent. Alert status is determined by checking if available is negative (overspent) or if available is below a configured percentage of assigned (near limit). The near-limit threshold is user-configurable via a slider. Categories are assigned unique IDs for tracking, and the most urgent alert is determined by the largest overspend amount. All extraction runs client-side with no network calls.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including threshold percentage and highlight toggles, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all extracted budget data, alerts, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only category names, amounts, and alert status from publicly visible budget page content. The script displays alerts and highlights on the page but does not modify the actual budget app data. Data persists across browser sessions and is isolated per browser profile.