hledger: baixar versions anteriors

Release notes
hledger-web packaging fixes for stackage; misc dependency and doc updates
hledger 1.52.4
Improvements
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of megaparsec#572).
Docs
- csv: the manual now correctly documents that most top-level rules are evaluated first-wins, not last-wins as previously stated.
(Accepting the status quo, unlike hledger 2.x where they are changed to last-wins.) #2539
hledger-ui 1.52.4
Improvements
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of megaparsec#572).
- Allow vty 6.6+, and drop the upper bounds on vty, vty-crossplatform and vty-windows.
hledger-web 1.52.4
Fixes
- Raise aeson's lower bound to >=2.2.5.1, avoiding versions vulnerable to denial-of-service.
(https://haskell.github.io/security-advisories/advisory/HSEC-2026-0007.html)
Improvements
- The yesod-static and hjsmin dependencies have been dropped;
hledger-web now serves its static files itself, using wai-app-static
and file-embed. (yesod-static doesn't currently build with crypton
1.1+, which has kept it, and hledger-web, out of stackage nightly.)
Static file urls no longer include an ?etag=... cache buster;
instead the files are served with an ETag header, and conditional
requests are answered with 304 Not Modified.
(Cherry picked from an AI-assisted change in hledger 2.x.)
- Allow megaparsec 9.8.1+ (but not 9.8.0, because of megaparsec#572).
- Allow yesod-core 1.7.0.0.
project changes 1.52.4
Doc updates
- Github release install instructions have been fixed and simplified. #2707
credits 1.52.4
Simon Michael.
Install
The hledger Install page lists the easiest ways to install a recent release,
such as brew on macos, choco/scoop/winget on Windows, or eget on all platforms.
Or, follow these instructions to install the specific release binaries below:
Updates to binaries:
- 2026-01-12: Fixed the hledger-linux-x64.tar.gz asset below, it previously contained a dev build. #2526
GNU/Linux, 64-bit Intel
At the command line:
curl -fL https://github.com/hledgerorg/hledger/releases/download/1.52.4/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.52.4
Prefix tar with sudo if /usr/local/bin is not writable.
Mac, 64-bit ARM or Intel
Open a terminal window.
(Don't download these binaries with your web browser - they won't get authorised.)
On ARM macs:
sudo mkdir -p /usr/local/bin
curl -fL https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-mac-arm64.tar.gz | sudo tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.52.4
On Intel macs:
sudo mkdir -p /usr/local/bin
curl -fL https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-mac-x64.tar.gz | sudo tar -xzv -f- -C/usr/local/bin hledger hledger-ui hledger-web
hledger --version; hledger-ui --version; hledger-web --version # should show 1.52.4
If the version check shows an older version, you have another hledger earlier in $PATH; which -a hledger will find it.
Windows, 64-bit ARM or Intel
In a powershell window (press WINDOWS-R, powershell, ENTER).
(Don't download the zip with your web browser - programs downloaded that way may be blocked when you run them.)
cd ~
curl.exe -fLO https://github.com/hledgerorg/hledger/releases/download/1.52.4/hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -Force -DestinationPath "$env:LOCALAPPDATA\Programs\hledger"
$env:LOCALAPPDATA\Programs\hledger (ie C:\Users\YOURNAME\AppData\Local\Programs\hledger) is not in $env:Path by default,
so if $env:Path doesn't show it, add it once:
[Environment]::SetEnvironmentVariable('Path', "$env:LOCALAPPDATA\Programs\hledger;" + [Environment]::GetEnvironmentVariable('Path','User'), 'User')
$env:Path = "$env:LOCALAPPDATA\Programs\hledger;$env:Path" # for this window; new windows will pick it up automatically
Then:
hledger --version; hledger-ui --version; hledger-web --versi

- Uses hledger-lib 1.52.3.
- Uses hledger 1.52.3.

Fixes
- Another XSS (cross-site scripting) vulnerability has been fixed, in the add transaction form's error message. Any web page visited while hledger-web was running could use it to run javascript in hledger-web's origin, and from there read the whole journal, or alter it. All hledger-web users should upgrade. See also: GHSA-vq7r-8w52-jv84. (Arthur Cinader, Simon Michael, #2700)
- A newline submitted in a transaction's description, code or account name is no longer written into the journal file. This removes the possibility of the user inserting an include directive, which could expose system files readable by the hledger-web server. See also: GHSA-vq7r-8w52-jv84. #2704
Note: as with #2698 in 1.52.2, these fixes were backported from AI-assisted fixes in hledger 2, under the security exception in https://hledger.org/AI.html; they have been reviewed and tested.
- hledger-web's official binaries, and builds from the hledger source tree, now use aeson 2.3, avoiding a denial of service bug. (https://haskell.github.io/security-advisories/advisory/HSEC-2026-0007.html)

Simon Michael,
Arthur Cinader.

Release notes

hledger 1.52.2
- Uses hledger-lib 1.52.2.

hledger-ui 1.52.2
- Uses hledger 1.52.2.

hledger-web 1.52.2
Fixes
- An XSS (cross-site scripting) vulnerability has been fixed in the add
transaction form's autocomplete. Journal data from an untrusted source
could execute javascript when shown as a completion suggestion. All
hledger-web users are encouraged to upgrade. Full technical details:
GHSA-538p-cvc4-4qjm.
(Arthur Cinader, Simon Michael, #2698)
Note: this bug was detected, and the original patch was generated, by
Arthur Cinader with AI assistance, for hledger 2.x. Because the
vulnerability is in theory quite severe, and the fix is small and
obvious, and I don't want to add risk by redoing it from memory, and
no-one else volunteered promptly to do that work - and after
discussion in the chat and mail list (see today's thread), and careful
human review and testing - I manually backported the same fix to
hledger 1. And, updated the project's https://hledger.org/AI.html
policy to allow this for needed security-related fixes like this one
(which I expect to be very rare).

credits 1.52.2
Simon Michael,
Arthur Cinader.

Install
For all install options, see 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.
Updates to binaries:
- 2026-01-12: Fixed the hledger-linux-x64.tar.gz asset below, it previously contained a dev build. #2526

All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:

GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.52.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.52.2

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.52.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.52.2
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.52.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.52.2

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.52.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.52.2

Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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 

Release notes

hledger 1.52.1
Breaking changes
- The Gain (G) account type is no longer auto-detected from account names like
revenue:gains or income:capital gains; it must now be declared explicitly with ; type: G.
Also, the UnrealisedGain (U) account type, a subtype of Equity, has been added
(spellings U, UnrealisedGain, and UnrealizedGain are all accepted).
These improve compatibility between hledger 1 and 2.
Docs
- The "Cost basis / lot syntax" section has been renamed to "Cost basis",
and updated to mention hledger 2.

hledger-ui 1.52.1
Improvements
- Uses hledger 1.52.1.
- Allow vty-crossplatform 0.5.

hledger-web 1.52.1
Improvements
- Uses hledger 1.52.1.

credits 1.52.1
Simon Michael.

Install
For all install options, see 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.
Updates to binaries:
- 2026-01-12: Fixed the hledger-linux-x64.tar.gz asset below, it previously contained a dev build. #2526

All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:

GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.52.1/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.52.1

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.52.1/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.52.1
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.52.1/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.52.1

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.52.1/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.52.1

Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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.52.1
- 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 larg

Release notes
Preserve cost basis syntax, cost basis export examples, faster valuation, commodity tags, more robust paging, fixes.

hledger 1.52
Features
- aregister and register now support --drop for trimming leading account name components,
like the balance command.
(Caleb Maclennan)
- print now preserves and reproduces Ledger-style lot syntax (cost basis annotations) in text and json output,
and (converted to Beancount syntax) in beancount output.
- Tags can now be declared on commodities, and you can query for postings by their commodity's tags.
- A new Gain (G) account type has been added, as a subtype of Revenue.
Certain account names, like income:gains, revenue:capital-gains, income:losses,
are auto-detected as Gain type.
This provides a language-independent way of matching capital gain/loss accounts specifically.
(It is used more in hledger 2.)
(g. nicholas d'andrea) #2522
Fixes
- The add and import commands once again read all -f files, not just the first.
This fixes a regression in 1.51.2 which broke autocompletion in add,
and multi-file reading in import, when multiple -f options were given.
#2553
- In balance reports, accounts revealed by --empty --declared now respect account display order, instead of being shown last.
(Juliano Solanho) #2564
- balance --budget's csv/tsv output now properly suppresses digit group marks (eg thousands separators),
preserving valid CSV structure.
#2555
- The run command now properly returns a non-zero exit code if there's an error while commands are being provided on standard input.
(Previously it always returned exit code 0 in this mode.)
#2557
- Options requiring a value (like --round or -f) now give a clear error if the value is missing
(rather than trying to consume a following flag).
#2556
- Postings generated by --infer-equity no longer inherit the source posting's tags, comment, or real/virtual type.
(The posting's date and status are still inherited.)
#2535
Improvements
- When converting to value, price lookups are now optimised with pre-built indexes.
This replaces O(n log n) re-sorting on every valuation date with O(log n) indexed lookups,
significantly improving performance for --value=end,COMM with daily reports
over long periods and large price databases.
(Oleg Bulatov) #2511
- date: queries can now include a report interval, eg date:weekly or date:'weekly from last month',
like the -p/--period option.
- Smart dates now understand last|this|next WEEKDAY and last|this|next MONTHNAME.
- When add or import are autocreating a requested journal file that did not exist,
they will also create any required parent directories.
- The less pager is now invoked more robustly; we catch and report more kinds of failure clearly,
and/or fall back to unpaged output with a warning.
#2544
- The --quit-at-eof flag is no longer added when running the less pager (and our less flags are better documented).
- Improvements to the setup command:
- improve top info's layout
- show the OS version, architecture, and compiler version
- show if hledger is wrongly built without OS thread support
- show the value of $LESS more accurately
- test that it runs with the configured options
- print a warning before making a http request
- show more compact output if the http request fails
Docs
- Account tags: new separate section
- COMMON TASKS: Setting LEDGER_FILE: updates
- Cost basis / lot syntax: new section and edits
- Costs: rewrite
- csv: if: field matchers: clarify
- Inferring equity conversion postings: note account tags limitation
- journal: code: mention valid characters, recommend tags #2563
- Regular expressions: note no lazy quantifiers
- Tag names: clarify --verbose-tags
Examples
- csv: Fidelity, Open Collective updates
- csv: Interactive Brokers example CSV rules files #2508 (Ilja Kocken)
- csv/cctax: notes and sample files related to exporting to cryptocurrency tax calculators
- debconf: DebConf ledger files 2017-2025, adapted for hledger
- investing/export-lots-workflow: doc and examples fo

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
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.
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.
credits 1.51.2
Simon Michael,
Dmitry Astapov,
Jens Petersen.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
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
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
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
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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 th

Release notes
hledger 1.51.1
Fixes
- Relative includes from a symbolically-linked journal file now work again.
This was fallout from 1.50.4's fixes.
#2503
- When journal's include directive has an IO error, like trying to
include an existing but unreadable file, or failing to find a home
directory when expanding ~, it now shows the problematic include
directive (previously the line number was off by one).
- aregister: respect the order of -f options when showing same-day transactions from multiple files.
If transactions on the same date are coming from two files specified
with -f options, we expect them to be displayed in parse order, ie
respecting the order of the -f options. This wasn't always the case,
now it is.
- aregister: show "ACCTPAT matches no account" error on just one line.
- Fix build failures with the scripts in bin/.
(Dmitry Astapov, #2497)
hledger-ui 1.51.1
- Uses hledger 1.51.1.
hledger-web 1.51.1
- Uses hledger 1.51.1.
credits 1.51.1
Simon Michael,
Dmitry Astapov,
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.51.1/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.1
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.1/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.1
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.51.1/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.1
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.1/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.1
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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.1
- 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 t

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
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 si

Release notes
hledger 1.50.5
Fixes
- Relative includes from a symlinked file work again, fixing some fallout from 1.50.4's fixes.
#2503
hledger-ui 1.50.5
- Uses hledger 1.50.5.
hledger-web 1.50.5
- Uses hledger 1.50.5.
credits 1.50.5
Simon Michael.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.5/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.50.5
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.50.5/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.50.5
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.5/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.50.5
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.50.5/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.50.5
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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.50.5
- 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.
Next steps
Once installed, run hledger, and perhaps read hledger.org: Quick start.

Release notes
hledger 1.50.4
Fixes
- An include directive with no argument now gives consistent error messages.
- journal format's include directive no longer excludes paths containing dotted directories/files.
1.50-1.50.3 contained an overzealous workaround that sometimes wrongly excluded paths containing a dot dir or dot file.
Now the pre-1.50 behaviour is restored
(* and ** generally avoid dot files and dot directories, except ** will search non-top-level dot directories).
#2498
- Symbolic links found by include directives are once again shown as-is, not dereferenced.
(1.50-1.50.3 showed them dereferenced, eg in hledger files output.)
There is some related new behaviour: each time an include directive is parsed,
all the parent file paths and the new include file path(s) are re-canonicalised.
Previous hledger versions did not do this; it's expected to be unnoticeable,
but if you notice any slowdown caused by having many include directives and a slow filesystem,
please report it.
hledger-ui 1.50.4
- Uses hledger 1.50.4.
hledger-web 1.50.4
- Uses hledger 1.50.4.
credits 1.50.4
Simon Michael.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.4/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.50.4
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.50.4/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.50.4
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.4/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.50.4
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.50.4/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.50.4
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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.50.4
- echo # >> .hledger.journal to ensure a default journal file exists. (Important: the doubled >> is needed to avoid overwriting existing data

Release notes
hledger 1.50.3
Fixes
- hledger versions 1.50-1.50.2 ran much slower than normal (depending on the speed of your hard drive).
This 1.50.3 release fixes that; so please upgrade, and avoid those older 1.50 releases.
#2493
- A regression in 1.50, where very large dates could produce wrong reports, has been fixed.
(Affecting dates outside the range -25252734927764696-04-22..25252734927768413-06-12
on 64 bit machines, or -5877752-05-08..5881469-05-27 on 32 bit machines.)
#2479
- If the LEDGER_FILE environment variable is set to a nonexistent file, we now report an error
rather than silently falling back on a default file path, which was confusing.
Also, we no longer support the legacy LEDGER environment variable as a fallback.
#2485
- setup now shows tidier output when a LEDGER_FILE or default file is not found,
- add now checks balance assertions more robustly, with awareness of how everything is ordered in the journal.
Also, it now allows adding balance assignments.
#2478
- check accounts no longer garbles non-ascii account names in its output.
#2469
- We now escape special characters properly when passing arguments to addons
(with just one level of quoting/escaping, not two).
And related docs have been improved.
(Caleb Maclennan, Simon Michael, #2468)
- Internal report code which could produce certain date-related errors has been made robust again.
(Stephen Morgan)
- The old "threaded" build flag, which cabal could turn off, has been dropped.
This will hopefully prevent wrong builds like Debian's #1120833.
#2495
- Docs updated: add, areg, argument files, check, close, csv, depth, print, print, Special characters, Value reporting
hledger-ui 1.50.3
- --watch mode now also detects changes from apps which overwrite the file, such as VS Code.
(Caleb Maclennan)
- When hledger-ui is started with --pivot, re-enabling balance assertions
with the I key now does a full journal reload, to check assertions more accurately.
#2451
- The old "threaded" build flag, which cabal could turn off, has been dropped.
#2495
- Allow brick 2.10, vty 6.5.
- Uses hledger 1.50.3.
hledger-web 1.50.3
- The old "threaded" build flag, which cabal could turn off, has been dropped.
#2495
- Uses hledger 1.50.3
credits 1.50.3
Simon Michael,
Caleb Maclennan,
Stephen Morgan.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.3/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.50.3
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.50.3/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.50.3
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.3/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.50.3
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.43.2/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hled

Release notes
hledger 1.50.2
Fixes
- The CSV encoding rule is now respected when using the rules file as input file. This was a regression in 1.50.
Also, the text decoding error message has been clarified; it now mentions a possible CSV encoding.
#2465
- The doc for --depth has been clarified, and now mentions the use of quotes.
(Quả Cầu, Simon Michael, [hledger_site#140])
- A typo was fixed in the --depth example in register's doc.
([hledger_site#140], reported by Quả Cầu)
- Our package bounds now avoid hashtables 1.3.x, which fails to build with some gcc versions
(see gregorycollins/hashtables#97)).
(hseg, #2463)
hledger-ui 1.50.2
- Uses hledger 1.50.2
hledger-web 1.50.2
- Uses hledger 1.50.2
credits 1.50.2
Simon Michael (@simonmichael),,
hseg (@hseg),.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.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.50.2
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.50.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.50.2
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.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.50.2
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.43.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.50.2
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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.50.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 h

Release notes
hledger 1.50.1
Fixes
- Balance commands now show an empty report instead of an error when
no transactions are matched, fixing a regression in 1.50.
(Stephen Morgan, #2452)
- The print command's help no longer shows an unused --show-costs flag.
And the command-specific flags are now mostly ordered alphabetically.
- Whitespace in the setup command's "undeclared commodities" output has been fixed.
Doc updates
- Text encoding
- bin/README: paypal*, simplefin* usage examples, doc link
API
- Hledger.Cli.Utils:
add withJournal alias for withJournalDo,
pivotByOpts -> maybePivot,
anonymiseByOpts -> maybeWarnAboutAnon,
stop exporting pivotByOpts, anonymiseByOpts
- Hledger.UI.ErrorScreen:
uiReloadJournal -> uiReload,
uiReloadJournalIfChanged -> uiReloadIfFileChanged
hledger-ui 1.50.1
Fixes
- The transaction screen and error screen now update on data changes like other screens,
eg when using the E key, g key, or --watch.
#2014, #2288
- When the journal is reloaded by the g key or --watch, the
--pivot (and --obfuscate) options are now preserved,
and spurious errors are avoided.
#2451
- The Z key (and the -E command line flag) toggles zero-balance accounts again.
(Stephen Morgan, #2454)
Improvements
- Debug output has improved, eg it's easier to see changes to the screen stack.
API
- Hledger.UI.ErrorScreen:
uiReloadJournal -> uiReload,
uiReloadJournalIfChanged -> uiReloadIfFileChanged
- Hledger.UI.UIState:
enableForecastPreservingPeriod -> enableForecast
hledger-web 1.50.1
- Uses hledger 1.50.1
credits 1.50.1
Simon Michael (@simonmichael),
Stephen Morgan (@Xitian9).
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.1/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.50.1
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.50.1/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.50.1
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.50.1/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.50.1
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.43.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.50.1
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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, hl

Release notes
Better transaction balancing, include improvements, auto posting account interpolation, csv data commands, import archiving, timeclock improvements, fixes
hledger 1.50
Breaking changes
- Transaction balancing is now done in a more robust way, using local precisions only (like Ledger) #2402.
Until now, a transaction was required to balance using its commodities's global display precisions.
Small imbalances were tolerated by configuring display precisions for the whole journal (with commodity directives).
Now, a transaction is required to balance using the precisions in its journal entry only.
This means each entry can use the precision it needs, and balancing precision and display precision are independent.
(So eg, increasing the display precision with -c no longer breaks the journal.)
In practice this requires journal entries to be more accurate, and you will probably need to fix some old entries.
There are three main ways to fix an entry:
- reduce the amounts' precision (use fewer decimal digits, so a lower balancing precision is inferred)
- make the amounts more accurate (use better decimal digits, so the amounts sum to zero more closely)
- or (easiest) add an amountless "expenses:rounding" posting (this is not a cheat, it's a more accurate record of what your bank/broker is doing).
You can also keep the old transaction-balancing behaviour with --txn-balancing=old, for now.
But updating your entries is recommended.
The old behaviour could allow small remainders to accumulate over time,
in accounts that often have an inexact posting amount or cost amount and are never reconciled -
typically equity, revenues, and expenses.
You can check for this in your old journals with a command like
hledger bal cur:\\$ -c '$1.000000000000' | grep -E '\...0*[1-9]'
(show $ account balances, with many decimals, which have a non-zero decimal in the 3rd place or beyond)
- Timeclock format has had various changes:
- Timeclock syntax and parsing is now more robust (when not using --old-timeclock):
- Semicolon always starts a comment (and timeclock account names may not include semicolons).
- Trailing spaces are ignored.
- Clock-ins now require an account name.
- Clock-outs now can have a comment and tags.
- Timeclock entries are processed in parse order.
- Some order-related bugs in 1.43 have been fixed.
- Concurrent/overlapping sessions are now fully supported, even if they have the same account name.
- The timeclock doc has been rewritten.
- The --old-timeclock hidden flag has been renamed, documented, and now also affects included files.
#2141, #2365, #2400, #2417
- Some edge cases in balance report behaviour were changed for internal consistency:
- --declared now treats parent accounts consistently.
- --flat --empty now ensures that implied accounts with no postings are not displayed,
but accounts with zero balance and actual postings are.
(Stephen Morgan, #2360, #2395)
- hledger now requires at least GHC 9.6 (and base 4.18), to ease maintenance.
Fixes
- Paging long output no longer gives an error when LESS is undefined and
less does not have mouse support (as on some FreeBSD systems).
- The all: query now requires at least one posting to match.
(Previously, matching no postings at all was also considered a success.)
- When using journal format's include directive, several kinds of
error (read failure, cyclic include..) could show an off-by-one line
number or excerpt, confusingly. This has been fixed.
Also, attempting to include a rules file now gives a better error message.
- In CSV if rules, match group references like \1 no longer get confused
by differing case.
(Jay Neubrand, #2419)
- add, commodities, and diff now support the --conf and -n/--no-conf flags,
like other commands.
#2446
- On Windows machines, the add command now properly shows green prompts instead of ANSI codes.
#2410
- Balance reports now properly show the historical balance even when the report period is empty.
#2403
- Balance reports' csv output, and the bal

Release notes
hledger 1.43.2
- hledger no longer shows an error message or exits with error status
when its output is truncated in a piped command. (This broke in 1.43.) #2405
- The add command's doc now describes how it interacts with balance assertions
and balance assignments. #2406
- aregister now consistently rounds amounts to display precision again.
(This broke in 1.32.) #2407
- Changelog, release notes: mention improved decoding errors #73;
add missing issue numbers
hledger-ui 1.43.2
- Use hledger-1.43.2
hledger-web 1.43.2
- Use hledger-1.43.2
- Add missing issue numbers in the changelog
credits 1.43.2
Simon Michael.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.43.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.43.2
Mac, 64-bit ARM or Intel
In a terminal window (don't use your web browser to download, it won't authorise the binaries):
On ARM macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.43.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.43.2
On Intel macs:
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.43.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.43.2
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.43.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.43.2
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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.43.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.
Next steps
Once installed, run hledger, and perhaps read hledger.org: Q

Release notes
hledger 1.43.1
Fixes
- cur: in posting-based reports like balance and register once again
filters multicommodity amounts as it should. #2396
- More error messages were made consistent, hiding call stack etc. #2367
Docs
- Query types: clarify that amt: filters postings #2396
- More text encoding corrections/cleanups #2394
hledger-ui 1.43.1
- More error messages were made consistent, hiding call stack etc. #2367
- Allow brick 2.9
hledger-web 1.43.1
Fixes
- Fixed a compilation error when not in the hledger source tree. #2397
project changes 1.43.1
- tools:
- Shake changelogs: fix missing blank lines around old heading
- ghcruns-download: make tmp dir
- docs:
RELEASING
credits 1.43.1
Simon Michael.
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.43.1/hledger-linux-x64.tar.gz
tar xzf hledger-linux-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version # should show 1.43.1
Mac, 64-bit ARM or Intel
In a terminal window (don't use your web browser to download, it won't authorise the binaries):
On ARM macs:
cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.43.1/hledger-mac-arm64.tar.gz
tar xzf hledger-mac-arm64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version # should show 1.43.1
On Intel macs:
cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.43.1/hledger-mac-x64.tar.gz
tar xzf hledger-mac-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version # should show 1.43.1
Windows, 64-bit ARM or Intel
In a powershell window (press WINDOWS-R, powershell, ENTER):
1. Make a place to keep installed binaries. You only need to do this once, not for every release:
mkdir -force $HOME\bin >$null
$ENV:PATH += ";"+$HOME+"\bin"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
2. Download and install the release binaries:
cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/1.43.1/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath . -Force
cd $HOME
hledger --version; hledger-ui --version; hledger-web --version # should show 1.43.1; if not, check why: where.exe hledger
3. Ensure a default journal file exists, and without a problematic encoding (I'm not sure if/why "ascii" was needed here).
This will allow you to start hledger-web by double-clicking on its icon if you wish.
out-file -append -encoding ascii $HOME/.hledger.journal
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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 Windo

Release notes
hledger 1.42.1
Fixes
- Fix a regression in the parsing of single ampersands (&) in csv rules.
(Thomas Miedema, #2352)
- The run and repl commands no longer cache data wrongly when using the --forecast option.
(Dmitry Astapov, #2345)
- The run and repl commands no longer miss a caching opportunity when using --forecast with a period argument.
(Stephen Morgan)
- run, repl: doc fixes (Pranesh Prakash, Simon Michael)
hledger-ui 1.42.1
- Allow vty 6.4.
hledger-web 1.42.1
project changes 1.42.1
Infrastructure/Misc
- Tools updates
- Fix cabalfilestest: test all cabal files before any hackage upload.
credits 1.42.1
Simon Michael (@simonmichael),
Dmitry Astapov (@adept),
Pranesh Prakash (@the-solipsist),
Stephen Morgan (@Xitian9),
Thomas Miedema (@thomie).
Install
For all install options, see 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.
All platforms
If you have eget, that's a convenient way to download the right binaries for your machine:
eget simonmichael/hledger --all
Otherwise:
GNU/Linux, 64-bit Intel
At the command line:
cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.1/hledger-linux-x64.tar.gz
tar xzf hledger-linux-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version # should show 1.42.1
Mac, 64-bit ARM or Intel
In a terminal window (don't use your web browser to download, it won't authorise the binaries):
On ARM macs:
cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.1/hledger-mac-arm64.tar.gz
tar xzf hledger-mac-arm64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version # should show 1.42.1
On Intel macs:
cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.1/hledger-mac-x64.tar.gz
tar xzf hledger-mac-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version # should show 1.42.1
Windows, 64-bit ARM or Intel
In a powershell window (press WINDOWS-R, powershell, ENTER):
1. Make a place to keep installed binaries. You only need to do this once, not for every release:
mkdir -force $HOME\bin >$null
$ENV:PATH += ";"+$HOME+"\bin"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
2. Download and install the release binaries:
cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/1.42.1/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath . -Force
cd $HOME
hledger --version; hledger-ui --version; hledger-web --version # should show 1.42.1; if not, check why: where.exe hledger
3. Ensure a default journal file exists, and without a problematic encoding.
This will allow you to start hledger-web by double-clicking on its icon if you wish.
out-file -append -encoding ascii $HOME/.hledger.journal
(I'm not sure why "ascii" is needed here - hledger likes utf8 and understands utf8 BOM headers,
but the state of our unicode support on Windows
is really unknown, your feedback is welcome.)
Windows 7, 64-bit Intel
These instructions have not been tested recently, please let us know 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 extracte

Release notes
Config file support, sortable register, FODS output, prettier tables, show options in manuals.
hledger 1.40
Fixes
- Account tags (and type declarations) declared in multiple files are now combined correctly. #2202
- Several kinds of report interval now choose a better start date:
- every Nth day of month from DATE with periodic transactions #2218
- every M/D from DATE
- every Nth WEEKDAY from DATE
- The balance commands' html output no longer repeats the "Total" and "Net" headings when the totals row has multiple lines. And the layout has been improved and made more consistent with the text output.
- The --tldr flag now also works with the tealdeer tldr client.
Features
- You can now save command line options in a config file, to be added to your hledger commands either on demand or automatically. (This supersedes the older arguments files feature.) This has been a popular feature request. It has pros and cons, and is experimental; your testing and feedback is welcome. It changes the nature of hledger somewhat, which I have marked by giving this release a more memorable version number (1.40).
- The balance commands can now output in FODS format, an XML spreadsheet file format readable by LibreOffice. (Henning Thielemann)
- The register report can now be sorted by date, description, account, amount, absolute amount, or a combination of these. (Michael Rees, #2211)
Improvements
- Command line processing has been overhauled and should be more robust in certain cases, with tweaked error messages and debug output. Command-specific flags can now optionally appear before the command name. (Though writing them afterward is usually more readable. Addon-specific flags must still come last, after --.)
- The --rules-file option has been renamed to --rules. The old spelling is still supported as a hidden option.
- Weekly reports' week headings are now more compact, especially in single-year balance reports. (#2204, Victor Mihalache)
- The balance command with no report interval, and also balance --budget, now support html output. (Henning Thielemann)
- In balance commands' html and csv output, "Total:" and "Net:" headings are now capitalised consistently.
- bs/cf/is reports now show the report interval in their title.
- The balance commands' text output with the --pretty flag now shows an outer table border and inter-column borders.
- The check recentassertions error message is now more readable.
- Timedot format now allows comment lines to be indented.
- When running the tldr-node-client client, auto-update of the tldr database is now suppressed.
- When running a tldr client fails, the warning now mentions the required --render flag. #2201
- The error message for unsupported regular expressions like (?:foo) has been improved.
- --debug has moved to "General help flags", making it available in more situations.
- Some verbose debug output from command line processing has been demoted to level 2.
- Parsing timedot files now gives debug output at level 9.
- Allow doclayout 0.5.
Docs
- The hledger/hledger-ui/hledger-web manuals now list all command options as shown by --help.
- Added an example config file, hledger.conf.sample.
- The diff and prices commands' help layout has been improved.
- add's doc described the effect of D wrongly, now fixed.
- Date adjustments: rewrites and corrections
- Period headings: added
- Input: clarify that multiple -f options are allowed
- Scripts and add-ons: edits, list add-ons again
- Timeclock: edits, fix ti/to scripts
- Fixed "hledger and Ledger" links [hledger_site#112]
- examples/csv: Monzo CSV rules added
- examples/csv: Tiller CSV rules added
- examples/csv: Nordea CSV rules added (Arto Jonsson)
Scripts/addons
- bin/bashrc updates; add years, eachyear scripts
- bin/hledger-simplebal: ignore config files
- bin/hledger-script-example: explain shebang commands better
- bin/hledger-register-max: update/fix
hledger-ui 1.40
Improvements
- The menu screen now supports the shift arrow and shift T k

Release notes
hledger 1.34
Breaking changes- check ordereddates no longer supports --date2. Also (not a breaking change): --date2 and secondary dates are now officially deprecated in hledger, though kept for compatibility.
Features- You can now get a quick list of example command lines for hledger or its most useful subcommands by adding the --tldr flag (or just --tl). For best appearance you should install the tldr client, though it's not required.These short "tldr pages" are a great counterbalance to verbose PTA docs. You can also use tldr without hledger to view the latest versions, or translations: tldr hledger[-COMMAND]. Or you can browse tldr pages online. Consider contributing translations! More tips at .
Improvements- The hledger commands list has been reorganised, with commands listed roughly in the order you'll need them.
- The general flags descriptions in --help have been updated and grouped.
- Correctness checks now run in a documented order. commodities are now checked before accounts, and tags before recentassertions. When both ordereddates and assertions checks are enabled, ordereddates now runs first, giving more useful error messages.
- -I/--ignore-assertions is now overridden by -s/--strict (or check assertions), enabling more flexible workflows. Eg you can alias hl="hledger -I" to delay balance assertions checking until you add -s to commands.
- --color and --pretty now also accept y or n as argument.
- When built with the ghcdebug flag and started with --debug=-1, hledger can be controlled by ghc-debug clients like ghc-debug-brick or a ghc-debug query script, for analysing memory/profile info.
Fixes- hledger COMMAND --man and hledger help TOPIC --man now properly scroll the man page to the TOPIC or COMMAND heading. The exact/prefix matching behaviour has been clarified in help --help.
- In journal files, include directives with trailing whitespace are now parsed correctly.
- The help command's help flags are now consistent with other commands (and it has --debug as a hidden flag).
- Build errors with GHC 8.10 have been fixed. #2198
Docs- The tables of contents on hledger.org pages now just list top-level headings, (and the hledger manual structure has been adjusted for this). This makes the hledger manual on hledger.org more scannable and less scary.
- add: drop lengthy transcript, add simpler example commands (from tldr)
- Amount formatting: move down, it's not the best first topic
- balance: mention the --summary-only flag
- check: expand check descriptions
- examples: CSV rules: vanguard, fidelity, paypal updates
- Generating data: rewrite
- JSON output: link to OpenAPI spec
- manuals: synopsis, options cleanup/consistency
- Options: correction, NO_COLOR does not override --color
- PART 4: COMMANDS: reorganise into groups, like the CLI commands list.
- Period expressions: mention last day of month adjusting #2005
- Secondary dates: expand, and declare them deprecated.
- Time periods cleanup, simplify markup
- Unicode characters: mention UTF-8 on windows
Scripts/addons- Added hledger-pricehist, an alias for the pricehist market price fetcher so that it can appear in hledger's commands list.
hledger-ui 1.34
Features- You can now get a quick list of example command lines by running with --tldr (or just --tl). For best appearance, install the tldr client, though it's not required.
Improvements- The general flags in --help have been updated and grouped, consistent with hledger.
- When built with the ghcdebug flag and started with --debug=-1, hledger-ui can be controlled by ghc-debug clients like ghc-debug-brick or a ghc-debug query script, for analysing memory/profile info.
hledger-web 1.34
Features- You can now get a quick list of example command lines by running with --tldr (or just --tl). For best appearance, install the tldr client, though it's not required.
Improvements- The general flags in --help have been updated and grouped, consistent with hledger.
- When built with the ghcdebug flag and started wi

Release notes
hledger 1.33.1
- process >=1.6.19.0 seems not strictly needed and is no longer required,
improving installability.
#2149
- print and close now show a trailing decimal mark on cost amounts also,
when needed to disambiguate a digit group mark.
- The balance commands' HTML output now includes digit group marks when
appropriate (fixes a regression in 1.25).
#2196
- The add command no longer shows ANSI escape codes in terminals that
don't support them.
- Doc updates:
- import: Skipping -> Date skipping, discuss commodity styles more
- csv: Amount decimal places: expand, note import behaviour
hledger-ui 1.33.1
- Require vty-windows-0.2.0.2+ to avoid display problems in recent
MS Terminal on Windows.
- process >=1.6.19.0 seems not strictly needed and is no longer required,
improving installability.
#2149
hledger-web 1.33.1
- Support base64 >=1.0
credits 1.33.1
- Simon Michael (@simonmichael)
How to install
This release may arrive in your local packaging system soon - look for green badges at hledger.org: Install.
Or you can build it yourself from source, as described on that page.
Or you can use the binaries below:GNU/Linux on 64-bit Intel
At the command line,

cd /usr/local/bin
curl -LOC- # just rerun if interrupted
unzip hledger-linux-x64.zip && tar xvf hledger-linux-x64.tar && rm -f hledger-linux-x64.{zip,tar} # github workaround, preserves permissions
cd
hledger --version # should show the new version

The tar + zip packaging is a workaround to preserve file permissions.Mac on 64-bit ARM or Intel
In a terminal window, run these commands to download, unpack, authorise, and install the binaries in your command line PATH.
Don't use your web browser, it won't authorise the binaries.:

cd /usr/local/bin

# for ARM macs:
curl -LOC- # just rerun if interrupted
unzip hledger-mac-arm64.zip && tar xvf hledger-mac-arm64.tar && rm -f hledger-mac-arm64.{zip,tar} # github workaround, preserves permissions

# or for Intel macs:
curl -LOC-
unzip hledger-mac-x64.zip && tar xvf hledger-mac-x64.tar && rm -f hledger-mac-x64.{zip,tar}

cd
hledger --version # should show the new version

The tar + zip packaging is a workaround to preserve file permissions.Windows on 64-bit Intel or ARM
In a powershell window (press Windows-r, type powershell, press enter),- Make a place to keep hledger binaries, and add it to your PATH; this makes running hledger easier. You only need to do this once, not for every release:

mkdir -force $HOME\bin >$null
$ENV:PATH += ";"+$HOME+"\bin"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)

- Download and install the release binaries:

cd $HOME\bin
cp hledger.exe hledger.old.exe # keep a backup of the old executables, if you care
cp hledger-ui.exe hledger-ui.old.exe
cp hledger-web.exe hledger-web.old.exe
curl -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath . -Force
cd $HOME
hledger --version # should show the new version
hledger-ui --version
hledger-web --version

- Ensure a default journal file exists, and without a problematic encoding.
(Not sure why "ascii" is needed here - hledger likes utf8 and understands utf8 BOM headers..
but the state of our unicode support on Windows
is really unknown, your input welcome.)

out-file -append -encoding ascii $HOME/.hledger.journal

Once that journal file exists, you can start hledger-web by double-clicking on the icon if you wish.Windows 7 on 64-bit Intel
- 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 extrac

Next steps
- https://hledger.org -> Quick start