Budget vs Actual Calculator

WHAT IT DOES

Budget vs Actual Calculator is a floating calculator panel that helps you track budget vs actual spending. Set budget amounts for any category (Groceries, Rent, Entertainment, etc.). Add actual spending entries as you go. The panel calculates and displays the variance — over budget (red) or under budget (green) — with percentage indicators. All data persists locally so you can keep tracking across sessions.

WHERE IT RUNS

This script runs on any website you visit. It reads only the page you are looking at, never other tabs, bookmarks, or browser data. All data stays in your browser — nothing is sent anywhere.

HOW TO USE

Click the Budget vs Actual Calculator panel button in the BotGentz extension toolbar. The panel appears at the edge of the page. To set a budget, enter a category name and a budget amount, then click "Set Budget". To track spending, select a category from the dropdown, enter the amount spent, and click "Add Actual". The summary section updates instantly — showing each category's actual vs budget, over/under status, and total across all categories. Use "Clear All" to reset all data, or "Copy Summary" to copy the totals to your clipboard.

TECHNICAL MECHANISM

Budget data and actual entries are stored using GM_setValue and retrieved with GM_getValue, persisting locally in the browser's storage. Budgets are stored as a key-value map of category → amount. Actual entries are stored as a key-value map of category → array of amounts, allowing multiple transactions per category. The total actual for a category is the sum of its entries. Variance is calculated as budget minus actual (positive = under budget, negative = over budget). The UI updates in real time using DOM manipulation. The entire application runs client-side; no data is sent to any server.

THE PANEL

The panel is a floating overlay that you can drag anywhere on the screen by its header. It remembers its position per site so it reappears where you left it. The panel can be collapsed into a small handle to get it out of the way, and snapped to the edge of the page. It can be resized to fit your workflow. Press Escape to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to run. All data is stored locally in your browser — nothing is transmitted or shared. The panel works on any website. Sites change — the script may need updates to match new site structures.