Skip to content

edkedk99/awesome-hledger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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!