## Release notes
### hledger 1.51.2
Fixes
- The `add` and `import` commands now once again auto-create the journal file
if it does not exist yet, fixing a regression in 1.50.3.
Also they now create it lazily, only when they have data to write,
not unconditionally at the start.
[#2514]
- The `roi` command has some more sanity checks, and some error messages
have been clarified.
(Dmitry Astapov, [#2505])
Improvements
- The `-f` option now reports an error if you give it a glob pattern
(a path containing `[`, `{`, `*`, or `?`) that matches nothing.
This makes it consistent with `LEDGER_FILE`.
- Journal format's `include` directive no longer unnecessarily reads
the attributes of all files in a directory. This works better with
build tools like tup which detect filesystem operations.
- Journal format's `include` directive has been optimised,
repairing a slight slowdown introduced in 1.50.3.
It no longer calls `canonicalizePath` unnecessarily.
This might be noticeable with many includes on a slow filesystem.
- Allow base 4.22 / ghc 9.14.
API
- Hledger.Cli.Utils:
withPossibleJournal
[#2505]: https://github.com/simonmichael/hledger/issues/2505
[#2514]: https://github.com/simonmichael/hledger/issues/2514
### hledger-ui 1.51.2
- hledger add invoked via the `a` key now shows output properly,
fixing a regression in 1.50. [#2512]
- Allow vty-crossplatform 0.5. (Jens Petersen)
- Allow base 4.22 / ghc 9.14.
[#2512]: https://github.com/simonmichael/hledger/issues/2512
### hledger-web 1.51.2
- The register view now prevents line wrapping in dates when the window is narrow. [#2520]
- Allow base 4.22 / ghc 9.14.
[#2520]: https://github.com/simonmichael/hledger/issues/2520
### credits 1.51.2
Simon Michael,
Dmitry Astapov,
Jens Petersen.
## 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.2/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.2
</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.2/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.2
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.51.2/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.2
</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.2/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.2
</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.2
- `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 2026-01-08
Download Latest Version
hledger-linux-x64.tar.gz (48.4 MB)
