A reliable, user-friendly Plain Text Accounting tool with command line, terminal and web interfaces.
Go to file
2022-09-08 13:42:29 -10:00
.github ci: binaries-linux-x64-static: fix gather binaries step 2022-08-29 13:35:46 +01:00
.sandstorm Add --capabilities-header to launcher.sh 2018-06-24 17:44:22 +02:00
bin stack: bump to 2022-09-01 resolver 2022-09-01 15:30:33 -07:00
checks update dev setup tests 2015-03-16 17:59:06 -07:00
doc doc: update github release links 2022-09-01 18:36:51 -07:00
docker package: added helper scripts in docker/ 2019-01-31 12:44:12 -08:00
docker-static-arm32v7 Static builds for Linux on x64 (amd64) and arm32v7 architectures (#1571) 2021-06-30 18:05:27 -10:00
examples examples: bcexample: drop beancountish double quotes 2022-07-23 02:35:17 +01:00
hledger imp: dev builds with uncommitted changes now show + in --version 2022-09-08 12:23:59 -10:00
hledger-install install: 1.27 2022-09-01 18:36:46 -07:00
hledger-lib dev: lib: improve ReportSpec doc 2022-09-07 09:53:11 -10:00
hledger-ui dev: ui: as, bs: reuse update, draw code 2022-09-08 13:42:29 -10:00
hledger-web cabal: update cabal files 2022-09-01 18:37:57 -07:00
tools tools: release: use new binaries branch (and force a new build) 2022-06-05 00:03:39 +01:00
.ci ;api: another round of hledger-api purging; fix the build 2019-09-11 14:49:22 -07:00
.ctags cli, lib: move functional tests into hledger/test/ 2020-11-16 08:47:41 -08:00
.dockerignore package: added Dockerfile 2019-01-29 16:14:03 -08:00
.editorconfig fix datepicker not closing, linting 2017-12-30 13:44:40 -05:00
.ghci tools: use pretty-simple for ghci output 2020-11-03 08:19:01 -10:00
.gitignore tools: stop ignoring site/ 2022-04-14 10:58:31 -10:00
.hlint.yaml cln: silence some warnings/lints 2022-03-26 08:34:21 -10:00
.mailmap doc: use consistent spelling of Mykola Orliuk 2017-03-27 05:47:15 -07:00
.version ;pkg: bump version to 1.27.99 2022-09-01 18:37:40 -07:00
ACHIEVEMENTS.md ;doc: update achievements listing 2022-08-01 22:54:24 +01:00
azure-pipelines.yml ;api: another round of hledger-api purging; fix the build 2019-09-11 14:49:22 -07:00
BACKLOG.org ;backlog: build-tools 2021-11-13 09:34:38 -10:00
bench-ledger.sh ;imp: perf: Ledger-friendly bench-ledger.sh, for comparative benchmarking 2021-11-20 22:05:19 -10:00
bench.sh ;tools: update instructions for installing quickbench 2021-06-15 15:19:38 -10:00
BENCHMARKS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
cabal.project ; cabal.project: Drop compatibility comment 2021-10-08 08:31:43 -10:00
CHANGELOGS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
CHANGES.md doc: update changelogs 2022-09-01 18:36:39 -07:00
CODE.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
COMMITS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
CONTRIBUTING.md ;doc: contributing: add haskell-hledger popcon chart 2022-08-25 05:13:14 +01:00
CREDITS.md doc: CREDITS: consistent heading 2022-07-24 07:21:54 +01:00
dev.hs collect some langage pragmas in dev.hs 2019-02-20 18:08:33 -08:00
dir ;dev: doc: update manuals 2021-07-12 18:50:06 -10:00
Dockerfile ;api: another round of hledger-api purging; fix the build 2019-09-11 14:49:22 -07:00
DOCS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
EXAMPLES.md ;doc: move more content out of CONTRIBUTING 2021-09-27 01:44:14 -10:00
FINANCE.md doc: FINANCE: fix TOC 2022-07-24 07:21:54 +01:00
hie-other.yaml ;tools: generalise hie-mac.yaml 2022-04-17 07:18:22 -10:00
ISSUES.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
LICENSE add LICENSE 2008-10-01 07:52:07 +00:00
MAKE.md ;doc: move more content out of CONTRIBUTING 2021-09-27 01:44:14 -10:00
Makefile dev: make ghci*: allow use of Debug.Breakpoint 2022-08-26 11:29:16 +01:00
Makefile.helpsys make: rename sub-makefiles; start moving site script to make/shake 2019-03-05 18:43:04 -08:00
PULLREQUESTS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
README.md CREDITS.html -> CREDITS.md 2022-06-09 17:12:32 +01:00
RELEASING.md doc: RELEASING: updates 2022-09-02 11:54:51 -07:00
ROADMAP.org ;doc: orgfiles: disable smart dashes in another way 2021-09-27 12:15:09 -10:00
Shake.hs stack: bump to 2022-09-01 resolver 2022-09-01 15:30:33 -07:00
SHAKE.md ;doc: move more content out of CONTRIBUTING 2021-09-27 01:44:14 -10:00
stack8.10.yaml imp: lib: Hledger.Utils.Debug: re-export Debug.Breakpoint 2022-08-23 02:02:19 +01:00
stack9.0.yaml imp: lib: Hledger.Utils.Debug: re-export Debug.Breakpoint 2022-08-23 02:02:19 +01:00
stack.yaml stack: bump to 2022-09-01 resolver 2022-09-01 15:30:33 -07:00
TESTS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00
VERSIONNUMBERS.md ;doc: move more content out of CONTRIBUTING 2021-09-27 01:44:14 -10:00
WORKFLOWS.md ;doc: fix tables of contents in developer documentation 2022-07-31 10:57:09 +01:00

hledger

Robust, intuitive plain text accounting

license on hackage github issues

Welcome! This a brief intro to hledger. For a more detailed version, see the home page: https://hledger.org

hledger is lightweight, cross platform, multi-currency, double-entry accounting software. It lets you track money, investments, cryptocurrencies, invoices, time, inventory and more, in a safe, future-proof plain text data format with full version control and privacy.

hledger aims to help both computer experts and regular folks gain clarity in their finances and time management. Though the UIs are basic, hledger can model any accounting situation and provide precise, clear reports. It is reliable, quick, and backed by the highly supportive Plain Text Accounting ecosystem. Using it is an excellent way to learn double entry accounting.

Compared to other PTA apps, hledger is actively maintained, with regular releases, and a strong focus on being easy to use and practical for everyday accounting.

More features:

  • Installs easily on unix, mac or windows
  • Complete, built-in documentation in multiple formats, beginner videos, tutorials etc.
  • Multiple UIs: command-line, terminal, web, mobile, editors/IDEs
  • Good at importing and exporting CSV; also outputs text/HTML/JSON/SQL
  • A robust, general, well-specified multi-currency accounting engine
  • Fast, analysing 25k transactions per second on a macbook air m1
  • Accurate to 255 decimal places
  • Supports your preferred account names, currencies, number formats
  • Inspired by and partly compatible with Ledger CLI; interconvertible with Beancount
  • Scriptable by CLI, HTTP or API, with plenty of examples
  • Clean Haskell codebase, continually improved since 2007, with $100 regression bounties
  • Free software licensed under GPLv3+.

Examples

I use hledger to:

  • track income and spending, sometimes with budgets
  • see time reports by day/week/month/project
  • track reimbursables, invoices and payments
  • predict cashflow and account balances
  • get accurate numbers for tax filing
  • research past events

Here's an example of the journal file format:

2022-01-01 opening balances as of this date
    assets:bank:checking                $1000
    assets:bank:savings                 $2000
    assets:cash                          $100
    liabilities:creditcard               $-50
    equity:opening/closing balances

2022-01-15 market
    expenses:food             $50
    assets:cash              $-50

2022-02-01 GOODWORKS CORP
    assets:bank:checking           $1000
    income:salary                 $-1000

and some simple reports:

$ hledger bs
Balance Sheet 2022-02-15

                        || 2022-02-15 
========================++============
 Assets                 ||            
------------------------++------------
 assets:bank:checking   ||      $2000 
 assets:bank:savings    ||      $2000 
 assets:cash            ||        $50 
------------------------++------------
                        ||      $4050 
========================++============
 Liabilities            ||            
------------------------++------------
 liabilities:creditcard ||        $50 
------------------------++------------
                        ||        $50 
========================++============
 Net:                   ||      $4000 
$ hledger is --monthly                                            
Income Statement 2022-01-01..2022-02-28                                               
                                                                                      
               ||  Jan    Feb                                                         
===============++=============                                                        
 Revenues      ||                                                                     
---------------++-------------                                                        
 income:salary ||    0  $1000                                                         
---------------++-------------                                                        
               ||    0  $1000                                                         
===============++=============                                                        
 Expenses      ||                                                                     
---------------++-------------                                                        
 expenses:food ||  $50      0                                                         
---------------++-------------                                                        
               ||  $50      0                                                         
===============++=============                                                        
 Net:          || $-50  $1000                                                         

More examples and screenshots: https://hledger.org/#how-to-get-started

Funding

hledger is brought to you by Simon Michael, 140+ contributors, and the generous financial sponsors below.

After enjoying some personal or organisational success with hledger, you might want to become one of them, to help support this work. It's easy! Please see https://hledger.org/sponsor.html for details.

Organisational sponsors

Individual sponsors

If your logo/avatar needs to be added, let me know!