Cash Flow Snapshot Calculator

WHAT IT DOES

Cash Flow Snapshot Calculator is a floating calculator panel that tracks your cash flow. Add income and expense entries with descriptions and categories. View total income, total expenses, net cash flow, and running balance in real time. All entries are saved locally so you can pick up where you left off, even after closing the page.

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 Cash Flow Snapshot Calculator panel button in the BotGentz extension toolbar. The panel appears at the edge of the page. Select Income or Expense, enter a description, amount, and optional category, then click "Add Entry". The entry appears in the list below, and the totals update instantly. Use "Clear All" to remove all entries, or "Copy Summary" to copy the totals to your clipboard. The panel remembers your entries across pages — they persist until you clear them.

TECHNICAL MECHANISM

Entries are stored using GM_setValue and retrieved with GM_getValue, which persists data locally in the browser's storage. Each entry stores a description, amount, type (income/expense), category, and timestamp. The running balance is calculated by summing income entries and subtracting expense entries. Totals update on every change. The panel uses a simple DOM-based UI — no external libraries or frameworks. The entire application runs client-side; no data is sent to any server. This means your financial data stays entirely in your browser.

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, but only reads the page for its own UI; it does not automatically read financial data from the page. Sites change — the script may need updates to match new site structures.