Plain Text Accounting (hledger)
hledger belongs to a group of tools built on a simple idea: all financial records can live in plain text files. No hidden databases, no vendor lock-in — just a journal that can be read with any text editor. For many users, this is less about fancy features and more about trust: plain text doesn’t break, and it can be backed up or shared like any other file.
Everyday use
Working with hledger feels closer to writing notes than “using an app.” A typical entry is just a few lines describing when money moved, what it was spent on, and which accounts were involved. Once saved, reports can be generated instantly — balances, spending summaries, even cashflow views. Everything runs from the command line, though there’s also a lightweight web interface for those who prefer a browser view. Because the data is just text, it plays nicely with Git or other version control tools, which makes long-term tracking and collaboration unusually easy.
Specs & notes
| Item | Details |
| License | Open source (GPL) |
| Platforms | Linux, macOS, Windows |
| Data storage | Plain text journal files |
| Import / Export | CSV, QIF, OFX (with add-ons) |
| Accounts | Unlimited, defined directly in text |
| Budgets | Possible through rules and reporting commands |
| Recurring | Managed with periodic entries or simple scripts |
| Reports | Balance sheets, cashflow, income/expense, custom queries |
| Multi-currency | Supported |
| Privacy | Fully offline; user keeps all control |
Getting started
Installation depends on the system: on Linux it’s usually a package manager command, on macOS it’s available through Homebrew, and on Windows it can be downloaded pre-built. Once installed, the workflow starts by creating a file such as journal.hledger and writing the first transactions by hand. From there, commands like hledger balance or hledger register bring those numbers to life. Running hledger web opens a simple local web app for easier navigation.
Who uses it
This tool is often chosen by developers, sysadmins, and people who feel comfortable mixing budgeting with text files. It appeals to those who want financial data to be long-lasting and portable — the kind of users who like the idea that their budget history could still be opened in 20 years without relying on a specific app.
Why it sticks
hledger stays relevant because it offers something rare: full transparency. There are no black boxes, no disappearing data. Just plain text and a program that understands it. For users who care about control, it’s not just a tool but a philosophy that keeps it alive year after year.
