diff --git a/index2.md b/index2.md new file mode 100644 index 0000000..5f8d4eb --- /dev/null +++ b/index2.md @@ -0,0 +1,1007 @@ +% Plain Text Accounting, a guide to Ledger and friends + + + + + +
+[![github](https://img.shields.io/github/stars/plaintextaccounting/plaintextaccounting.svg?style=social&label=Github){title="send pull requests, bug reports, blog posts, star us, tweet with #plaintextaccounting tag"}](https://github.com/plaintextaccounting/plaintextaccounting) +
+ +
+ +
+ +
+ +# plain text accounting + +
+ +***Plain text accounting*** is a way of doing bookkeeping and accounting +with plain text files and scriptable, command-line-friendly software, such as +[Ledger, hledger, or Beancount](#plain-text-accounting-apps). + +This site together with [wiki.plaintextaccounting.org](https://wiki.plaintextaccounting.org) +is an entry point to the PTA community's tools, docs and practices. +It is [maintained](README.html) by +Simon Michael (hledger project leader, Ledger contributor, PTA fan) and contributors like you. +Got feedback ? Join us in [#plaintextaccounting:libera.chat] or [#plaintextaccounting:matrix.org] +or [send an edit](https://github.com/plaintextaccounting/plaintextaccounting/edit/master/index.md). + +
+ +## Overview + +[FAQ](#frequently-asked-questions) +  [What and Why](#what-and-why) +  [Objections and Concerns](#objections-and-concerns) +  [Getting started, Practicalities](#getting-started-practicalities) +[news/discussion](#newsdiscussion) +  [mail lists/IRC](#maillistsirc) +  [twitter](#twitter) +  [reddit](#reddit) +  [hacker news](#hacker-news) +  [stack exchange](#stack-exchange) +[software](#software) +  [plain text accounting apps](#plain-text-accounting-apps) +  [data import/conversion](#data-importconversion) +  [price fetching](#price-fetching) +  [data generation](#data-generation) +  [reports](#reports) +  [time logging](#time-logging) +  [UI, console](#ui-console) +  [UI, curses](#ui-curses) +  [UI, GUI](#ui-gui) +  [UI, web](#ui-web) +  [UI, mobile](#ui-mobile) +  [API](#api) +  [editor support](#editor-support) +[docs](#docs) +  [general accounting](#general-accounting) +  [plain text accounting](#plain-text-accounting) +  [comparisons](#comparisons) +  [presentations](#presentations) +  [videos](#videos) +[articles & blog posts](#articles-blog-posts) +  [in 2021](#in-2021) +  [in 2020](#in-2020) +  [in 2019](#in-2019) +  [in 2018](#in-2018) +  [in 2017](#in-2017) +  [in 2016](#in-2016) +  [in 2015](#in-2015) +  [in 2014](#in-2014) +  [in 2013](#in-2013) +  [in 2012](#in-2012) +  [in 2011](#in-2011) +  [in 2010](#in-2010) +  [in 2009](#in-2009) +  [in 2008](#in-2008) +  [in 2007](#in-2007) +  [in 2006](#in-2006) +[common tasks](#common-tasks) +  [choosing accounts](#choosing-accounts) +  [choosing cash vs accrual](#choosing-cash-vs-accrual) +  [entering data](#entering-data) +  [importing](#importing) +  [reconciling](#reconciling) +  [reporting](#reporting) +  [budgeting](#budgeting) +  [forecasting](#forecasting) +  [invoicing](#invoicing) +  [multiple currencies](#multiple-currencies) +  [trip expenses](#trip-expenses) +  [shared expenses](#shared-expenses) +  [taxes](#taxes) +  [time tracking](#time-tracking) +  [inventory tracking](#inventory-tracking) +  [non-profit accounting](#non-profit-accounting) +  [exporting](#exporting) +  [customising](#customising) +  [API access](#api-access) + +
+ + +
+ +## news/discussion + +
+
+ +##### mail lists/IRC

+
+ #plaintextaccounting:matrix.org + or #plaintextaccounting:libera.chat + (bridged); + [project-specific mail lists/chats](#plain-text-accounting-apps) +
+
+
+ +##### twitter +
+ +[#plaintextaccounting](https://twitter.com/hashtag/plaintextaccounting?f=live), +[#ledgercli](https://twitter.com/hashtag/ledgercli?f=live), +[#hledger](https://twitter.com/hashtag/hledger?f=live), +[#beancount](https://twitter.com/hashtag/beancount?f=live), +[\@LedgerTips](https://twitter.com/LedgerTips) + +
+
+
+ +##### reddit +
+ +[/r/plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/) + +
+
+
+ +##### hacker news +
+ +[stories](https://hn.algolia.com/?query=plain%20text%20accounting&sort=byDate&prefix=false&page=0&dateRange=all&type=story), +[comments](https://hn.algolia.com/?query=plain%20text%20accounting&sort=byDate&prefix=false&page=0&dateRange=all&type=comment) + +
+
+
+ +##### stack exchange +
+ +[[ledger-cli]](https://money.stackexchange.com/questions/tagged/ledger-cli?tab=newest) / ["ledger-cli"](https://money.stackexchange.com/search?tab=newest&q=ledger-cli), +[[hledger]](https://money.stackexchange.com/questions/tagged/hledger?tab=newest) / ["hledger"](https://money.stackexchange.com/search?tab=newest&q=hledger) + + +
+
+ +
+ + + +## software + + + +### plain text accounting apps + + + + + + + +| Project | Start | Last release | Code | Committers | Stars | Mail list, ~size | Chat, ~size | +|---------------------------|-------|:------------:|-----------------------------------|-----------:|------:|---------------------------------|---------------------------------------------------------------------------------------------------------------| +| [Ledger] | 2003 | 2021-05 | [C++][ledger-gh] | 176 | 4.2k | [ledger][ledger-mail] ~900 | [irc][#ledger:libera.chat] 60 | +| [hledger] | 2007 | 2022-06 | [haskell][hledger-gh] | 148 | 2k | [hledger][hledger-mail] ~200 | [matrix][#hledger:matrix.org]/[irc][#hledger:libera.chat] 120 | +| [Beancount] | 2008 | 2020-06 | [python][beancount-gh] | 59 | 1.8k | [beancount][beancount-mail] ~500 | [irc][#beancount:libera.chat] 20, [fava gitter][beancount-fava-gitter]/[matrix][#beancount_fava:gitter.im] 40 | +| Abandon | 2013 | 2019-09 | [scala][abandon-gh] | 11 | 156 | | [gitter][abandon-gitter]/[matrix][#hrj_abandon:gitter.im] | +| Transity | 2018 | 2019-05 | [purescript][transity-gh] | 7 | 472 | | [gitter][transity-gitter]/[matrix][#feramhq_transity:gitter.im] | +| Ledger in Go | 2013 | 2019-11 | [go][ledger-in-go-gh] | 6 | 221 | | | +| cl-ledger | 2007 | | [common lisp][cl-ledger-gh] | 4 | 66 | | | +| rust\_ledger | 2019 | 2020-09 | [rust][rust_ledger-gh] | 2 | 18 | | | +| .Net Ledger | 2017 | 2018-08 | [C#][nledger-gh] | 1 | 67 | | [gitter][nledger-gitter]/[matrix][#nledger_Lobby:gitter.im] | +| goledger | 2019 | | [go][goledger-gh] | 1 | 13 | | | +| [monescript] | 2017 | 2018-01 | [javascript][monescript-gh] | 1 | 12 | | | +| blossom | 2020 | | [F#][blossom-gh] | 1 | 12 | | | +| [Tackler] | 2017 | 2021-01 | [scala][tackler-gl] | 1 | 6 | | [gitter][tackler-gitter]/[matrix][#E257-FI_tackler:gitter.im] | +| acc | 2020 | | [rust][acc-gh] | 1 | 1 | | | +| bankroll | 2020 | 2020-08 | [rust][bankroll-gl] | 2 | 1 | | | +| [ledg] | 2021 | 2021-04 | [javascript][ledg] | 1 | | | | +| [pta] | 2020 | 2020-09 | perl | 1 | | | | +| [Prudent] | 2018 | | js (closed; [addons][prudent-gh]) | 1 | | | [\@PrudentLedger][prudent-chat] | +| knut | 2020 | | [go][knut-gh] | 1 | | | | +|   | | | | | | | | +| **Inactive:** | | | | | | | | +| [beans] | 2019 | 2019 | [haskell][beans-gh] | | | | | +| uledger | 2015 | | [python][uledger-gh] | | | | | +| pacioli | 2013 | | [python][pacioli-gh] | | | | | +| ledger.pl | 2013 | | [perl][ledger.pl-gh] | | | | | +| Penny | 2012 | 2014 | [haskell][penny-gh] | | | | | +| UMM | 2009 | 2010 | [haskell][UMM-hackage] | | | | | +| sm-Ledger | 2007 | | [squeak smalltalk][smalltalk-gh] | | | | | +|   | | | | | | | | +| **See also:** | | | | | | | | +| [plaintextaccounting.org] | | | | | | | [matrix][#plaintextaccounting:matrix.org]/[irc][#plaintextaccounting:libera.chat] 90 | +| | | | | | | | [/r/plaintextaccounting] 2800 | + +[plaintextaccounting.org]: https://plaintextaccounting.org +[/r/plaintextaccounting]: https://www.reddit.com/r/plaintextaccounting +[#plaintextaccounting:libera.chat]: https://web.libera.chat/#plaintextaccounting +[#plaintextaccounting:matrix.org]: https://matrix.to/#/#plaintextaccounting:matrix.org + +[abandon-gh]: https://github.com/hrj/abandon +[abandon-gitter]: https://gitter.im/hrj/abandon +[#hrj_abandon:gitter.im]: https://matrix.to/#/#hrj_abandon:gitter.im + +[acc-gh]: https://github.com/rudolfschmidt/acc + +[Beancount]: https://github.com/beancount/ +[Beancount2]: https://beancount.github.io +[beancount-gh]: https://github.com/beancount/beancount/ +[beancount-mail]: https://groups.google.com/forum/#!forum/beancount +[#beancount:libera.chat]: https://web.libera.chat/#beancount + +[beancount-fava-gitter]: https://gitter.im/beancount/fava +[#beancount_fava:gitter.im]: https://gitter.im/beancount/fava + +[beans]: https://sboehler.github.io/beans +[beans-gh]: https://github.com/sboehler/beans + +[blossom-gh]: https://github.com/blossom-hub/blossom + +[cl-ledger-gh]: https://github.com/ledger/cl-ledger + +[goledger-gh]: https://github.com/mescanne/goledger + +[hledger]: https://hledger.org +[hledger-gh]: https://github.com/simonmichael/hledger +[hledger-code]: http://code.hledger.org +[hledger-mail]: http://mail.hledger.org/ +[#hledger:matrix.org]: https://matrix.to/#/#hledger:matrix.org +[#hledger:libera.chat]: https://web.libera.chat/#hledger + +[knut-gh]: https://github.com/sboehler/knut + +[Ledger]: https://www.ledger-cli.org +[ledger-gh]: https://github.com/ledger/ledger +[#ledger:libera.chat]: https://web.libera.chat/#ledger +[ledger-mail]: http://list.ledger-cli.org/ + +[ledger-in-go-gh]: https://github.com/howeyc/ledger + +[ledger.pl-gh]: https://github.com/dimonf/ledger.pl + +[monescript]: https://monescript.github.io/ +[monescript-gh]: https://github.com/monescript/monescript + +[nledger-gh]: https://github.com/dmitry-merzlyakov/nledger +[nledger-gitter]: https://gitter.im/nledger/lobby +[#nledger_Lobby:gitter.im]: https://matrix.to/#/#nledger_Lobby:gitter.im + +[pacioli-gh]: https://github.com/mdipierro/pacioli + +[penny-gh]: https://github.com/massysett/penny + +[pta]: https://mandoc.bsd.lv/pta + +[prudent]: https://prudent.me +[prudent-gh]: https://github.com/PrudentMe +[prudent-chat]: https://twitter.com/PrudentLedger + +[rust_ledger-gh]: https://github.com/ebcrowder/rust_ledger + +[bankroll-gl]: https://gitlab.com/dantuck/bankroll + +[smalltalk-gh]: https://gist.github.com/simonmichael/bb611dba654ccb1573e1 + +[Tackler]: https://tackler.e257.fi +[tackler-gl]: https://gitlab.com/e257/accounting/tackler +[tackler-gitter]: https://gitter.im/E257-FI/tackler +[#E257-FI_tackler:gitter.im]: https://matrix.to/#/#E257-FI_tackler:gitter.im + +[transity-gh]: https://github.com/feramhq/transity +[transity-gitter]: https://gitter.im/feramhq/transity +[transity-demo]: https://www.feram.io/transity +[#feramhq_transity:gitter.im]: https://matrix.to/#/#feramhq_transity:gitter.im + +[uledger-gh]: https://github.com/danpat/uledger + +[UMM-hackage]: http://hackage.haskell.org/package/UMM + +[ledg]: https://github.com/SitanHuang/ledg + + + +Next, related add-ons and helpers by category +(note: `*ledger` below means Ledger and hledger-style journal format): + +### data import/conversion + +- [Ledger](https://www.ledger-cli.org/3.0/doc/ledger3.html#Comma-Separated-Values-files) and [hledger](https://hledger.org/csv.html) have CSV conversion built in. Also: +- bean-identify, bean-extract, bean-file - Beancount built-in tools +- [banks2ledger](https://github.com/tomszilagyi/banks2ledger) - CSV to *ledger converter +- [beancount-import](https://github.com/jbms/beancount-import) web app/framework for converting various formats to beancount (python) +- [beancount-ynab](https://github.com/hoostus/beancount-ynab) You Need A Budget to beancount converter +- [buchhaltung](http://hackage.haskell.org/package/buchhaltung) CSV/FinTS/HBCI/OFX to *ledger conversion/deduplication (haskell) +- [csv2beancount](https://github.com/PaNaVTEC/csv2beancount) CSV to beancount converter (clojure) +- [CSV2Ledger](https://launchpad.net/csv2ledger) CSV to *ledger converter (perl) +- [fints2ledger](https://github.com/MoritzR/fints2ledger) FinTS/HBCI to csv to *ledger or beancount journals (python) +- [gcash2ledger.py](https://gist.github.com/nonducor/ddc97e787810d52d067206a592a35ea7/) GNUCash XML to *ledger converter (python) +- [gnucash-to-beancount](https://github.com/henriquebastos/gnucash-to-beancount/) GNUCash sqlite to beancount converter (python) +- [gnucash2ledger.py](https://github.com/MatzeB/pygnucash/blob/master/gnucash2ledger.py) GNUCash sqlite to *ledger converter (python) +- [grisbi2Ledger](https://github.com/Hawk777/grisbi2ledger) Grisbi to *ledger converter +- [hledger-import-dsl](https://github.com/hpdeifel/hledger-import-dsl) alternate, programmable CSV converter for hledger +- [hledger-to-influxdb](https://github.com/barrucadu/hledger-scripts#hledger-to-influxdb) hledger to InfluxDB converter (haskell) +- [hledger2beancount](https://github.com/tjroth/hledger2beancount) hledger to beancount converter (haskell) +- [homebank2ledger](https://github.com/chazmcgarvey/homebank2ledger) HomeBank to ledger and beancount converter (perl) +- [icsvledger](https://github.com/quentinsf/icsv2ledger) interactive CSV to *ledger converter (python) +- [into-ledger](https://github.com/manishrjain/into-ledger) CSV to *ledger converter +- [jali](https://git.darmstadt.ccc.de/jali/jali) downloader/importer to *ledger (python) +- [kmymoney2hledger](https://github.com/maridonkers/kmymoney2hledger) KMyMoney to *ledger converter (clojure) +- [kmymoney2ledgers](https://github.com/isabekov/kmymoney2ledgers) KMyMoney to *ledger/beancount converter (python) +- [kmymoney2ledgers.awk](https://github.com/isabekov/kmymoney2ledgers.awk) KMyMoney to *ledger/beancount converter (Awk) +- [ldgclip](https://gitlab.com/IanTwenty/ldgclip) import bank transactions via the clipboard with one click (bash/awk) +- [Ledger in Go](https://github.com/howeyc/ledger) has limport, a CSV to *ledger converter +- [ledger-autosync](https://gitlab.com/egh/ledger-autosync) OFX download, OFX to *ledger conversion, deduplication +- [ledger-guesser](https://github.com/j3k0/ledger-guesser) neural network for generating entries like past ones, can be used with ledger-autosync (javascript) +- [ledger-myexpenses](https://github.com/ony/ledger-myexpenses) MyExpenses android app sqlite db to *ledger conversion (python) +- [ledger-to-beancount](https://github.com/glasserc/ledger-to-beancount/) yet another simple ledger to beancount converter (python) +- [ledger-tutorials](https://github.com/tlvince/ledger-tutorials) convert Pete Keen's tutorials to ebook format +- [ledger2beancount.py](https://gist.github.com/travisdahlke/71152286b0a8826249fe) *ledger to beancount converter +- [ledger2beancount](https://github.com/beancount/ledger2beancount)/[beancount2ledger](https://github.com/beancount/beancount2ledger) the best converter between h/ledger and beancount formats (perl). +- [outofit](https://github.com/rcaputo/outofit) QuickBooks to *ledger converter +- [piecash](https://github.com/sdementen/piecash) GNUCash SQL to *ledger converter (python) +- [plaid2qif](https://github.com/ebridges/plaid2qif) Download transactions from plaid as QIF or CSV files +- [plaid2text](https://github.com/madhat2r/plaid2text) Plaid API to *ledger/beancount download/conversion +- [qb2ledger](https://gist.github.com/genegoykhman/3765100) QuickBooks General Journal CSV to *ledger converter +- [QIFtoLedger](https://github.com/Kolomona/QIFtoLedger) (Bank of America's) QIF to *ledger converter +- [reckon](https://github.com/cantino/reckon) smart interactive/non-interactive CSV to *ledger converter +- [slc](https://github.com/marvinpinto/slc) generates Ledger accounting entries, works with generic CSV files as well as the Stripe API +- [smart_importer](https://github.com/johannesjh/smart_importer) library for building smarter CSV to beancount/Fava converters +- [total_recall](https://github.com/eval/total_recall) CSV to *ledger converter +- [ynab-to-ledger](https://github.com/vermiceli/ynab-to-ledger) You Need A Budget (YNAB) to *ledger converter. Handles multiple currencies, multiple number formats, reconciliation, memos, transfers, and split transactions +- [ynab_to_ledger](https://github.com/pgr0ss/ynab_to_ledger) You Need A Budget to *ledger converter +- [Costflow](https://docs.costflow.io) convert one line message to beancount/*ledger format +- [Go Ledger parser](https://github.com/abourget/ledger) a parser and ledgerfmt, ledger2json, json2ledger tools (go) + +### price fetching + +- [bean-price](https://docs.google.com/document/d/1thYRAMell_QT1Da1F_laprSs6BlROZjyK_h3V8qHW9c) Beancount's price fetching tool (python) +- [hledger-stockquotes](https://github.com/prikhi/hledger-stockquotes) download market prices for your hledger commodities (haskell) +- [ledger-get-prices](https://github.com/nathankot/ledger-get-prices) download market prices (ruby) +- [LedgerStockUpdate](https://github.com/adchari/LedgerStockUpdate) update a Ledger price database (go) +- [market-prices](https://github.com/barrucadu/hledger-scripts#market-prices) download market prices from several sources (python) +- [market-prices.hs](https://gist.github.com/maralorn/a288329af50955dff353e5529f377488) small, easy to adapt script to scrape market data from the internet (Haskell) +- [pricehist](https://gitlab.com/chrisberkhout/pricehist) fetch and format historical price data, with support for multiple sources and output formats (python) +- [the-solipsist/scripts](https://github.com/the-solipsist/scripts/) download prices for your hledger commodities, including indian commodities (bash) +- [update-hledger-market-prices.hs](https://github.com/cdepillabout/docs/blob/master/code/update-hledger-market-prices.hs) download market prices (haskell) + +### data generation + +- [beancount-extract-price](https://github.com/Mayeu/beancount-scripts) generate prices transactions based on your beancount ledger (python) +- [DepreciateForLedger](https://github.com/tazzben/DepreciateForLedger) generate *ledger depreciation transactions (python) +- [hledger-interest](http://hackage.haskell.org/package/hledger-interest) generate *ledger interest entries (haskell) +- [ledgerbil](https://github.com/scarpent/ledgerbil) schedule recurring txns, interactive reconcile, date sorting +- [LedgerScheduler](https://github.com/tazzben/LedgerScheduler) move entries from one file to another when they come due (python) +- [lotter](https://src.d10.dev/lotter) generate postings for capital gain/loss (go) +- [recurring](http://hub.darcs.net/simon/ledgertools/browse/recurring) generate recurring *ledger entries (python) +- [reorder-journal.sh](https://github.com/amitaibu/hledger-example/blob/master/reorder-journal.sh) sort hledger entries, preserving directives/comments at top of file (bash) +- [sassetti](https://github.com/jvasile/sassetti) adds lisp macros to ledger files (common lisp) + +### reports + +- [budget_report](https://github.com/sulemankm/budget_report) budget reporting with beancount (python) +- [hledger-diff](http://hackage.haskell.org/package/hledger-diff) report differing transactions between two journals (haskell) +- [hledger-irr](http://hackage.haskell.org/package/hledger-irr) calculate an account's internal rate of return (superseded by [roi](https://hledger.org/hledger.html#roi)) (haskell) +- [hledger-vega](https://github.com/xitian9/hledger-vega) makes configurable [vega-lite](https://vega.github.io/vega-lite/) charts from hledger (shell) +- [hreports](https://pypi.org/project/hreports) customise hledger reports with templates and PDF output (python) +- [ledger-plot](https://github.com/Tagirijus/ledger-plot) interactive tool for making GNUplot charts from Ledger (python) +- [ledger-plots](https://github.com/esovetkin/ledger-plots) R package & script to make charts from Ledger (R) +- [ludget](https://pypi.org/project/ludget) generate charts from Ledger (python) +- [r-ledger](https://github.com/trevorld/r-ledger) an R package for reading and reporting on ledger/hledger/beancount files (R) +- [TaxingLots](https://framagit.org/jkepler/TaxingLots) calculates capital gains for a ledger journal (python) + +### time logging + +- [org2tc](https://github.com/jwiegley/org2tc) org to timeclock converter +- [on-modify.timetrack.py](https://gist.github.com/wbsch/d977b0ac29aa1dfa4437) taskwarrior hook for timeclock output +- [t](https://github.com/nuex/t) ledger timeclock shellscript +- [tim](https://github.com/MatthiasKauer/tim) time logging/reporting tool using hledger +- [timekeeping-template](https://github.com/bbarker/timekeeping-template) time logging/reporting examples/how-to using hledger +- [tito](https://mostlyabsurd.com/files/tito) time logging bash scripts that avoid double clock-in + +### UI, console + +- [bean-add](https://github.com/simon-v/bean-add) interactive transaction entry tool (python) +- [hledger add](https://hledger.org/hledger.html#add) interactive transaction entry tool (builtin command) +- [ladd](https://github.com/ninewise/dotfiles/blob/master/local/bin/ladd) create and edit a new *ledger transaction by fuzzy-matching past descriptions +- [ldgr](https://github.com/brandonpittman/ldgr) command line tool to add/sort/tag ledger files (ruby) +- [ledger xact](https://www.ledger-cli.org/3.0/doc/ledger3.html#xact) history-aware transaction generator (builtin command) + +### UI, curses + +- [hledger-iadd](https://github.com/hpdeifel/hledger-iadd) TUI for *ledger transaction entry (haskell) +- [hledger-ui](http://hackage.haskell.org/package/hledger-ui) TUI for *ledger browsing (haskell, [video](https://asciinema.org/a/29665)) +- [ledger-add](https://github.com/Tagirijus/ledger-add) TUI for *ledger transaction entry (python) +- [regdel](https://github.com/guillaumechereau/regdel) TUI for browsing Ledger files (python) + +### UI, GUI + +- [ledgerble](https://github.com/sbridges/ledgerble) reporting GUI with charts & adjustable reports (Javascript) +- [ledgerhelpers](https://github.com/Rudd-O/ledgerhelpers) misc. GUI tools + helper library (Python, GTK) +- [Prudent][prudent] integrated journal editing/importing/reporting GUI for Ledger (Javascript, mac only, closed source) + +### UI, web + +- [fava](https://github.com/beancount/fava) web UI for beancount browsing (python, [demo](http://fava.pythonanywhere.com/)) +- [hledger-web](http://hackage.haskell.org/package/hledger-web) web UI for *ledger browsing, data entry + (haskell, + [demo](http://demo.hledger.org), + [Sandstorm app](https://apps.sandstorm.io/app/8x12h6p0x0nrzk73hfq6zh2jxtgyzzcty7qsatkg7jfg2mzw5n90)) +- [Ledger in Go](https://github.com/howeyc/ledger) web UI for browsing ledger transactions, reports, and porfolios +- [Ledger Web](https://github.com/peterkeen/Ledger-Web) ledger HTML reporting system (ruby, postgres) +- [Ledger Web](https://vifon.github.io/ledger-web) web UI/API for ledger browsing, data entry (python) +- [ledger-analytics](https://github.com/kendricktan/ledger-analytics) web UI for ledger data analytics (javascript) +- [ledger-dashboard](https://github.com/Ikke/ledger-dashboard) web UI for ledger browsing, data entry (python) +- [ledger-pyreport](https://yingtongli.me/git/ledger-pyreport/about/) web UI for standard accounting statements and unrealised gains (python) +- [ledgeraccounting](https://github.com/thecount2a/ledgeraccounting) web UI for hledger: data entry, basic reports and budgets (javascript) +- [ledgible](https://github.com/lipidity/ledgible) web UI for ledger browsing, data entry (python) +- [node-ledger-web](https://github.com/slashdotdash/node-ledger-web) web UI for ledger browsing (javascript) +- [WealthPulse](https://github.com/readysetmark/WealthPulse) web UI for ledger browsing, price fetching (F#) + +### UI, mobile + +- [beancount-mobile](https://github.com/xuhcc/beancount-mobile) data entry app for beancount (Android, javascript) +- [cashier](https://gitlab.com/alensiljak/cashier) mobile or desktop client for ledger and hledger-web (Android/Desktop, javascript, [app](https://cashier.alensiljak.eu.org/)) +- [cone](https://f-droid.org/en/packages/info.tangential.cone/) data entry app for the h/ledger format (Android, [dart](https://github.com/bradyt/cone)) +- [MoLe](https://fossdroid.com/a/mole.html) mobile client for hledger-web (Android, [java](https://git.ktnx.net/?p=mobile-ledger.git)) + +### API + +- [gledger](https://github.com/gledger/gledger) Go package to interface with Ledger (go) +- [hledger-lib](https://github.com/simonmichael/hledger/tree/master/hledger-lib) library for parsing and generating reports from *ledger files (haskell) +- [hledger-web](https://github.com/simonmichael/hledger/tree/master/hledger-web) the web app includes a JSON API server for *ledger files (haskell) +- [ledgerhelpers](https://github.com/Rudd-O/ledgerhelpers) extends Ledger's python library (python) +- [node-hledger](https://github.com/rstacruz/node-hledger) Node.js API for *ledger files (javascript) + + + +### editor support + +Editor plugins. +Note these often work quite well for other ledger-likes, not just the one they are named for. + +
+
+##### Atom +
+ + [language-ledger](https://atom.io/packages/language-ledger), + [ledger](https://atom.io/packages/ledger) + +
+
+
+##### Emacs +
+ + [beancount-mode](https://bitbucket.org/blais/beancount/src/1e21b27c0b0ecf2bf2e1a2cd5c3da3b1befc8152/src/elisp/beancount.el?at=default&fileviewer=file-view-default), + [hledger-mode](https://github.com/narendraj9/hledger-mode), + [ledger-mode](https://www.ledger-cli.org/3.0/doc/ledger-mode.html) (also works for hledger, beancount etc.) + +
+
+
+##### nano +
+ + [scopatz/nanorc](https://github.com/scopatz/nanorc/blob/master/ledger.nanorc) + +
+
+
+##### Sublime +
+ + [sublime-ledger-syntax](https://github.com/moeffju/sublime-ledger-syntax) + +
+
+
+##### TextMate +
+ + [Ledger.tmbundle](https://github.com/lifepillar/Ledger.tmbundle) + +
+
+
+##### VIM +
+ + [vim-ledger](https://github.com/ledger/vim-ledger) (supports ledger & hledger), + [vim-beancount](https://github.com/nathangrigg/vim-beancount), + [hledger-vim](https://github.com/anekos/hledger-vim) + +
+
+
+##### VS Code +
+ + [hledger-vscode](https://github.com/mhansen/hledger-vscode), + [ledger](https://marketplace.visualstudio.com/items?itemName=mariosangiorgio.ledger), + [vscode-beancount](https://marketplace.visualstudio.com/items?itemName=Lencerf.beancount) +
+
+
+##### Jetbrains (IntelliJ) +
+ +[Ledger Plugin](https://plugins.jetbrains.com/plugin/15405-ledger-cli) + +
+ +
+ + + +## docs + +### general accounting + +- [hledger: Accounting](https://github.com/simonmichael/hledger/wiki/More%20docs#accounting) +- [Accounting for Dragons](http://podcastle.org/2009/10/09/pc-miniature-38-accounting-for-dragons) +- [Beancount: The Double-Entry Counting Method](https://docs.google.com/document/d/100tGcA4blh6KSXPRGCZpUlyxaRUwFHEvnz_k9DyZFn4) +- [Accounting for Computer Scientists](https://martin.kleppmann.com/2011/03/07/accounting-for-computer-scientists.html) + +### plain text accounting + + + +- [Ledger manuals](https://www.ledger-cli.org/docs.html) +- [Ledger wiki](https://github.com/ledger/ledger/wiki) +- [Ledger CLI cheatsheet](https://devhints.io/ledger) +- [hledger docs](https://hledger.org/) +- [Beancount docs](https://beancount.github.io/docs/) / [(google)](http://furius.ca/beancount/doc/index) / [(sphinx)](http://aumayr.github.io/beancount-docs-static/) +- [Beancount: Command-line Accounting in Context](https://docs.google.com/document/d/1e4Vz3wZB_8-ZcAwIFde8X5CjzKshE4-OXtVVHm4RQ8s) +- [Beancount: Syntax Cheatsheet](http://furius.ca/beancount/doc/cheatsheet) +- [Getting Started With Ledger](https://rolfschr.github.io/gswl-book/latest.html) +- [Plain Text Accounting Workshop](https://github.com/colindean/plaintextaccounting_workshop) +- [Program your Finances: Command-line Accounting](https://www.petekeen.net/keeping-finances-with-ledger) +- [Don’t Sink Your First Attempts at Plaintext Accounting](https://wiki.plaintextaccounting.org/Don't-Sink-Your-First-Attempts-at-Plaintext-Accounting) +- [Syntax Quick Reference for the Ledger-Likes](quickref/) + +### comparisons + +- [Matthias Kauer: Command Line Accounting – A look at the various ledger ports](http://www.matthiaskauer.com/2015/08/command-line-accounting-a-look-at-the-various-ledger-ports/) 2015 +- [Another Ledger user's perspective](https://groups.google.com/d/msg/beancount/QV4qgpFbtJ8/9fSgMw-XGC8J) 2015 +- [Beancount: A Comparison of Beancount and Ledger](https://docs.google.com/document/d/1dW2vIjaXVJAf9hr7GlZVe3fJOkM-MtlVjvCO1ZpNLmg) 2014 +- [ledger vs hledger vs beancount or how to choose the right cli client](https://groups.google.com/d/topic/ledger-cli/__yuMVjrOH0/discussion) 2014 +- [hledger: hledger & Ledger](https://hledger.org/faq.html#how-is-hledger-different-from-ledger) 2014, 2019 +- [Omari Norman: Why Penny](http://massysett.github.io/penny/why-penny.html) 2013 + + +### presentations + +- [Simon Michael: Inside hledger: an architectural tour and how-to](https://rawcdn.githack.com/simonmichael/hledger/4013a81af8dd2804c73ecac18fb3e7e4745a4275/doc/haskellerz/haskellerz.slidy.html) 2021 +- [Michael Lynch](https://decks.mtlynch.io/plaintext-acccounting/) 2021 +- [Andreas Pauley: Purely Functional Personal Finance](https://pauley.org.za/functional-finance-hledger/) 2018 +- [Ledger CLI Accounting for Geeks](http://blog.loadingdata.nl/accounting-for-geeks/) 2014 +- [Hacking Your Finances for Fun and Profit](http://matthewturland.com/slides/ledger-stats/) 2013 +- [Ledger and Text based Accounting](http://www.adamsinfoserv.com/AISTWiki/pub/AIS/Presentations/Ledger.pdf) 2009 + +### videos + +- [Simon Michael: Inside hledger: an architectural tour and how-to](https://www.youtube.com/watch?v=6PKmZSHxu0c) 2021 +- [hledger fan youtube channel](https://www.youtube.com/channel/UCZLxXTjOqLzq4z5Jy0AyWSQ) (short lessons) 2019 +- [Quiliro Ordóñez: ledger-mode lightning talk](https://archive.org/details/ledger-mode_EmacsConf2019) 2019 +- [Colin Dean: Plaintext Accounting with the ledger ecosystem](https://www.youtube.com/watch?v=FJtaM43PgXQ) 2017 +- [Colin Dean: Plain Text Accounting](https://www.youtube.com/watch?v=8r5Cp66k4PA) 2017 +- [Simon Michael: Hands-on with hledger](https://www.youtube.com/watch?v=H_CdGzLbc7A) 2016 +- [Austin Walker: Conquering Your Finances with Emacs and Ledger](https://www.youtube.com/watch?v=cjoCNRpLanY) 2016 +- [FLOSS Weekly 375: hledger](https://twit.tv/shows/floss-weekly/episodes/375) + ([youtube](https://www.youtube.com/watch?v=Xjl-wVJcYpE), + [3m overview](https://www.youtube.com/watch?v=qS2UcDV_lbs)) + 2016 +- [Evolution of ledger](https://www.youtube.com/watch?v=MGu1Bw2USQo) 2015 +- [Evolution of hledger](https://www.youtube.com/watch?v=dEADGr9dqow) 2015 +- [FLOSS Weekly 150: Ledger](https://twit.tv/shows/floss-weekly/episodes/150) + ([youtube](https://www.youtube.com/watch?v=TDqrrH-gTt0)) 2011 +- [Accounting course by Prof. Krug](https://www.youtube.com/playlist?list=PL259DBFA47F3B4761) 2011 +- [Khan Academy: Accounting and financial statements](https://www.khanacademy.org/economics-finance-domain/core-finance/accounting-and-financial-stateme) +- [David Mitchell: Personal Debts](https://www.youtube.com/watch?v=9zyp8RF-Fyw) + +## articles & blog posts + +### in 2021 + +- [Arsen Arsenović: Keeping track of finances from many places](https://www.aarsen.me/posts/2021-08-13-personal-finances-with-hledger.html) +- [Zoran Zaric: Budgeting for annual expenses with Hledger](http://rantsideasstuff.com/posts/2021/01/31-budgeting-for-annual-expenses-with-hledger/) +- [Samuel Walladge: Tracking capital gains with hledger](https://www.swalladge.net/archives/2021/01/30/hledger-tracking-capital-gains/) +- [Duarte O.Carmo: Hacking on my finances (Part 2: Beancount on Beanstalk)](https://duarteocarmo.com/blog/hacking-on-my-finances-part-2-beancount-on-beanstalk.html) + +### in 2020 + +- [Duarte O.Carmo: Hacking on my finances](https://duarteocarmo.com/blog/hacking-on-my-finances.html) +- [Conversations in Code: Episode 3 / Introduction to Plain Text Accounting](https://www.reddit.com/r/plaintextaccounting/comments/ivrbdu/announcing_a_new_podcast_fossopensource_related/) [podcast] +- [Peter Hogg: Reconciling Ledger](https://pig-monkey.com/2020/08/reconciling-ledger/) +- [Peter Hogg: Receipts and Ledger](https://pig-monkey.com/2020/08/receipts-ledger/) +- [Peter Hogg: Tracking Cash with Ledger](https://pig-monkey.com/2020/08/ledger-cash/) +- [Peter Hogg: Organizing Ledger](https://pig-monkey.com/2020/08/organizing-ledger/) +- [Mari Donkers: KMyMoney to HLedger conversion](https://photonsphere.org/posts-output/2020-05-31-kmymoney2hledger) +- [Charles Hoffman: Plain Text Accounting](http://xbrl.squarespace.com/journal/2020/5/5/plain-text-accounting.html) +- [Charles Hoffman: Fat Free Accounting: Ledger](http://xbrl.squarespace.com/journal/2020/5/4/fat-free-accounting-ledger.html) +- [Lee Yingtong Li: Using selenium to scrape/import bank transactions for ledger-cli](https://yingtongli.me/blog/2020/04/29/hbs-scrape.html) +- [Lee Yingtong Li: ledger-pyreport: Formal accounting reports for ledger-cli](https://yingtongli.me/blog/2020/03/31/ledger-pyreport.html) +- [Lee Yingtong Li: Incorrect accounting of unrealised gains in ledger-cli](https://yingtongli.me/blog/2020/03/31/ledger-gains.html) +- [Christian Egli: Quick and dirty PDF reports for Plain Text Accounting](https://egli.dev/posts/quick-and-dirty-pdf-reports-for-plain-text-accounting/) + +### in 2019 + +- [Lee Yingtong Li: FIFO inventory with ledger-cli](https://yingtongli.me/blog/2019/12/11/ledger-fifo.html) +- [Justin Kaipada: Managing Ledger for Humans](https://www.kaipada.com/post/managing-ledger-for-humans/) +- [Amitai Burstein: Why We Chose Plain Text Accounting with Hledger](https://www.gizra.com/content/plain-text-accounting-hledger) +- [Budgeting with ledger-cli while tracking used points](https://fransiska.github.io/ledger/2019/10/24/ledger-budget-point) +- [Pete Keen: Automatic Insurance](https://www.petekeen.net/automatic-insurance) +- [Pete Keen: Automatic Investing](https://www.petekeen.net/automatic-investing) +- [Pete Keen: Automatic Cash Management](https://www.petekeen.net/automatic-cash-management) +- [Pete Keen: Automatic Finances](https://www.petekeen.net/automatic-finances) +- [John Sullivan: Answering questions with accounting: Reimbursements](https://blog.johncs.com/posts/accounting-reimbursements.htm) + + + + + + +### in 2018 + +- [Felix Crux: Tracking Accounts Jointly and Separately](https://felixcrux.com/blog/ledger-practices-tracking-accounts-jointly-and-separately) +- [Pepijn Looije: Real World Ledger part 1: Weighing Eggs in Baskets](https://p.epij.nl/ledger-cli/accounting/2018/08/23/real-world-ledger-part-1/) +- [Zoran Zaric: Depreciation in Personal Finance with Hledger](http://rantsideasstuff.com/posts/2018/07/08-depreciation-in-personal-finance-with-hledger/) +- [Zoran Zaric: Tracking Investments in Lots with Hledger](http://rantsideasstuff.com/posts/2018/07/01-tracking-investments-in-lots-with-hledger/) +- [Michael Walker: Currency Conversion](https://memo.barrucadu.co.uk/currency-conversion.html) +- [LWN: Counting beans - and more - with Beancount](https://lwn.net/SubscriberLink/751874/a38128abb72e45c5/) +- [Michael Walker: Personal Finance](https://memo.barrucadu.co.uk/personal-finance.html) +- [Siddhant Goel: Managing Personal Finances using Python](https://sgoel.dev/posts/managing-personal-finances-using-python/) + +### in 2017 + +- [Michael Walker: I Need A Budget](https://www.barrucadu.co.uk/posts/etc/2017-12-16-i-need-a-budget.html) +- [Accounting for the simple minds with plain text accounting](https://dustri.org/b/accounting-for-the-simple-minds-with-plain-text-accounting.html) +- [S.M. Oliva: Inventory, Part I: Will It Probate?](https://clprobate.wordpress.com/2017/08/31/inventory-part-1-will-it-probate/) +- [S.M. Oliva: A Simple First Account](https://clprobate.wordpress.com/2017/07/30/a-simple-first-account/) +- [S.M. Oliva: The Basics of hledger](https://clprobate.wordpress.com/2017/07/30/the-basics-of-hledger) +- [S.M. Oliva: Introduction to Command Line Probate](https://clprobate.wordpress.com/2017/07/05/introduction-to-command-line-probate/) +- [LWN: Restarting the free accounting search](https://lwn.net/Articles/729088/) +- [Michael Walker: Visualise your finances with hledger, InfluxDB, and Grafana](https://www.barrucadu.co.uk/posts/etc/2017-05-18-visualise-your-finances-with-hledger-influxdb-grafana.html) +- [Brady Trainor: Hledger web](https://bradyt.com/2017/04/28/Hledger-web/) + +### in 2016 + +- [Felix Crux: Accrual vs. Cash Basis Accounting](https://felixcrux.com/blog/ledger-practices-accrual-vs-cash-basis-accounting) +- [bsilvereagle: Envelope Budgeting with ledger](https://frdmtoplay.com/envelope-budgeting-with-ledger) +- [Felix Crux: Tracking Reimbursable Expenses](https://felixcrux.com/blog/ledger-practices-tracking-reimbursable-expenses) +- [Felix Crux: Separate Your Journals](https://felixcrux.com/blog/ledger-practices-separate-your-journals) +- [Felix Crux: Reporting Special Events Separately From Regular Spending](https://felixcrux.com/blog/ledger-practices-reporting-special-events-separately) +- [Felix Crux: Create a .ledgerrc](https://felixcrux.com/blog/ledger-practices-create-a-ledgerrc) + ([Ledger Practices series](https://felixcrux.com/blog/ledger-practices)) +- [Marcin Borkowski: Ledger – virtual postings aka envelopes](http://mbork.pl/2016-07-18_Ledger_–_virtual_postings_aka_envelopes) +- [Karan Ahuja: Hledger Improvements Wishlist.](http://www.karanahuja.in/2016-05-17-Hledger-Improvements-Wishlist/) +- [Alex Johnstone: Managing my personal finances with beancount](https://alexjj.com/blog/2016/managing-my-personal-finances-with-beancount/) + +### in 2015 + +- [Pete Keen: Program Your Finances: Algorithmic Savings](https://www.petekeen.net/program-your-finances-algorithmic-savings) +- [Pete Keen: Program Your Finances: Envelope Budgeting](https://www.petekeen.net/program-your-finances-envelope-budgeting) +- [Stefano Rodighiero: hledger-dupes](http://stefanorodighiero.net/posts/2015-01-04-hledger-find-duplicate-accounts.html) + +### in 2014 + +- [Matthew Turland: Ledger basics and habits](http://matthewturland.com/2014/03/29/ledger-basics-and-habits/) + +### in 2013 + +- [Simon Michael: What is hledger?](http://joyful.com/blog/2013-10-20-what-is-hledger.html) +- [Simon Michael: More on ledger](http://joyful.com/blog/2013-10-19-more-on-ledger.html) +- [Simon Michael: Introducing hledger!](http://joyful.com/blog/2013-10-18-introducing-hledger.html) + +### in 2012 + +- [Joey Hess: hledger](http://joeyh.name/blog/entry/hledger) +- [Gene Goykhman: An Alternative to QuickBooks](http://goykhman.ca/gene/blog/2012/2012-09-23-an-alternative-to-quickbooks.html) +- [LWN: The accounting quest: Ledger](http://lwn.net/Articles/501681/) +- [Pete Keen: A Robust Reporting System for Ledger](https://www.petekeen.net/a-robust-reporting-system-for-ledger) + +### in 2011 + +- [Pete Keen: Program your Finances: Automated Transactions](https://www.petekeen.net/program-your-finances-automated-transactions) +- [Sascha Welter: Doing my own accounting](http://betabug.ch/blogs/ch-athens/1221) +- [Clint Adams: Accounting at SFLC](http://www.softwarefreedom.org/blog/2011/sep/07/accounting-at-sflc/) +- [Pete Keen: Program your Finances: Vacation Tracking](https://www.petekeen.net/program-your-finances-vacation-tracking) +- [Pete Keen: Program your Finances: Reporting for Fun and Profit](https://www.petekeen.net/program-your-finances-reporting-for-fun-and-profit) + +### in 2010 + +- [Pete Keen: Program your Finances: Command-line Accounting](https://www.petekeen.net/keeping-finances-with-ledger) +- [Christine Spang: [h]ledger rocks my world](http://blog.spang.cc/posts/hledger_rocks_my_world/) + + + + +### in 2009 + +- [советы: Ledger — бухучёт в командной строке](http://s.arboreus.com/2009/05/personal-accounting-in-command-line.html) ([english](http://translate.google.com/translate?hl=en&sl=ru&u=http://s.arboreus.com/2009/05/personal-accounting-in-command-line.html)) + +### in 2006 + +- [Joe Barr: Ledger, the bran muffin of accounting tools](https://www.linux.com/news/ledger-bran-muffin-accounting-tools) + + +## common tasks + +### choosing accounts + +- [sample chart of accounts for a freelancer](https://gist.github.com/simonmichael/9936299) +- [Beancount Cookbook: Account Naming Conventions](https://docs.google.com/document/d/1Tss0IEzEyAPuKSGeNsfNgb0BfiW2ZHyP5nCFBW1uWlk/view#heading=h.tu0f1kydrpgn) +- [Mint: Ways to Categorize Your Spending](https://www.mint.com/mint-categories) +- [Simplified version of double-entry bookkeeping for personal and business finance?](http://money.stackexchange.com/questions/47561/simplified-version-of-double-entry-bookkeeping-for-personal-and-business-finance) + +### choosing cash vs accrual + +- [Ledger Practices: Accrual vs. Cash Basis Accounting](https://felixcrux.com/blog/ledger-practices-accrual-vs-cash-basis-accounting) + +### entering data + +- [hledger Basics tutorial: Record a transaction with “hledger add”](https://hledger.org/basics-tutorial.html#record-a-transaction-with-hledger-add) +- ledger-mode:\ + `C-c C-a` add a transaction,\ + `C-c C-b` amount calculator,\ + `C-c C-c`/`C-c C-e` toggle cleared +- [Beancount: Command Line Accounting Cookbook](https://docs.google.com/document/d/1Tss0IEzEyAPuKSGeNsfNgb0BfiW2ZHyP5nCFBW1uWlk) +- [Accounting bookkeeping entries](https://github.com/simonmichael/hledger/wiki/more-docs#accounting) +- [ledger-envelope-generator.rb](https://github.com/simonmichael/hledger/issues/313) +- [Ledger Practices: Separate Your Journals](https://felixcrux.com/blog/ledger-practices-separate-your-journals) +- [UI tools](#ui-console) + +### importing + +- [Ledger: The convert command](http://www.ledger-cli.org/3.0/doc/ledger3.html#The-convert-command) +- [hledger: CSV format](https://hledger.org/csv.html) +- [hledger: Convert CSV files](https://hledger.org/convert-csv-files.html) +- [Beancount: Importing External Data in Beancount](https://docs.google.com/document/d/11EwQdujzEo2cxqaF5PgxCEZXWfKKQCYSMfdJowp_1S8) +- [Beancount: Prices in Beancount](https://docs.google.com/document/d/1thYRAMell_QT1Da1F_laprSs6BlROZjyK_h3V8qHW9c) +- [Payment matching done right](https://tomszilagyi.github.io/payment-matching/) +- ["Full-fledged hledger" tutorial](https://github.com/adept/full-fledged-hledger) +- ["Hledger Flow" tutorial/slideshow](https://github.com/apauley/hledger-flow) +- [import tools](#data-import) + +### reconciling + +- ledger-mode: `C-c C-r` +- [How to use ledger(1) to reconcile your chequebook with your bank statement](https://mumble.net/~campbell/2017/02/26/ledger/HOWTO-reconcile-cheques) +- [How to use ledger(1) to reconcile your payments with your payment processor](https://mumble.net/~campbell/2017/02/26/ledger/HOWTO-reconcile-payments) + +### reporting + +- [example queries for Beancount](http://aumayr.github.io/beancount-sql-queries/) +- [hledger Cookbook: Rewrite account names](https://github.com/simonmichael/hledger/wiki/Rewrite-account-names) +- [Report Scripts for Ledger CLI with Gnuplot](https://www.sundialdreams.com/report-scripts-for-ledger-cli-with-gnuplot/) +- [Full-fledged hledger tutorial](https://github.com/adept/full-fledged-hledger) +- [Ledger Practices: Reporting Special Events Separately From Regular Spending](https://felixcrux.com/blog/ledger-practices-reporting-special-events-separately) +- [Program your Finances: Reporting for Fun and Profit](https://www.petekeen.net/program-your-finances-reporting-for-fun-and-profit) +- [Pete Keen: A Robust Reporting System for Ledger](https://www.petekeen.net/a-robust-reporting-system-for-ledger) 2012 + +### budgeting + +*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** + +- [Ledger: Budgeting](http://www.ledger-cli.org/3.0/doc/ledger3.html#Budgeting) +- [hledger: Budget report](https://hledger.org/hledger.html#budget-report) +- [reddit: simple yearly budget example](https://www.reddit.com/r/plaintextaccounting/comments/e5sl1m/advice_on_projectionsforecasts/) +- [hledger: Budgeting and forecasting: Periodic budget](https://hledger.org/budgeting-and-forecasting.html#periodic-budget) +- [budget_report](https://github.com/sulemankm/budget_report) budget reporting with beancount + +**Envelope budgeting: pre-allocating funds** + +- [Jeremy Bush: hledger-envelope-budget](https://github.com/zombor/hledger-envelope-budget) ([discussion](https://www.reddit.com/r/plaintextaccounting/comments/r4ah79/envelope_budgeting_in_hledger_without_virtuals/)) +- [reddit: New blogpost: Budgeting for annual expenses with Hledger](https://www.reddit.com/r/plaintextaccounting/comments/l9aiup/new_blogpost_budgeting_for_annual_expenses_with/) +- [Michael Walker: Personal Finance](https://memo.barrucadu.co.uk/personal-finance.html) +- [Simon Michael: envelope budgeting example](https://gist.github.com/simonmichael/a1addcb652da4e78b183) +- [hledger: Budgeting and forecasting: Envelope budget](https://hledger.org/budgeting-and-forecasting.html#envelope-budget) +- [hledger envelope budgeting]() + +**Envelope budgeting with auto postings** + +- [fransiska: Budgeting with ledger-cli while tracking used points](https://fransiska.github.io/ledger/2019/10/24/ledger-budget-point) +- [Mykola Orliuk: Budgeting with hledger](https://gist.github.com/ony/bbec599c0893e676b772559909b81de6) +- [bsilvereagle: Envelope Budgeting with ledger](https://frdmtoplay.com/envelope-budgeting-with-ledger) +- [Marcin Borkowski: Ledger – virtual postings aka envelopes](http://mbork.pl/2016-07-18_Ledger_–_virtual_postings_aka_envelopes) +- [Pete Keen: Program Your Finances: Envelope Budgeting](https://www.petekeen.net/program-your-finances-envelope-budgeting) + +**Envelope budgeting with auto postings, org-mode and babel** + +- [Org tutorials: Weaving a budget with Org & ledger](http://orgmode.org/worg/org-tutorials/weaving-a-budget.html) +- [Alan Schmitt: Using Org for Ledger Reports and Budget](http://alan.petitepomme.net/tips/ledger_and_org.html) + +**More** + +- [hledger: annotated example budget journals](https://github.com/simonmichael/hledger/tree/master/examples/budgeting) +- [hledger: Budgeting](https://hledger.org/budgeting.html) + + +### forecasting + +- [Ledger: Forecasting](http://www.ledger-cli.org/3.0/doc/ledger3.html#Forecasting) + + +### invoicing + +- [invoicing entries](https://gist.github.com/simonmichael/986a65106a9db1f8bd68) +- [Ledger Practices: Tracking Reimbursable Expenses](https://felixcrux.com/blog/ledger-practices-tracking-reimbursable-expenses) + +### multiple currencies + +- [Peter Selinger: Tutorial on multiple currency accounting](http://www.mscs.dal.ca/~selinger/accounting/tutorial.html) +- [ledger-currencies tutorial](https://github.com/mikekchar/ledger-currencies) +- [Understanding the valuation function and the market function](https://groups.google.com/d/msg/ledger-cli/dc6F-HvZOyE/5IuoxzMOBwAJ) + +### trip expenses + +- [Program your Finances: Vacation Tracking](https://www.petekeen.net/program-your-finances-vacation-tracking) 2011 + +### shared expenses + +- [Beancount: Sharing Expenses in Beancount](https://docs.google.com/document/d/1FRcJqUfeAMQO6KjG94w6rF7VajMGJaFplmF1Wu0rCHY) +- [Keeping (financial) score with Ledger](http://sachachua.com/blog/2014/11/keeping-financial-score-ledger/) +- [Program Your Finances: Automated Transactions](https://www.petekeen.net/program-your-finances-automated-transactions) +- [How to keep control of shared expenses inside marriage?](http://money.stackexchange.com/questions/7101/how-to-keep-control-of-shared-expenses-inside-marriage) +- [How to use ledger(1) to split shared expenses](https://mumble.net/~campbell/2017/02/26/ledger/HOWTO-sharedexpense) +- [Ledger Practices: Tracking Accounts Jointly and Separately](https://felixcrux.com/blog/ledger-practices-tracking-accounts-jointly-and-separately) + +### taxes + +- [How to use ledger(1) to track US income taxes](https://mumble.net/~campbell/2017/08/06/ledger/HOWTO-track-tax) +- [Another Ledger user's perspective](https://groups.google.com/d/msg/beancount/QV4qgpFbtJ8/9fSgMw-XGC8J) 2015 + +### time tracking + +- [Ledger: Time Keeping](https://www.ledger-cli.org/3.0/doc/ledger3.html#Time-Keeping) +- [hledger: Timeclock format](https://hledger.org/hledger.html#timeclock-format) +- [hledger: Timedot format](https://hledger.org/hledger.html#timedot-format) +- [Timetracking and billing with (h)ledger](https://github.com/anarcat/ledger-timetracking) +- [hledger: Time planning](https://hledger.org/time-planning.html) +- [time tracking tools](#time-logging) +- [reddit: Ledger CLI time tracking and transaction account linking](https://www.reddit.com/r/plaintextaccounting/comments/e2sd0k/ledger_cli_time_tracking_and_transaction_account/) +- [arbeitszeit.py](https://github.com/haansn08/arbeitszeit.py) + +### inventory tracking + +- [Accounting Savvy for Business Owners ch. 8](http://www.amazon.com/Accounting-Savvy-Business-Owners-Essentials/dp/193292518X) + +### investing + +- [Beancount: Inventory Booking](https://docs.google.com/document/d/1F8IJ_7fMHZ75XFPocMokLxVZczAhrBRBVN9uMhQFCZ4), [discussion](https://groups.google.com/forum/#!searchin/ledger-cli/inventory/ledger-cli/aQvbjTZa7HE/x3KNPteJWPsJ) +- [hledger: Track investments](https://hledger.org/track-investments.html) +- [hledger: Track investments 2](https://hledger.org/investments.html) + +### non-profit accounting + +- [Non-Profit Accounting With Ledger CLI, A Tutorial](https://github.com/conservancy/npo-ledger-cli/blob/master/npo-ledger-cli-tutorial.md) + +### exporting + +- [Ledger: The csv command](http://www.ledger-cli.org/3.0/doc/ledger3.html#The-csv-command) +- [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 + +- [Ledger Practices: Create a .ledgerrc](https://felixcrux.com/blog/ledger-practices-create-a-ledgerrc) + +### API access + +- [Ledger: Extending with Python](https://www.ledger-cli.org/3.0/doc/ledger3.html#Extending-with-Python) +- [Ledger Python 3 Support](https://groups.google.com/forum/#!topic/ledger-cli/C99w-79Jq8o) Python +- [ledgerhelpers](https://github.com/Rudd-O/ledgerhelpers) Python +- [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) +- [hledger-web: JSON API](https://hledger.org/hledger-web.html#json-api) +- [node-hledger](https://github.com/rstacruz/node-hledger) JavaScript + + +
+ +
+ +
+\(c) 2016-2021 [Simon Michael](http://joyful.com) & contributors | +Send updates via [github](https://github.com/plaintextaccounting/plaintextaccounting) +([latest changes](https://github.com/plaintextaccounting/plaintextaccounting/commits/master)) + +
+