(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 and 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.
+(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 and 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.
Next, related add-ons and helpers by category (note: *ledger below means Ledger and hledger-style journal format):
C-c C-a add a transaction,C-c C-b amount calculator,C-c C-c/C-c C-e toggle clearedBudget reporting with Ledger's periodic transactions:
+Budget reporting with Ledger's/hledger's periodic transactions:
--
Budget reporting with hledger-budget:
-Envelope budgeting with ordinary accounts:
Budget reporting with hledger-budget: - -- [hledger-budget](http://hledger.org/manual.html#budget) +- [hledger: Budget report](https://hledger.org/hledger.html#budget-report) +- [hledger: Budgeting and forecasting](https://hledger.org/budgeting-and-forecasting.html) Envelope budgeting with ordinary accounts: @@ -1004,8 +1001,8 @@ Envelope budgeting with automated postings, org & babel: ### time tracking - [Ledger: Time Keeping](http://ledger-cli.org/3.0/doc/ledger3.html#Time-Keeping) -- [hledger: Timeclock files](http://hledger.org/manual.html#timeclock-format) -- [hledger: Timedot files](http://hledger.org/manual.html#timedot-format) +- [hledger: Timeclock files](https://hledger.org/timeclock.html) +- [hledger: Timedot files](https://hledger.org/timedot.html) - [Timetracking and billing with (h)ledger](https://github.com/anarcat/ledger-timetracking) - [time tracking tools](#time-logging) @@ -1021,7 +1018,7 @@ Envelope budgeting with automated postings, org & babel: ### exporting - [Ledger: The csv command](http://www.ledger-cli.org/3.0/doc/ledger3.html#The-csv-command) -- [hledger: CSV output](http://hledger.org/manual.html#csv-output) +- [hledger: Output format](https://hledger.org/hledger.html?highlight=budget#output-format) - [Beancount: Exporting Your Portfolio](https://docs.google.com/document/d/1mNyE_ONuyEkF_I2l6V_AoAU5HJgI654AOBhHsnNPPqw) ### customising @@ -1036,10 +1033,7 @@ Envelope budgeting with automated postings, org & babel: - [hledger-lib](http://hackage.haskell.org/package/hledger-lib), [hledger](http://hackage.haskell.org/package/hledger), [an example](http://stefanorodighiero.net/posts/2015-01-04-hledger-find-duplicate-accounts.html) - Haskell -- [hledger-api](http://editor.swagger.io/#/?import=demo.hledger.org/api/swagger.json&no-proxy), - [examples](https://github.com/simonmichael/hledger/tree/master/hledger-api/examples) - JSON +- [hledger-web: JSON API](https://hledger.org/hledger-web.html#json-api) - [node-hledger](https://github.com/rstacruz/node-hledger) JavaScript