Ants Projects Hub
← All projects

Beta

finbreak

Breaks your finances into categories — private and offline.

BetaLNXWINLatest: v0.1.22
A silent 34-second tour of finbreak, in dark theme. It opens on the Home dashboard for July — 'July looked like a normal month', net R 10,533.21 — where three donut charts break down spending by category, income by source and transfers between accounts. It then moves through Transactions (306 rows auto-sorted into Groceries, Fuel, Dining out and the rest), the Categories tree, Recurring (auto-detected payments waiting to be confirmed above ones already confirmed), Forecast, and Accounts, before returning to the dashboard.
The finbreak dashboard in dark theme with 'Previous month' selected and a net of R 10,533.21. Three donut charts across the top break down spending by category, income by source (Salary, Interest) and transfers (Cheque account to Savings). Below, panels list Spending R 21,551.79 (Rent/Mortgage R 9,500, Groceries R 3,524.50, Transport R 3,012.45 and more), Income R 32,085.00 and Transfers R 3,000.00, with a monthly recurring summary and an income-versus-spending bar chart along the bottom.The Transactions view in light theme: a searchable, sortable table of 306 transactions with Date, Amount, Currency, Description, Account and Category columns. Rows show South African merchants such as Shell, Pick n Pay, Ocean Basket, Bolt, KFC and Checkers automatically sorted into categories like Fuel, Groceries, Dining out and Ride-hailing, with income amounts in green and expenses in red.The Categories screen in dark theme showing the category tree. Expenditure branches into Bills & utilities (Electricity, Internet, Mobile), Entertainment (Dining out, Streaming), Groceries, Transport (Fuel, Ride-hailing) and more; Income branches into Gifts, Interest, Salary and Sales. Fields at the bottom let you add a category, move it under a parent, or delete the selected one.The Recurring view in light theme with two tables. 'Suggested recurring items' lists payments finbreak has auto-detected — Outsurance, FNB Credit, Dis-Chem and City of Cape Town — awaiting Confirm or Dismiss. 'Confirmed recurring items' lists Vodacom, Spotify, Netflix, DStv, Afrihost Fibre and an Acme salary, each with its direction, monthly cadence, amount and next due date.The Rules screen in light theme: a table of auto-categorisation rules mapping a text pattern to a category — nando to Fast food, vodacom to Mobile, netflix to Streaming, uber to Ride-hailing, engen to Fuel, and checkers and woolworths to Groceries. Buttons let you Add, Edit, Delete or reorder rules and apply them to existing transactions.The Transfers view in dark theme showing automatic transfer detection. An empty 'Suggested transfers' pane sits above 'Confirmed transfers', a list of monthly R 3,000 movements from the Cheque account to Savings dating back through 2025, each with a date, amount and description. finbreak pairs these so a transfer is not double-counted as both income and expense.

Most budgeting apps want to log into your bank. finbreak reads your statements instead — the CSV, OFX or PDF files your bank already gives you — and works out where your money went from those.

There is no bank linking, no account to sign up for, and no financial data leaving your computer. Left at its defaults, the app never touches the internet at all.

What it does

Imports a pile of statements at once. A year of monthly PDFs, a mix of formats, password-protected files — it asks up front for anything it genuinely cannot get past, then works through the rest and shows you one screen: every file, where it is going, how many transactions are new, how many are duplicates you already have, and how many lines it could not read. Nothing is written until you press Import.

Files them itself. It reads the account number printed on a statement and pre-selects the matching account, telling you why. Where it cannot be sure, it says so and leaves the choice to you rather than guessing.

Sorts transactions into categories — up to three levels deep — with built-in guesses for common shops and services, your own rules on top, and corrections it learns from. Every guess is tagged, so you can see what it decided and overrule it.

Spots money moving between your own accounts, so a transfer from your current account to savings is not counted as both spending and income.

Spots what repeats — subscriptions, debit orders, your salary — and suggests them for you to confirm, so you can see at a glance what is on autopilot.

Projects where you are heading. The forecast starts from a real closing balance rather than an estimate, brings it up to date, and draws the line to the end of the month or 30, 60 or 90 days out. It names any account it left out and why.

Checks the numbers add up. Each account is marked ✓ when your imported transactions bridge one statement's closing balance to the next, or ⚠ with the amount it is off by — so a missing or double import does not go unnoticed.

The dashboard

It opens by telling you in a sentence what the month actually did: "September cost you R2,340 more than your usual month. Most of it was one thing — Vet, R1,900 more than usual."

It stays quiet when a month is ordinary, says "so far" while one is still running, and says nothing at all rather than guessing when there is not yet enough history to know what usual means.

Below that, spending, income and transfers sit side by side, each opening down from a category to a single shop to the individual purchases. An alerts button lights up when something is worth a look — a new recurring charge, a category well above its usual, an expected debit that never posted.

Privacy and safety

Your data sits in an encrypted, password-protected vault. Copied amounts and descriptions are cleared from the clipboard after a short while, repeated wrong unlock attempts are slowed down, and account numbers show as dots plus the last four digits so a glance or a screenshot never gives one away.

You can export a PDF report — your choice of sections, accounts and period — and lock the file with its own password. Backups are encrypted, verified before you rely on them, and restorable even onto a new master password if you have forgotten the old one.

Where it stands

An early preview that already does a great deal, with polish still coming. There are six colour themes plus a follow-your-system setting, and every table remembers the column widths and order you gave it.

Windows builds are not yet code-signed, so SmartScreen will query it the first time — click More infoRun anyway. An application to a free signing programme for open-source projects was declined in July 2026; the plan is to build up a track record and reapply.

Changed

  • The README now explains how to make a desktop shortcut for the Linux AppImage If you pin the AppImage to your panel or add it to your applications menu, the shortcut file has to be named io.github.milnet01.finbreak.desktop — under any other name your desktop cannot tell the shortcut and the running window apart, and you end up with two finbreak icons side by side. That was not written down anywhere before.

Fixed

  • Imported credit-card statements no longer carry a stray "Continued on next page" (FIBR-0115) On a credit-card statement that runs over more than one page, the words "Continued on next page……" printed at each page break were being tacked onto the end of the transaction just above them — one messy description per page break. They are now left out. Your amounts were never affected by this; only the description text.

Full changelog · 22 earlier releases →