/awesome-hledger

Guides and Tools for hledger

OtherNOASSERTION

Awesome Hledger Awesome

Guides and tools for hledger.

Manage your finances using a plain text file

Table of Content

Text Editor Tools

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

TUI - Terminal User Interface to view, add and manage journal files

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

GUI - Web, Desktop and Mobile user interfaces

Beautiful and graphical applications to manage journal files

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

Add/Edit Transactions

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.

Import Transactions

Bring transactions from other sources to hledger's format.

Report

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.

Price Fetching

  • 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

Guides, Tutorial and Blog Posts

Videos

  • 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.

Related Tools

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

Community

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.

Contributing

Contributions of any kind welcome, just follow the guidelines!

Contributors

Thanks goes to these contributors!