#hledger — Public Fediverse posts

Hi @simonmic,
thanks for clarifying, so cleaned up, without header and simpler names.

Just the + sign with liabilities:vat looks odd:

; I am renting out for a monthly fee, receive payments and owe the VAT to the tax authorities.

2026-04-01 rent april per contract
assets:receivable:customer 20 €
equity:customer

2026-04-03 rent april payment
assets:bank:customer 20 €
assets:receivable:customer

2026-04-08 rent april billing/tax
assets:bank:customer -20 €
liabilities:vat:customer 3,19 €
revenues:customer 18,81 €

; #hledger #plaintextaccounting

Five years ago, I received a 100$ regression bounty pretty much by accident for reporting a regression in #hledger [1] (what an amazing concept and stability commitment!). I decided to spread that back as issue bounties to feed into the community [2]. Those often sat there for years, humans take time.

That was before the slop era.

Now, AI bountyhunters want it, so I changed my terms to 100% human work [3].

[1] https://github.com/simonmichael/hledger/issues/1638#issuecomment-892386220
[2] https://github.com/simonmichael/hledger/issues?q=bounty%20author%3Anobodyinperson
[3] https://github.com/simonmichael/hledger/issues?q=bounty%20human%20author%3Anobodyinperson

#fedihelp wanted for #hledger #plaintextaccounting: when I sell a product to a customer, does accountng like that make sense or would you do otherwise?

; https://hledger.org/5-minute-quick-start.html#:~:text=type
account assets:bank ; type:C
account assets:cash ; type:C

account equity:conversion ; type:V

commodity 1.000,00 €
decimal-mark ,

account tax:e25:eue:42 ; type:L ; VAT 19%
account tax:e25:eue:12 ; type:R ; buniness revenue net

2026-05-10 rent may sale
liabilities:busi:prod_a:cust_23 23 €
equity:busi:prod_a:cust_23

2026-05-11 rent may payment
asset:bank:giro:busi:prod_a:cust_23 23 €
liabilities:busi:prod_a:cust_23

2026-05-12 rent may billing/tax
asset:bank:giro:busi:prod_a:cust_23 -23 €
tax:e25:eue:42:busi:prod_a:cust_23 3,67 €
tax:e25:eue:12:busi:prod_a:cust_23

G'day all. I'm pleased to announce hledger 2.0 preview release 2, with many refinements to lot tracking, based on user testing.

(And also hledger 1.52.1, which adds hledger 2-compatible G and U account types to hledger 1.)

- https://github.com/simonmichael/hledger/releases/tag/1.99.2
- https://hledger.org/relnotes.html#2026-04-28-hledger-1992
- https://hledger.org/install

Release contributors: Simon Michael, Joshua Chapman.

#hledger #plaintextaccounting

G'day all. A poll:

Should hledger 2 always infer market prices from @/@@ transacted prices, like Ledger ? (and drop the --infer-market-prices flag)

- Yes, having this always on would be harmless and more useful
- No, having it always on, or changing it, would be harmful
- Other, see my reply

Or vote in the matrix poll: https://matrix.to/#/!6BCfAOV-btRKuqChph9Z_ppkIj8KttMoIL_rB4eU0Os/$JveSoLuLOWS_Mg10JDUJKnu33RAclZML03JQ4Lp46qY?via=asgard.chat&via=matrix.org&via=tchncs.de

#hledger #plaintextaccounting

Glad it has helped you! A few things that might help:
- other rust projects linked at plaintextaccounting.org
- https://hledger.org/SPEC-journal.html
- https://hledger.org/hledger.html#amounts (manual is a kind of spec)
- amountp and friends in Hledger.Read.Common

#hledger #plaintextaccounting #haskell

@happyborg Sure, here's a few examples of people leveraging #hledger in their AI use:

https://forum.plaintextaccounting.org/tag/ai/12

https://x.com/CookResearcher/status/2032247670903828596

https://x.com/sudo_goreng/status/2036789525616414970

https://x.com/motdotla/status/2029247616828276838

https://x.com/gerold_ha/status/2037917692225532083

https://x.com/kenrickbeckett/status/2020538339292545458

Thanks all, for your comments re my explorations of #AI use in developing #hledger. I probably won't be able to respond in every case, but all civil inputs will be read and considered and are much appreciated.

I'm pleased to announce a #hledger double release! First, hledger 1.52, with

more robust paging,
faster valuation,
commodity tags,
and cost basis annotations which are preserved and can be exported (examples provided).

- https://github.com/simonmichael/hledger/releases/1.52
- https://hledger.org/relnotes.html#2026-03-20-hledger-152
- https://hledger.org/install

#plaintextaccounting #haskell

@Bebef ahso - ich verwende client-seitig kein Excel oder ähnliches.
Hab eine selbstgebaute Pipeline, welche mit Hilfe von "mlr" die exportierten CSVs normalisiert und dann basierend auf teils generierten, teils manuell definierten Regeln mit "hledger import..." meine Journals generiert.

Ich sehe also die CSVs im plain-text.

#hledger #plaintextaccounting #miller

Support question for the #hledger #plaintextaccounting community:

Prefacing this by acknowledging that I know I'm probably trying to do something weird, but I’m just getting started so please be patient.

I’m trying to import a large CSV file and am running into unbalance transaction errors. For example:
> hledger: Error: /Users/cris/checking.csv:1751-1750:
> 1751 | 2025-03-21 Starting Balance
> | SBA $-100
>
> This transaction is unbalanced.
> The real postings' sum should be 0 but is: $-100

The line from the CSV file is:
> SBA,,03/21/2025,Starting Balance,,,,,$100,$0.00,Cleared

And the relevant rule from my import rules:
> fields account1, , date, description, , , account2, comment, amount-out, amount-in,

I can manually add the above transaction without issues, so I guess I need some clarity as to what I'm doing wrong with my import file.

Thanks!

Me! 👋

Don't Skip The Docs.
For emacs tips, start at https://hledger.org/editors.html#emacs.

Don't assume you need hledger-mode (ledger-mode also works well, I use it).

With flycheck-hledger (or a VCS precommit hook), don't feel you need maximal error checking - do what's most useful now, you can always do stricter checks manually.

Don't try for perfect accounts/files/workflow up front - expect evolution.

Don't limit yourself with an ancient hledger version - get the latest.

#hledger #plaintextaccounting

Who here uses Hledger for Emacs? What's the best way to get started and more importantly what should I NOT try to do? #emacs #hledger

GitHub - juev/hledger-lsp: Language Server Protocol (LSP) implementation for hledger journal files https://github.com/juev/hledger-lsp

Thanks to your requests, a number of problems in the #hledger lsp server have been solved. The new version is much better. Thank you!

Having grown accustomed to "yank name" and "yank path" in #ranger, I find myself wishing this behavior were available in #hledger (hledger-ui), too! ;)

Having grown accustomed to "yank name" and "yank path" in #ranger, I find myself wishing this behavior were available in #hledger (hledger-ui), too! ;)

@platymew @msdropbear42 Oh I'd love to make videos about #hledger and #plaintextAccounting, has been on my TODO list for a long time, but I just have to prioritise other stuff. But I'll get there eventually 👍

If you are a user of my HLedger Formatter VSCode extension, you might like my just-released `hledger-fmt` CLI tool! It allows you to do the same format/sort as you can with the VSCode extension, but in your CLI. I am using this a lot in my codex skills to keep the journals consistently formatted.

https://www.npmjs.com/package/@iiatlas/hledger-fmt

https://github.com/iiAtlas/hledger-formatter/blob/main/packages/cli/README.md

#hledger #plaintextaccounting #opensource

After bouncing around ideas and several experiments, I've decided to launch a new project with the goal of creating CLI tooling that facilitates receipt handling for #plaintextaccounting workflows. LLM based OCR and data extraction has improved to the point that I believe it will be possible to make bulk data extraction useful. If you have ideas, want to contribute, or just want to follow along jump in:

https://codeberg.org/plaintextaccounting/acceptarium

#hledger #ledgercli #beancount #llm #ocr

@nobodyinperson I'm asking you first because involving #gitannex would be high on my priority list. Really this wouldn't need to be #hledger specific as it could just as well be paired with #ledgercli or #beancount either directly or via CSV or whatever. I'm not a huge GitLab fan these days but can do it if you prefer. Codeberg seems more aligned or GitHub having the advantage of contributor pool. Thoughts?

@nobodyinperson I'm asking you first because involving #gitannex would be high on my priority list. Really this wouldn't need to be #hledger specific as it could just as well be paired with #ledgercli or #beancount either directly or via CSV or whatever. I'm not a huge GitLab fan these days but can do it if you prefer. Codeberg seems more aligned or GitHub having the advantage of contributor pool. Thoughts?

@nobodyinperson I'm asking you first because involving #gitannex would be high on my priority list. Really this wouldn't need to be #hledger specific as it could just as well be paired with #ledgercli or #beancount either directly or via CSV or whatever. I'm not a huge GitLab fan these days but can do it if you prefer. Codeberg seems more aligned or GitHub having the advantage of contributor pool. Thoughts?

I apologize for not warning, but I released an update of the #hledger extension for vscode. Now I use my hledger-lsp server to work.

Release 0.5.0 · juev/hledger-vscode https://github.com/juev/hledger-vscode/releases/tag/v0.5.0

@Bdkl #hledger is the bomb. I'm a VIM user myself but @simonmic the maintainer is an emacs type I think so I imagine there is decent interaction available.

After a long session yesterday evening I finally managed to print custom QR code labels for #paperless onto sticker label A4 sheets. The QR code contains 'TAG:👛 Yann' and paperless can be configured to auto-detect that in scanned documents (such as receipts) and auto-attach a tag '👛 Yann' to know from whose purse that receipt was, which is very handy for #accounting (with #hledger) later, especially for cash purchases that you otherwise don't have any other trace of.

GitHub - juev/hledger-lsp: Language Server Protocol (LSP) implementation for #hledger journal files https://github.com/juev/hledger-lsp

@driedmushroom @tea I have my own bespoke bash script, but it's basically a log of bought and drank. It's all stored in sqlite so i can do these queries.
My finances i track with #hledger. One could probably also track their tea using #plaintextaccounting.

I've been using #hledger from @simonmic for a few years, and it's been better than any other personal finance tool I've tried ☺️

The only thing I've been missing was various plots and charts, and I wasn't quite happy with any of the existing tools.

So I developed my own viewing UI for my HLedger journal; it's a read-only window on your finances showing a series of plots in a nice TUI - and it can also be hosted on a server!

Try it out! ✨

https://github.com/lucabello/hledger-tui

hledger-1.51.2 fixes some regressions and brings some minor improvements.

- https://github.com/simonmichael/hledger/releases/1.51.2
- https://hledger.org/relnotes.html#2026-01-08-hledger-1512
- https://hledger.org/install

#hledger is free, robust, friendly, multicurrency, double-entry, #plaintextaccounting software for unix, mac, windows, and the web.

@gumnos I have approximately the following statistics on the work of #hledger

❯ hledger stats
Main file           : .../main.journal
Included files      : 8
Txns span           : 2019-10-09 to 2026-01-03 (2278 days)
Last txn            : 2026-01-02 (2 days ago)
Txns                : 5470 (2.4 per day)
Txns last 30 days   : 74 (2.5 per day)
Txns last 7 days    : 13 (1.9 per day)
Payees/descriptions : 303
Accounts            : 72 (depth 4)
Commodities         : 3
Market prices       : 0
Runtime stats       : 0.20 s elapsed, 27918 txns/s, 14 MB live, 39 MB alloc

However, I don't see any performance issues. Yes, I don't have many transactions either.

Can you provide your statistics to understand what to pay attention to?

If you handle your #plaintextaccounting using either #vim or #neovim based on either #ledgercli or #hledger then be sure to update your plugins! The vim-ledger plugin got some much needed love in the last 48 hours with a lot of rough edges smoothed over and a few new features.

https://github.com/ledger/vim-ledger/releases/tag/v1.3.0

If you're a #beancount peep then carry on as before. If you do #bookkeeping without PTA at all then what are you even waiting for? If you use #emacs then this post is in another castle.

This was a lot of work, so I'm putting it out there in case someone else finds it useful:

new docs describing #OpenCollective's #csv, and #hledger rules for converting it.

https://github.com/simonmichael/hledger/tree/master/examples/csv/other/opencollective

#plaintextaccounting

This was a lot of work, so I'm putting it out there in case someone else finds it useful:

new docs describing #OpenCollective's #csv, and #hledger rules for converting it.

https://github.com/simonmichael/hledger/tree/master/examples/csv/other/opencollective

#plaintextaccounting

@nobodyinperson @realestninja Second on both counts here; #plaintextaccounting is the only way to fly. Any of #beancount, #ledger, or #hledger are decent choices which some tradeoffs for each, but the latter is my choice as well having tried the other two.

🎄 Advent of Donations - Day 8 🎄

Today I've selected a project that has become essential to how I run my self-employment business: hledger.

It's a plain text accounting tool and I use it for all my accounting.

Learn more about Advent of Donations and hledger in my latest blog post update: https://britter.dev/blog/2025/12/01/advent-of-donations/#day-8---hledger

#AdventOfDonations #hledger #plaintextaccounting

RE: https://mastodon.social/@whitequark/115635167578691059

Thank you

- @joeyh for :gitannex: #gitAnnex
- @matrss for maintaining #forgejoAneksajo
- @simonmic for :hledger: #hledger
- John Collins for #latexmk

and many people maintaining other #FOSS projects I rely upon

RE: https://mastodon.social/@whitequark/115635167578691059

Thank you

- @joeyh for :gitannex: #gitAnnex
- @matrss for maintaining #forgejoAneksajo
- @simonmic for :hledger: #hledger
- John Collins for #latexmk

and many people maintaining other #FOSS projects I rely upon

RE: https://mastodon.social/@whitequark/115635167578691059

Thank you

- @joeyh for :gitannex: #gitAnnex
- @matrss for maintaining #forgejoAneksajo
- @simonmic for :hledger: #hledger
- John Collins for #latexmk

and many people maintaining other #FOSS projects I rely upon

RE: https://mastodon.social/@whitequark/115635167578691059

Thank you

- @joeyh for :gitannex: #gitAnnex
- @matrss for maintaining #forgejoAneksajo
- @simonmic for :hledger: #hledger
- John Collins for #latexmk

and many people maintaining other #FOSS projects I rely upon

RE: https://mastodon.social/@whitequark/115635167578691059

Thank you

- @joeyh for :gitannex: #gitAnnex
- @matrss for maintaining #forgejoAneksajo
- @simonmic for :hledger: #hledger
- John Collins for #latexmk

and many people maintaining other #FOSS projects I rely upon

토요일 #FOSSforAll @fossforall Conference 2025 에서 발표한 #PlainTextAccounting with #hledger 세션 슬라이드 자료 https://docs.google.com/presentation/d/17kkPlLOFhpwfEIhHfT0hJ1PRmZ6-Tq7JIAdTAhjp24A/edit?usp=sharing

토요일 #FOSSforAll @fossforall Conference 2025 에서 발표한 #PlainTextAccounting with #hledger 세션 슬라이드 자료 https://docs.google.com/presentation/d/17kkPlLOFhpwfEIhHfT0hJ1PRmZ6-Tq7JIAdTAhjp24A/edit?usp=sharing

토요일 #FOSSforAll @fossforall Conference 2025 에서 발표한 #PlainTextAccounting with #hledger 세션 슬라이드 자료 https://docs.google.com/presentation/d/17kkPlLOFhpwfEIhHfT0hJ1PRmZ6-Tq7JIAdTAhjp24A/edit?usp=sharing

토요일 #FOSSforAll @fossforall Conference 2025 에서 발표한 #PlainTextAccounting with #hledger 세션 슬라이드 자료 https://docs.google.com/presentation/d/17kkPlLOFhpwfEIhHfT0hJ1PRmZ6-Tq7JIAdTAhjp24A/edit?usp=sharing

토요일 #FOSSforAll @fossforall Conference 2025 에서 발표한 #PlainTextAccounting with #hledger 세션 슬라이드 자료 https://docs.google.com/presentation/d/17kkPlLOFhpwfEIhHfT0hJ1PRmZ6-Tq7JIAdTAhjp24A/edit?usp=sharing

Nice little script to convert a Toggl CSV timetracking export to a timeclock file compatible with hledger.

https://codeberg.org/scy/toggl2timeclock

#Toggl #hledger #timetracking #converter #conversion #Python #script #timeclock

Nice little script to convert a Toggl CSV timetracking export to a timeclock file compatible with hledger.

https://codeberg.org/scy/toggl2timeclock

#Toggl #hledger #timetracking #converter #conversion #Python #script #timeclock

Nice little script to convert a Toggl CSV timetracking export to a timeclock file compatible with hledger.

https://codeberg.org/scy/toggl2timeclock

#Toggl #hledger #timetracking #converter #conversion #Python #script #timeclock

Nice little script to convert a Toggl CSV timetracking export to a timeclock file compatible with hledger.

https://codeberg.org/scy/toggl2timeclock

#Toggl #hledger #timetracking #converter #conversion #Python #script #timeclock

Nice little script to convert a Toggl CSV timetracking export to a timeclock file compatible with hledger.

https://codeberg.org/scy/toggl2timeclock

#Toggl #hledger #timetracking #converter #conversion #Python #script #timeclock