Plain Text Accounting, a guide to Ledger and friends

http://plaintextaccounting.org/

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.

Welcome! This site together with wiki.plaintextaccounting.org is an entry point to the PTA community's tools, docs and practices. It is maintained by Simon Michael (hledger project leader, Ledger contributor, PTA fan) and contributors like you. Updates are helpful; join the chat or send an edit.

Overview: 2022-06: FAQs and Common Tasks links have moved to the wiki.

About ... Newcomer FAQ ... Objections and Concerns ... Getting started FAQ Tools ... PTA apps ... Editor plugins ... Data import/conversion ... Price fetching ... Data generation ... Reporting ... Time logging ... UI, console ... UI, curses ... UI, GUI ... UI, web ... UI, mobile ... API Docs ... Accounting ... Plain Text Accounting ... Wiki/Cookbook Videos ... Articles & blog posts ... News & discussion ...

PTA apps

To do Plain Text Accounting, choose one of the apps below. Generally it's relatively easy to migrate data from one to another.

Editor plugins

Helpers which make your text editor or IDE more aware of PTA apps and file formats. These often also work well for PTA apps other than the one they are named for.

Atom language-ledger, ledger Emacs beancount-mode, hledger-mode, ledger-mode IntelliJ Ledger Plugin Nano scopatz/nanorc Sublime sublime-ledger-syntax TextMate Ledger.tmbundle VIM vim-ledger, vim-beancount, hledger-vim, cmp-beancount VS Code hledger-vscode, ledger, vscode-beancount

Data import/conversion

Additional helper tools complementing the PTA apps, by category.

  • Ledger and hledger have CSV conversion built in. Also:
  • bean-identify, bean-extract, bean-file - Beancount built-in tools
  • banks2ledger - CSV to *ledger converter
  • beancount-import web app/framework for converting various formats to beancount (python)
  • beancount-ynab Import YNAB4 (legacy desktop-based version) into beancount
  • beancount-ynab5 Import YNAB5 (cloud-based version) transactions into beancount
  • buchhaltung CSV/FinTS/HBCI/OFX to *ledger conversion/deduplication (haskell)
  • Costflow convert one line message to beancount/*ledger format
  • csv2beancount CSV to beancount converter (clojure)
  • CSV2Ledger CSV to *ledger converter (perl)
  • double-entry-generator Rule-based double-entry bookkeeping importer (from Alipay/WeChat/Huobi etc. to Beancount)
  • fints2ledger FinTS/HBCI to csv to *ledger or beancount journals (python)
  • gcash2ledger.py GNUCash XML to *ledger converter (python)
  • gnucash-to-beancount GNUCash sqlite to beancount converter (python)
  • gnucash2ledger.py GNUCash sqlite to *ledger converter (python)
  • grisbi2Ledger Grisbi to *ledger converter
  • hledger-import-dsl alternate, programmable CSV converter for hledger
  • hledger-to-influxdb hledger to InfluxDB converter (haskell)
  • hledger2beancount hledger to beancount converter (haskell)
  • homebank2ledger HomeBank to ledger and beancount converter (perl)
  • icsvledger interactive CSV to *ledger converter (python)
  • into-ledger CSV to *ledger converter
  • invoice2data extract data from PDF invoices (python)
  • jali downloader/importer to *ledger (python)
  • kmymoney2hledger KMyMoney to *ledger converter (clojure)
  • kmymoney2ledgers KMyMoney to *ledger/beancount converter (python)
  • kmymoney2ledgers.awk KMyMoney to *ledger/beancount converter (Awk)
  • ldgclip import bank transactions via the clipboard with one click (bash/awk)
  • Ledger in Go has limport, a CSV to *ledger converter
  • ledger-autosync OFX download, OFX to *ledger conversion, deduplication
  • ledger-guesser neural network for generating entries like past ones, can be used with ledger-autosync (javascript)
  • ledger-myexpenses MyExpenses android app sqlite db to *ledger conversion (python)
  • ledger-to-beancount yet another simple ledger to beancount converter (python)
  • ledger-tutorials convert Pete Keen's tutorials to ebook format
  • ledger2beancount.py *ledger to beancount converter
  • ledger2beancount/beancount2ledger the best converter between h/ledger and beancount formats (perl).
  • moneymoney-ledger MoneyMoney export extension for *ledger
  • outofit QuickBooks to *ledger converter
  • piecash GNUCash SQL to *ledger converter (python)
  • plaid2qif Download transactions from plaid as QIF or CSV files
  • plaid2text Plaid API to *ledger/beancount download/conversion
  • qb2ledger QuickBooks General Journal CSV to *ledger converter
  • QIFtoLedger (Bank of America's) QIF to *ledger converter
  • reckon smart interactive/non-interactive CSV to *ledger converter
  • slc generates Ledger accounting entries, works with generic CSV files as well as the Stripe API
  • smart_importer library for building smarter CSV to beancount/Fava converters
  • total_recall CSV to *ledger converter
  • 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 You Need A Budget to *ledger converter

Price fetching

Data generation

  • beancount-extract-price generate prices transactions based on your beancount ledger (python)
  • DepreciateForLedger generate *ledger depreciation transactions (python)
  • hledger-interest generate *ledger interest entries (haskell)
  • ledgerbil schedule recurring txns, interactive reconcile, date sorting
  • LedgerScheduler move entries from one file to another when they come due (python)
  • lotter generate postings for capital gain/loss (go)
  • recurring generate recurring *ledger entries (python)
  • reorder-journal.sh sort hledger entries, preserving directives/comments at top of file (bash)
  • sassetti adds lisp macros to ledger files (common lisp)

Reporting

  • budget_report budget reporting with beancount (python)
  • hledger-diff report differing transactions between two journals (haskell)
  • hledger-irr calculate an account's internal rate of return (superseded by roi) (haskell)
  • hledger-sankey Script + HTML files to plot income next to expense money flows from an hledger ledger file (shell + javascript)
  • hledger-vega makes configurable vega-lite charts from hledger (shell)
  • hreports customise hledger reports with templates and PDF output (python)
  • ledger-plot interactive tool for making GNUplot charts from Ledger (python)
  • ledger-plots R package & script to make charts from Ledger (R)
  • ludget generate charts from Ledger (python)
  • r-ledger an R package for reading and reporting on ledger/hledger/beancount files (R)
  • TaxingLots calculates capital gains for a ledger journal (python)

Time logging

  • org2tc org to timeclock converter
  • on-modify.timetrack.py taskwarrior hook for timeclock output
  • t ledger timeclock shellscript
  • tim time logging/reporting tool using hledger
  • timekeeping-template time logging/reporting examples/how-to using hledger
  • tito time logging bash scripts that avoid double clock-in

UI, console

  • bean-add interactive transaction entry tool (python)
  • hledger add interactive transaction entry tool (builtin command)
  • ladd create and edit a new *ledger transaction by fuzzy-matching past descriptions
  • ldgr command line tool to add/sort/tag ledger files (ruby)
  • ledger xact history-aware transaction generator (builtin command)

UI, curses

UI, GUI

  • ledgerble reporting GUI with charts & adjustable reports (Javascript)
  • ledgerhelpers misc. GUI tools + helper library (Python, GTK)
  • Prudent integrated journal editing/importing/reporting GUI for Ledger (Javascript, mac only, closed source)

UI, web

UI, mobile

API

  • gledger Go package to interface with Ledger (go)
  • hledger-lib library for parsing and generating reports from *ledger files (haskell)
  • hledger-web the web app includes a JSON API server for *ledger files (haskell)
  • ledgerhelpers extends Ledger's python library (python)
  • node-hledger Node.js API for *ledger files (javascript)

Docs

Accounting

Plain Text Accounting

PTA app official docs

Ledger | hledger | Beancount | Ledger in Go | Tackler | pta

PTA app comparisons

Cheatsheets

Introductory docs

Presentations

Wiki/Cookbook

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 2006

News & discussion

Chat Matrix or IRC (bridged), app-specific chats Mail lists app-specific mail lists Twitter #plaintextaccounting, #ledgercli, #hledger, #beancount, @LedgerTips Reddit /r/plaintextaccounting Hacker News stories, comments Stack Exchange [ledger-cli], "ledger-cli", [hledger], "hledger"

(c) 2016-2022 Simon Michael & contributors | Send updates via github (latest changes)

Published

in bookmarks

Tagged

© 2010 - 2024 Daniel Nitsikopoulos. All rights reserved.

🕸💍  →