Awesome Hledger

Guides and tools for hledger.

Manage your finances using a plain text file

• Text Editor Tools
• TUI - Terminal User Interface to view, add and manage journal files
• GUI - Web, Desktop and Mobile user interfaces
• Add/Edit Transactions
• Import Transactions
• Report
• Price Fetching
• Guides, Tutorial and Blog Posts
• Videos
• Related Tools
• Community

Since hledger is based on a plain text journal file, a text editor is the main tool to edit transactions. These extensions can be added to the text editors to make life easier as explained here.

• Emacs ledger-mode - Most used and maintained helper mode for hledger and Ledger files, but not 100% compatible with hledger.
• Emacs hledger-mode - An alternative to ledger-mode, written specifically for hledger. Has some different features.
• Emacs flycheck-hledger - Provides realtime indication of problems in your journal. Can be combined with ledger-mode or hledger-mode.
• Vim vim-ledger - Vim plugin compatible with ledger and hledger.
• Vim hledger-vim - Alternative to vim-ledger.
• Vim timedot-vim - timedot-vim is a vim-plugin to enhance working with hledger timedot files.
• VS Code hledger-vscode - Language support for hledger in VS Code

Interactive apps on terminal to navigate the transactions using menus, dialogs and reports without the need to use multiple command-line options.

• hledger-ui - Official terminal interface for hledger.
• puffin - A bubbletea based TUI to manage personal finances using hledger

Beautiful and graphical applications to manage journal files

• hledger-web - Official web interface for hledger.
• MoLe - Android front end to hledger-web

Even complex transactions become simple and convenient to add with these tools.

• hledger add - Official interactive command-line tool to add transactions.
• hledger-iadd - Very convenient tool to add transactions to hledger journal.
• hledger-edit - Edit hledger transactions in your $EDITOR limited to the result of a query.
• hledger-lots - Add transactions involving buying and selling commodities with prices to for automatic lot management.
• obsidian_hledger - Add transactions using Obsidian.

Bring transactions from other sources to hledger's format.

• hledger (Built-in) - Built-in hledger's command to convert csv files.
• hledger-flow - Guided hledger workflow to import transactions.
• ledger-autosync - Import OFX file to hledger.
• invoice2data - Import transactions from pdf invoices.

The ultimate reason to maintain a journal file is to extract information. Use these tools to process and visualize the data.

• hledger-plot - Plot chart of hledger queries.
• hledger-args - replacement for hledger command file using custom directives inside the journal file. Also provides an interactive report with placeholders to generate prompts.
• hledger2psql - Export a hledger journal file to a postgresql database to be used in data visualization software. Included docker-compose file for Apache Superset.
• hledger-lots - View financial indicator including market price, profit and XIRR for one commodity or all commodities in a tabular form.
• hledger-forecast - Use a CSV or Yaml file for easier forecasting with hledger. Adds functionality for future cost rises (e.g. inflation) and the automatic tracking of planned transactions.

• pricehist - Download price history from multiple sources and output to multiple formats, including hledger price directive.
• hledger-stockquotes - Read your journal and and try to download price directives for all non USD declared commodities.
• hledger-lots - Create automatic lots without subaccounts and tags and download prices from declared accounts in the journal with a specific tag

• contrib-resources - Place with resources about hledger in /awesome-hledger/ where any user can contribute with tutorials, articles, tips, etc.
• gizra.com - Great introduction to hledger.
• Barracudo Blog Post - Lengthy discussion of a hledger personal usage.
• functional-finance-hledger - Slides on a hledger workflow based on importing csv files
• hledger github topic - Github topics page for hledger.
• hledgerfans - Blog posts about hledger.

• Inside hledger - Discussion of the source code with a general discussion about hledger.
• Floss Weekly - General discussion about hledger.
• Glenn Ramsey - Introduction to hledger focused on invoice generation and csv import.

These tools are not made for hledger, but they provide import features to maintain journal files.

• Tabula - Extract data from tables in a pdf file to import to hledger.
• csvkit - Convert to csv and do operating like cut, grep, sort, join, stack, etc.
• GNU Make - Set multiple conversions, import and other operations for you ledger files.
• watchexec - Automatically run a hledger command when the journal changes. Available in most linux distributions.
• entr - Alternative to watchexec

Places to ask question about hledger and accounting in general

• contrib-resources - Place with resources about hledger in /awesome-hledger/ where any user can contribute with tutorials, articles, tips, etc.
• Reddit - Plain Text Accounting with hledger and others ledger-like software.
• Matrix Chat - Matrix Chat room using element chat client.
• Libera IRC - Same chat room as the matrix, but using IRC.

Contributions of any kind welcome, just follow the guidelines!

Thanks goes to these contributors!