Plain text accounting means doing accounting with plain text data formats and scriptable software, in the style of Ledger, hledger, beancount, and co. This site collects FAQs and a directory for the PTA community's tools, docs and practices. It is maintained by Simon Michael (hledger project leader, Ledger contributor, PTA researcher & fan), and contributors like you. Got feedback ? Join us in #plaintextaccounting or send an edit.
(A work in progress; improvements always welcome.)
Accounting is tracking the flow of valuable commodities, such as money or time. It clarifies activity, priorities, obligations, opportunities. It can reduce stress and even be enjoyable.
In 2003, John Wiegley invented Ledger: a command-line reporting tool and a plain text data format for efficient double-entry-style accounting. Ledger's ideas appealed to many software developers and technical folk. In 2007 and 2008 it was joined by hledger and Beancount respectively, and as of 2019 there are more than a dozen Ledger-likes, many add-on tools and an active community. This site was started in 2016 to help keep track of it all.
Double-entry bookkeeping is a process for keeping accounting records reliably. For every movement of value (a transaction), both the source and destination are recorded. Simple arithmetic invariants help prevent errors.
Value at any point in time is tracked in various accounts, classified as asset (owned), liability (owed) or equity (invested). Two more classifications track changes during some period: revenues (inflows) and expenses (outflows).
Transactions consist of debits (increases to asset or expense accounts, or decreases to liability or equity accounts) or credits (decreases to asset or expense accounts, or increases to liability or equity accounts).
Accounting data is valuable; we want to know that it will be accessible for ever - even without software. We want to know when it changes, and revision-control it. We want to search and manipulate it efficiently. So, we store it as human-readable plain text.
We simplify debits and credits by using signed numbers - positive for inflows to an account, negative for outflows from an account.
We define arbitrary account hierarchy to suit our needs. This scales smoothly from simple to complex scenarios, and from high-level overview to fine detail.
Ledger-likes are, at least in part, command-line tools. This makes them efficient to use and very scriptable and flexible.
Ledger-likes also, at their core, tend towards functional operation: they read the input data without changing it, and output a report. This simple model makes them easy to understand and rely on.
FAQ
What and Why
Objections and Concerns
Getting started, Practicalities
news/discussion
mail lists/IRC
twitter
reddit
hacker news
stack exchange
software
plain text accounting apps
data import/conversion
data generation
reports
time logging
UI, console
UI, curses
UI, GUI
UI, web
UI, mobile
API
editor support
docs
general accounting
plain text accounting
comparisons
presentations
videos
articles & blog posts
in 2021
in 2020
in 2019
in 2018
in 2017
in 2016
in 2015
in 2014
in 2013
in 2012
in 2011
in 2010
in 2009
in 2008
in 2007
in 2006
common tasks
choosing accounts
choosing cash vs accrual
entering data
importing
reconciling
reporting
budgeting
forecasting
invoicing
multiple currencies
trip expenses
shared expenses
taxes
time tracking
inventory tracking
non-profit accounting
exporting
customising
API access
Who's using Ledger? has some stories.
If you would like to use a GUI that provides lots of guidance, PTA tools currently don't meet that need. Most current PTA users tend to be comfortable using the command line, editing plain text, and perhaps using version control.
Traditional GUI-centric accounting software:
Free/open-source: GNUCash, Grisbi, KMyMoney..
Commercial: Quicken, Quickbooks, You Need A Budget..
Online/cloud-based accounting software: Xero, FreeAgent..
Here is Wikipedia's Comparison of accounting software. Also:
Some key factors:
a. The plain text, human readable, well supported data formats.
b. The division of concerns between creating and managing the data (your responsibility) and analysing it (the tool's responsibility). Ie "immutable data" + "referentially transparent reporting tools".
c. The command-line interface.
d. The ecosystem of related tools.
create synergies such as:
1. The data is more future proof. You can access it relatively easily with different software, newly-written software, or no software.
2. The command-line based UI, together with the plain text format, allows easy integration with other software, custom workflows and automation.
3. The user's responsibilities and mental model feel simpler, ie: "I just need to keep a list of transactions". Complex features and tools are not visible until you need them. Common actions can be easily scripted for daily use.
4. The data can be managed using the rich ecosystem of tools for managing text. This is appealing to folks familiar with such tools.
5. Most significantly, the data can be effectively version controlled, providing an audit trail, unlimited "undo", and collaboration.
6. Because the software (mostly) does not touch your data, and because version control would let you know and roll back if it did, you can have great confidence in the integrity of your data. If the software misbehaves, your data is not at risk. It's safe and relaxing to try out new features or new software on your data.
7. The data/tool separation facilitates decentralised development, stimulating an ecosystem of more tools and integrations.
8. The free form DSL-style format provides great expressiveness for modelling and documenting real-world financial activities, without UI-imposed limitations.
In addition to the advantages above, being Free or Open Source software helps ensure: - No lockin - your data remains accessible, and there are no yearly fees. - You can fix, enhance and port the software. - The software is more portable, scriptable, and lightweight.
People have very different needs and practise personal accounting for many different reasons. There is of course a point of diminishing returns; tailor your accounting practices to your needs. Needs change over time. Some of us would benefit from doing more (or better) accounting, some less (I would guess this second group is smaller). In The Millionaire Next Door (highly recommended), one research finding was that above-average wealth accumulators spend more time on financial planning, which for many of us requires accounting as a foundation. "Minimal time dedicated to financial planning is a leading indicator of a UAW [Under Accumulator of Wealth]".
Not entirely! "Plain Text Accounting" is a broad description, referring mainly to the data format. We welcome optional GUIs, and they are coming.
Yes! Many folks in our community do it. Mahatma Gandhi reconciled to the penny every night. J.D. Rockefeller was famous for his ledgers. It's not required. I started doing it as a temporary learning exercise, and still like it. It makes troubleshooting and reconciling easier.
Practice, and a process/toolset that suits you. Some folks import most of the data from their banks, so little manual data entry is required. A few prefer to manually enter everything, for the increased awareness and insight. "Manual" data entry is usually assisted in some way: interactive console tools (hledger add and similar), web-based tools (hledger-web and similar), GUI tools (ledgerhelpers), smart editors (eg emacs & ledger-mode), recurring transaction scripts. I currently use a mixture of bank CSV import and rapid copy/paste in emacs. I spend 15 minutes a day on average, and for me that's currently a good investment.
If you can export it as CSV, you can import it and run queries against it. There are also some tools for converting OFX, QIF etc.
Accounting is modelling flows of money (or other value). Such a model aggregates information from many sources, in one trusted place. With it you can efficiently generate reports, forecast things (cashflow!), answer questions, try experiments. Some people need a very simple model, others benefit from a more detailed one, and we don't know up front what we might need in future. The most fundamental accounting data is a simple list of transactions (the journal). Once you have captured this, you can mine it for anything you may want later on. Plain text accounting provides nice open data format(s), tools and practices for doing this, and could be a good foundation for more powerful tools.
"I am sure for a simple expense/budget ledger it will work OK, but when it comes to recurring journals, multiple reconciliation accounts, inter company transfers, control account tracing etc., give me a nice GUI any day..."
Understandable. The current plain text accounting tools provide a very generic double entry accounting system with which you can model such things, and script them. There are a number of generic GUIs available (hledger has curses and web interfaces, and there are web/curses/GTK interfaces for Ledger and beancount). But there are not yet a lot of rich task-specific GUIs. There's no reason they can't be built, though.
"it's pretty obvious that plain-text files don't scale to a multinational, with hundreds of accountants of various types all trying to work with the same files. Even with proper use of Git I bet that would get old fast. You would instead want a real database, with a schema, and some data validation and some programs/webpages to smooth out the data entry and querying and whatnot."
I'm not sure. Current plain text accounting tools can do some schema definition and data validation, and will do more in future. The plain text storage format is open, human-readable, future-proof (useful even without the software), scales smoothly from simple to complex needs, and taps a huge ecosystem of highly useful tooling, such as version control systems. And, despite the name, there's no reason these tools can't support other kinds of storage, such as a database.
Most (not all) plain text accounting implementations use signed amounts instead of debits and credits. This makes them "double entry light" perhaps, but it has been a rather successful simplification, intuitive to most newcomers.
Clean up text reports by hand, print them as PDF, export CSV reports to a spreadsheet..
You'll need a new accountant, or a duplicate set of books in QuickBooks, or to pioneer *ledger -> QuickBooks exporting.
You can use this to track and report the data needed for tax reporting. Fill out and submit tax forms with another tool, or by hand.
Glad you asked! See below, and also comparisons. hledger's FAQ discusses differences from Ledger, Beancount docs probably do too.
All in one file (or one file per year) and ordered by date is simplest and creates the fewest headaches (balance assertions/assignments, scope of directives, where to put entries, finding things..).
If you use emacs: it’s possible to insert org headings (which are comments to h/ledger) and then use org-mode or org-minor-mode to collapse/expand/navigate sections of your journal.
Also in emacs: in ledger-mode, C-c C-f can give you a filtered view of just one account’s transactions. (But be careful, if you edit in the wrong place it will lose data.)
https://www.reddit.com/r/plaintextaccounting/comments/d69slp/how_do_you_manage_multiple_accounts_in/
For individual accounting, somewhere between 500-1500 transactions and 100-400K of journal per year seems typical.
https://www.reddit.com/r/plaintextaccounting/comments/dbjizl/how_big_is_your_ledgerjournal_file/
See budgeting below.
#plaintextaccounting on Freenode IRC, #freenode_#plaintextaccounting:matrix.org on Matrix, project-specific mail lists/chats
#plaintextaccounting, #ledgercli, #hledger, #beancount, @LedgerTips
Project | Start | Last release | Code | Committers | Stars | Mail list, size | Chat, size |
---|---|---|---|---|---|---|---|
Ledger | 2003 | 2020-05 | C++ | 162 | 3.4k | ledger, 922 | #ledger, 80 |
hledger | 2007 | 2021-14 | haskell | 131 | 1.6k | hledger, 182 | #hledger, 90 |
Beancount | 2008 | 2020-06 | python | 44 | 618 | beancount, 377 | #beancount, 20 |
Abandon | 2013 | 2019-09 | scala | 11 | 151 | gitter | |
Transity | 2018 | 2019-05 | purescript | 7 | 472 | gitter | |
Ledger in Go | 2013 | 2019-11 | go | 6 | 221 | ||
cl-ledger | 2007 | common lisp | 4 | 66 | |||
rust_ledger | 2019 | 2020-09 | rust | 2 | 18 | ||
.Net Ledger | 2017 | 2018-08 | C# | 1 | 67 | gitter | |
goledger | 2019 | go | 1 | 13 | |||
monescript | 2017 | 2018-01 | javascript | 1 | 12 | ||
blossom | 2020 | F# | 1 | 12 | |||
Tackler | 2017 | 2021-01 | scala | 1 | 6 | gitter | |
acc | 2020 | rust | 1 | 1 | |||
bankroll | 2020 | 2020-08 | rust | 2 | 1 | ||
pta | 2020 | 2020-09 | perl | 1 | |||
Prudent | 2018 | js (closed; addons) | 1 | @PrudentLedger | |||
knut | 2020 | go | 1 | ||||
Inactive: | |||||||
beans | 2019 | 2019 | haskell | ||||
uledger | 2015 | python | |||||
pacioli | 2013 | python | |||||
ledger.pl | 2013 | perl | |||||
Penny | 2012 | 2014 | haskell | ||||
UMM | 2009 | 2010 | haskell | ||||
sm-Ledger | 2007 | squeak smalltalk | |||||
See also: | |||||||
plaintextaccounting.org | #plaintextaccounting, 50 | ||||||
/r/plaintextaccounting, 1773 |
Next, related add-ons and helpers by category (note: *ledger
below means Ledger and hledger-style journal format):
Editor plugins. Note these often work quite well for other ledger-likes, not just the one they are named for.
beancount-mode, hledger-mode, ledger-mode (also works for hledger, beancount etc.)
vim-ledger (supports ledger & hledger), vim-beancount, hledger-vim
C-c C-a
add a transaction,C-c C-b
amount calculator,C-c C-c
/C-c C-e
toggle clearedC-c C-r
The purpose of a budget is to help thy purse to fatten. It is to assist thee to have thy necessities, and insofar as attainable, thy other desires. It is to enable thee to realise thy most cherished desires, by defending them from thy casual wishes. Like a bright light in a dark cave, thy budget shows up the leaks from thy purse, and enables thee to stop them and control thy expenditures for definite and gratifying purposes. -- The Richest Man in Babylon
Periodic budgeting: setting per-period goals
Envelope budgeting: pre-allocating funds
Envelope budgeting with auto postings
Envelope budgeting with auto postings, org-mode and babel
More
(c) 2016-2019 Simon Michael & contributors | Send updates via github (latest changes)