## Release notes
**Small improvements, doc updates**
### hledger 1.51
Fixes
- HTML output no longer contains invalid nested tables (Joschua Kesper). This may cause some visual changes, hopefully all for the better.
- `stats`: `-o` now redirects all output, including the performance stats.
Features
- `commodities`, `payees` and `tags` commands now have a `--find` mode for finding the best match (like the `accounts` command).
- `stats`: A new `-1` flag prints a single line of output in machine-friendly tab-separated format, including the program version, journal file name, and performance stats.
Improvements
- In journal format, an empty `{}` pair is now allowed (and ignored) in amounts, slightly improving Ledger/Beancount compatibility.
- `accounts` in `--tree` mode, when showing a subset of accounts, now shows parent accounts for context, like the `balance` command.
(Sam Almahri, [#2427])
- `accounts --types` no longer shows value-less type tags; untyped accounts are shown without a `type` tag.
- When pivoting on account type with `--pivot=type`, account types will be normalised to their short spelling (`A` instead of `Assets`, etc).
- `accounts`: the `--positions` flag has been renamed to `--locations`.
- `print`: the `--location` flag has been renamed to `--locations`.
- `setup`: tidier output for missing LEDGER_FILE or default file; wording improvements
Docs
- Account names: rewrite, emphasise the two space delimiter
- accounts: improve/sync options order
- add: balance assertions/assignments: clarify, fix [#2494]
- aregister: formatting
- aregister: clarify arguments
- argument files: corrections
- check: drop obsolete note about transaction balancing
- check: edits, correction
- close: customisation: clarify [#2492]
- commodity directive: add info about the -c command line option (Ooker)
- COMMON TASKS: demote subheadings
- csv: new "CSV fields and hledger fields" section
- csv: new "Regular expressions in CSV rules" section
- csv: link the `if`-specific `skip` and `end` ruels more clearly
- depth: rewrite, note combining issue
- print: clarify amount styling; note more parseability breakers
- print: note another way print can disrupt journal readability (same-day balance assertions)
- rename Editor configuration -> Editors
- Setting LEDGER_FILE: rewrite, new windows procedures
- Special characters: rewrite (Simon Michael, Caleb Maclennan, [#2468])
- Tags: rewrite [hledger_site#141]
- Value reporting: more advice, examples for COMM
- Value reporting: warn about -V, emphasise -X
Examples
- Organise/rename examples/csv/ as the [CSV rules library](https://github.com/simonmichael/hledger/tree/master/examples/csv)
Scripts/addons
- `hledger-check-buynothing`: check Buy Nothing Day compliance
- `hledgerj1`: example of a wrapper for reading a custom data format
- `sortandmergepostings`: Overhaul for more robust determinism (Caleb Maclennan)
- Avoids non-deterministic flip-flopping when the alphabetical account sort has multiple commodities
- Sorts postings commodities so commodities are in the same order across transactions
- Sorts postings with matching commodity by posting amount
API
- Hledger.Cli.Utils:
- stop exporting pivotByOpts, anonymiseByOpts
- renamed withJournalDo -> withJournal. The old name is still available but deprecated.
### hledger-ui 1.51
Improvements
- Allow brick 2.10, vty 6.5.
- Uses hledger 1.51.
### hledger-web 1.51
Improvements
- Uses hledger 1.51.
### project changes 1.51
Docs updated
- ACHIEVEMENTS
- ANNOUNCE.short
- AUTHORS
- bin/README
- CHANGES.md: move to doc/ for consistent paths
- Contributing: mention translation (Lý Minh Nhật)
- DECISIONS
- dev
- DOCS: document & diagram latest doc update procedures
- ISSUES
- REGRESSIONS
- RELEASING
- relnotes: more reliable changelog links
- ROADMAP
- tldr/README
Infrastructure/Misc
- bump stack snapshots
- Dockerfile fixed (probably)
- drop the hledger-install script
- just changelogs* update
- just docupdatediag
- just ghci-ui: :main (and :rmain) now works again
- just ghnightly* -> nightly*
- just oldest
- just perftest: run performance tests, logged to perf.log
- just releasediag update
- just rels-major
- just site-restart
- just: devtag-push: simplify
- just: ghrel-bin-upload
- just: manuals, manuals-site
- just: reltags: cleanup
- just: ver, majorver
- Justfile: less safari dependence
- Justfile reorg, cleanups
- release script updates
- Shake: drop mandates target, update manual dates automatically
- Shake manuals: more contributor instructions in the header comment [hledger_site#140]
- stack92: add valid hashtables version
- stack94: add valid hashtables version
- stack96: add valid hashtables version
- stack98: include valid hashtables version
- stack98: restore needed encoding 0.10 extra dep
- stop git ignoring site/src/, allowing web docs to be easily opened in vscode
- tools/relnotes.hs update
- use a nightly branch instead of a nightly tag on github, it's simpler
- workflows: use shelltestrunner 1.11
- workflows:binaries-mac-x64: switch to macos-15-intel
### credits 1.51
Simon Michael,
Caleb Maclennan,
Joschua Kesper,
Ooker,
Sam Almahri.
[#2427]: https://github.com/simonmichael/hledger/issues/2427
[#2468]: https://github.com/simonmichael/hledger/issues/2468
[#2492]: https://github.com/simonmichael/hledger/issues/2492
[#2494]: https://github.com/simonmichael/hledger/issues/2494
## Install
For all install options, see [hledger.org: Install](https://hledger.org/install).
You can install hledger from most package managers (but check for a green badge indicating it's up to date).
Or you can build it from source yourself.
Or you can install up to date binaries from this page, by following the appropriate instructions below.
If you find problems with these instructions, please [let us know](https://hledger.org/support).
<xdetails>
### All platforms
If you have [eget](https://github.com/zyedidia/eget), that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
</xdetails>
<xdetails>
### GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.51/hledger-linux-x64.tar.gz | tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.51
</xdetails>
<xdetails>
### Mac, 64-bit ARM or Intel
In a terminal window (don't download the binaries with your web browser, they won't get authorised):
On ARM macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.51/hledger-mac-arm64.tar.gz | tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.51
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.51/hledger-mac-x64.tar.gz | tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.51
</xdetails>
<xdetails>
### Windows, 64-bit ARM or Intel
In a powershell window (press `WINDOWS-R`, `powershell`, `ENTER`):
cd ~
curl https://github.com/simonmichael/hledger/releases/download/1.51/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -Force -DestinationPath AppData\Roaming\local\bin
hledger --version; hledger-ui --version; hledger-web --version # should show 1.51
</xdetails>
<xdetails>
### Windows 7, 64-bit Intel
These instructions have not been tested recently, please [let us know](https://hledger.org/support) if they work for you:
- click hledger-windows-x64.zip below
- choose Open with Windows Explorer, OK
- click Extract all files
- choose a destination folder - ideally one that appears in `echo %PATH%`, like `C:\Windows` (though that one will require administrator permission); otherwise, your home directory (`C:\Users\YOURNAME`)
- check "Show extracted files when complete"
- click Extract, wait for the destination folder to open
- find the hledger, hledger-web icons (if you extracted to `\Windows`, you'll need to scroll down)
- for each icon: double-click, uncheck "Always ask before opening this file", click Run
- close those Explorer windows
- open a command window (press Windows-r, type CMD, press enter)
- `hledger --version; hledger-ui --version; hledger-web --version` should show 1.51
- `echo # >> .hledger.journal` to ensure a default journal file exists. (Important: the doubled **>>** is needed to avoid overwriting existing data.)
Problems:
- Starting hledger by double-clicking its icon won't work because it needs arguments; run it from the command window instead.
- Starting hledger-web by double-clicking its icon may fail eg because Explorer's command window is too small;
configure that to be larger, or run hledger-web from a command window instead.
- hledger or hledger-web may fail to run if there is not enough memory available.
</xdetails>
### Next steps
Once installed, run `hledger`, and perhaps read [hledger.org: Quick start](https://hledger.org/#quick-start).
Source: README.md, updated 2025-12-05
Download Latest Version
hledger-linux-x64.tar.gz (48.3 MB)
