Releases · simonmichael/hledger

08 Mar 16:32

9372ab0

Nightly Pre-release

Pre-release

Here you can find unreleased "nightly" binaries, which are updated occasionally. By using these and providing feedback, you can help to make the next release better.

These binaries have the following changes since the 1.50.2 release: 1.50.2...nightly

Install

All platforms

If you have eget, that's a convenient way to download the right binaries for your machine:

eget simonmichael/hledger --pre-release --all

Otherwise:

GNU/Linux, 64-bit Intel

At the command line:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-linux-x64.tar.gz
tar xzf hledger-linux-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version    # should show a recent .99 version

Mac, 64-bit ARM or Intel

In a terminal window (don't use your web browser to download, it won't authorise the binaries):

For ARM macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-mac-arm64.tar.gz
tar xzf hledger-mac-arm64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version    # should show a recent .99 version

For Intel macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-mac-x64.tar.gz
tar xzf hledger-mac-x64.tar.gz
cd
hledger --version; hledger-ui --version; hledger-web --version    # should show a recent .99 version

Windows, 64-bit ARM or Intel

In a powershell window (press WINDOWS-R, powershell, ENTER):

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)

Download and install the release binaries:

cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/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 refs/tags/1.42.99; if not, check why: where.exe hledger

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

Assets 6

27 Sep 01:47

simonmichael

1.50.2

ae0e755

1.50.2 Latest

Latest

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

Contributors

simonmichael and hseg

Assets 6

16 Sep 13:50

simonmichael

1.50.1

221f1be

1.50.1

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

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.

hledger-web 1.50.1

Uses hledger 1.50.1

credits 1.50.1

Simon Michael (@simonmichael),
Stephen Morgan (@Xitian9).

Install

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, 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.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 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.

Contributors

simonmichael and Xitian9

Assets 6

03 Sep 19:11

simonmichael

1.50

75c3b2c

1.50

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]
The import command now shows info messages (such as the dry run "; would import .." message)
on stderr, not stdout.
Also the "no new transactions" output is more compact, showing file names not file paths;
and it no longer prints an extra newline.
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 balance --budget report, now respect the --summary-only flag.
(Stephen Morgan, [#2411], [#2443])
The demo command no longer mentions -- ASCIINEMAOPTS in help (that longer works).
Also it shows a better error message when asciinema is not installed.
hledger help -m TOPIC or hledger help -i TOPIC now show the help for TOPIC, as intended.
[#2399]
Since hledger 1.32.1, the import command, when importing multiple files at once,
would write an empty .latest file for data files with no new transactions
(causing all transactions in those data files to appear new on next import).
This is now fixed.
[#2444]

Features

CSV rules files can now run a shell command to clean the data:

# read the latest foo*.csv file, and replace "USD" with "$"
source foo*.csv | sed -e 's/USD/$/g'

or to generate the data:

# fetch JSON from simplefin.org, then transform it to CSV
source | simplefinjson | simplefincsv

Whenever hledger runs one of these commands, it will echo the command on stderr.

The import command can now automatically archive imported CSV data files,
saving a dated copy in a data/ directory. This can be useful for troubleshooting,
or for regenerating entries later with improved rules.
To enable it, add archive to the rules file.

This and the previous feature can simplify file management and reduce the need for support scripts.

Improvements

In command line help, flag group headings have been simplified.
And the help for -f/--file, add, and import is now clearer.
When given both an unknown command and an unknown flag, hledger now gives
a clearer error message (about the command, not the flag).
[#2388]
A long standing awkwardness with addon commands has been solved:
you can now use addon options freely in a hledger command line;
you don't need to write a -- argument first.
[#458]
In smart dates and period expressions, quarter syntax like 2025q1 or Q2 is now fully supported.
In end-value reports where the end date is unspecified, market prices
in the future can no longer influence the report end date and valuation date.
(Market prices on or before today, still can.)
[#2445]
A tag: query with the accounts command now only matches account tags, not posting tags.
Eg, hledger accounts tag:t now lists only account a from this journal:
```
account a  ; t:

2025-01-01
    a          1
    b         -1  ; t:
```
Journal format's include directive now has more robust and convenient glob patterns:
- ** can match both directories and filenames
- ** now automatically ignores anything under dotted directories, like .git/, foo/.secret/, etc.
  (If you do want it to search dotted directories,
  you can use the --old-glob flag for now to restore the old behaviour. See also Glob#49.)
- Glob patterns with wildcards now automatically exclude the current file.
  Eg include **.journal will include all other .journal files in this directory and below.
include's error messages and debug messages have been improved.
Eg, the including file paths are also shown.
Journal format's auto posting rules can now use %account to insert the account name
from the matched posting.
(Stephen Morgan, [#1975], [#2412])
The aregister command no longer abbreviates account names
when producing csv, html, or fods output.
(savanto, [#1995], [#2416])
The commodities, payees and tags commands now have --used/--declared/--undeclared/--unused flags, like accounts.
And there has been a general cleanup of options and help across these four commands.
The setup command's output has been improved.
Lack of a pager is now reported as info, not warning (there's no default pager on Windows).
Shell completions are ignored for now.

Docs

add: clarify that add is for journal format only
addon commands: edits, drop -- argument from all examples [#458]
areg: clarification
bin: README updates
COMMANDS: mention general options
completions: README updates
config files: no longer experimental
csv: date-format: mention lack of support for local time formats [#1874]
csv: source, archive: rewrite, add examples
Depth: fix typo
github release docs: simplify install commands
import: use windows-compatible quotes in watchexec example
include directive: update docs; clarify effect, glob limitations
note fish LEDGER_FILE setup
options: mention that flag+value can't combine with other flags [#2059]
print: improve --location help
smart dates: fix typo

Examples

CSV rules for Eternl cryptocurrency wallet
VAT example

Scripts/addons

renamed paypaljson2csv to paypaljson
simplefinjson, simplefincsv: new helpers for downloading/converting data from simplefin.org bank aggregator

hledger-ui 1.50

Breaking changes

hledger now requires at least GHC 9.6 (and base 4.18), to ease maintenance.

Improvements

Use hledger 1.50

hledger-web 1.50

Breaking changes

hledger now requires at least GHC 9.6 (and base 4.18), to ease maintenance.

Fixes

The register chart is no longer hidden when the window is narrow.
Dragging on the register chart now selects date ranges more accurately.
Eg, now you can select a range including transactions at the rightmost edge of the chart.

Improvements

Use hledger 1.50

project changes 1.50

Doc updates

FINANCE
ISSUES
REGRESSIONS
RELEASING
SCHEDULE & just schedule...

Contributors

simonmichael, lfos, and 3 other contributors

Assets 6

13 Jun 22:11

simonmichael

1.43.2

edbf4d4

1.43.2

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

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: Quick start.

Assets 6

04 Jun 17:24

simonmichael

1.43.1

4c78c96

1.43.1

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

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):

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)

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

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 Windows-r, type CMD, press enter)
hledger --version; hledger-ui --version; hledger-web --version should show 1.43.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 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.

Assets 6

01 Jun 23:08

simonmichael

1.43

0d7c251

1.43

Release notes

hledger 1.43

new setup command, better boolean queries, add assertions, timeclock concurrent sessions, CSV if rules debug output

Breaking changes

Timeclock format now supports multiple simultaneous clocked-in sessions.
A clockout entry can reference the account name of the clockin it is ending,
otherwise it will end the most recent clockin.

This is a potentially breaking change, because we previously ignored
the description on clockout entries. For now, you can restore the
old behaviour by adding the --timeclock-old flag. This may be
removed later, so if you needed it, please let us know!
(Michael Rees, #2141)

Fixes

Some boolean queries involving amt: or cur: did not match correctly; now they do.
(Simon Michael, Stephen Morgan, #2371, #2373, #2387)
The roi command has fixed a bug with PnL attributed to the wrong period.
(Dmitry Astapov, #2391)
For a long time, hledger docs stated that hledger's input and output had to be UTF-8 encoded.
In fact this was wrong; hledger has always used the system locale's encoding for both.
Docs like Install: Text encoding
and hledger: Text encoding
have been updated.
#2394
CLI error messages now have consistent format independent of the GHC
version hledger was compiled with. #2367

Features

A new setup command checks your hledger installation and shows information
useful for troubleshooting. It will do more in future.
For now, setup should be reliable and accurate;
please test it on all your machines and share the results with us.
Experimental.

When you run this command, hledger attempts one HTTP request, with a 10s timeout,
to hledger.org, to detect the current release version.
New any:"BOOLEANQUERY" and all:"BOOLEANQUERY" queries can be
used with transaction-matching commands like print and import.

Unlike expr:"BOOLEANQUERY", where the parts of the boolean query
are allowed to match different postings in the transaction,
with any: and all: the entire boolean query must match a single posting.
any: matches the transaction if any posting is matched,
all: matches the transaction if all postings are matched.
The add command now allows balance assertions to be added, after an amount.
Also, whenever you enter an amount, it now checks the journal's balance assertions
and will not allow adding an amount that would cause assertion failure
(unless you use the -I/--ignore-assertions flag).
(Michael Rees, #2355, #2356)
The hledger-print-location script, which shows transactions' file positions,
is now built in to print as the --location flag.
(Sam Salmahri, #2368)

Improvements

Core data types are now more strict, which in some cases reduces memory and time usage by up to 15%.
(Stephen Morgan, #2381, #2385, #2387)
Config files (and maybe timedot files) no longer require a final newline.
In journal format, include directives can now have same-line comments.
CSV if rules now produce more --debug=2 output, useful for troubleshooting.
CSV debug output now displays records as the if matchers see them.
(Comma separated and with quotes and outer whitespace removed.)
A number of error messages have been updated to show a consistent format.
(reading a nonexistent data file,
reading an unsafe dotted file name on Windows,
demo not found,
demo asciinema error,
diff bad arguments,
print --match with no match,
register --match with no match,
roi with no investment transactions).
#2367
When unicode/non-ascii text can't be decoded by the system locale's text encoding,
we now show a consistent informative error message explaining it. #73
Support GHC 9.12.

Docs

Account types: rewrite
Assertions and multiple files: edits
Balance assertions and multiple files
balance: edits
Beancount output: edits
check: edits
Config file: drop the s
CSV: clarify that CSV means delimiter-separated values, link to wikipedia DSV page
CSV:description field: fix link hledger_site#133
Fix broken hledger-iadd link
Fix various broken "Commodity display style" links (JB Rainsberger, Simon Michael, [hledger_site/#132])
How CSV rules are evaluated: clarify
Journal: cheatsheet edits
print: simplify #2368
Queries: discuss transaction vs posting queries; cleanups
Queries: fix the explanation of boolean queries and space-separated terms

Examples

examples/csv/nps.csv.sh updated (Pranesh Prakash)
examples/forecast-budget* -> examples/goal-budget*
examples/i18n/*.journal: top level account declarations in several languages.
examples/quickstart.journal: the quickstart journal from the home page

Scripts/addons

bin/balance-as-budget-multi.hs (Dmitry Astapov)
bin/bashrc: command alias updates
bin/hledger-sankeymatic

API

Hledger.Cli.Conf: make getConf total, add getConf'
Hledger.Cli.Version: add more version helpers, rename HledgerBinaryInfo

hledger-ui 1.43

Fixes

Require fsnotify >=0.4.2.0, which fixes some events being ignored on mac,
possibly making hledger-ui --watch more reliable in this regard.

Improvements

CLI error messages now have consistent clean format independent of GHC version. #2367
Support GHC 9.12.

Docs

Update --watch docs.
Drop obsolete mention of Windows non-support.

hledger-web 1.43

Features

Serve openapi.json, documenting the hledger-web HTTP API so that tools
like open-webui and LLMs can query hledger-web for context.
(Ben Sima)

Improvements

The search help popup has been updated, and now shows the hledger-web version.
The default "serve and browse" mode now has an explicit --serve-browse mode flag, for consistency.
The old --server flag is now deprecated and hidden. Use --serve instead.
CLI error messages now have consistent clean format independent of GHC version. #2367
Fix capitalisation in Sandstorm app metadata.
Support GHC 9.12.
Drop base-compat dependency (Thomas Miedema)

Docs

Fix outdated PERMISSIONS doc.

project changes 1.43

Docs

Updated:
FILES,
FINANCE,
ISSUES,
PULLREQUESTS,
REGRESSIONS,
RELEASING,
ghrelnotes,
relnotes

Infrastructure/Misc

issue labels updates, severity* -> annoyance*, impact* -> affects*
new shortcut urls: assignedprs.hledger.org, unassignedprs.hledger.org
clean up LICENSE files, main module licensing headers, add AUTHORS.md, try to fix github license detection
cabal files now specify GPLv3+ exactly. #2359
building the hledger packages now requires at least Cabal 2.2+ or stack built with Cabal 2.2+ (was 1.12+).
avoid a ghci warning if :rmain is defined in user's config.
simplify stack yaml file names
workflows updates:
- binaries*: simplify, cleanup
- binaries-linux-x64: install ghcup only if not cached; fix cache
- windows: use preinstalled stack
- docker: draft of a docker image build/publish workflow (Doug Goldstein, #2002)
- nightly: adds latest binaries to the "nightly" release
tools updated:
binaries,
devtag-push,
ghnightly,
ghnightly-bin,
ghnightlynotes-push,
ghrel,
ghrelease-upload,
ghrelnotes-push,
ghrun,
ghrun-id,
ghrun-open,
ghruns,
ghruns-download,
ghruns-open,
hackageupload,
nightly,
nightlybin,
nightlytag

credits 1.43

Simon Michael (@simonmichael),
Michael Rees (@reesmichael1),
Thomas Miedema (@thomie),
Dmitry Astapov (@adept),
Pranesh Prakash (@the-solipsist),
Stephen Morgan (@Xitian9),
Sam Almahri (@samahri),
Ben Sima (@bsima),
Doug Goldstein (@cardoe).

Install

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

Contributors

cardoe, simonmichael, and 7 other contributors

Assets 6

16 May 23:48

simonmichael

1.42.2

037730e

1.42.2

Release notes

hledger 1.42.2

Fixes

The test command can pass options to tasty again (this broke in 1.42).
Also, any arguments before -- are now passed to tasty as test-selecting -p options.
#2386
Require extra >= 1.7.11, fixing the stack8.10.yaml build. (Thomas Miedema)

Docs

CSV encoding: fix inaccurate list of encoding names. #2354
Fix broken links to "Commodity display style". (Simon Michael, J.B. Rainsberger hledger_site#132)
Misc. edits/fixes: beancount output, commands list, balance command, hledger-iadd link, csv tutorial link

hledger-ui 1.42.2

Fixes

Require fsnotify-0.4.2.0+/hfsevents-0.1.8+, which fixes some events
being ignored on mac (see luite/hfsevents#19),
which should help hledger-ui --watch a little.
Require extra >= 1.7.11, fixing the stack8.10.yaml build. (Thomas Miedema)

Docs

Update --watch notes
Drop obsolete Windows non-support note

hledger-web 1.42.2

Fixes

Don't hang when saving a large file (this broke in 1.42). #2389
Require extra >= 1.7.11, fixing the stack8.10.yaml build. (Thomas Miedema)

project changes 1.42.2

Docs

relnotes: fix links to hackage changelogs

credits 1.42.2

Simon Michael (@simonmichael),
Thomas Miedema (@thomie).

Install

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.2/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.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:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.2/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.2

On Intel macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42.2/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.2

Windows, 64-bit ARM or Intel

In a powershell window (press WINDOWS-R, powershell, ENTER):

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)

Download and install the release binaries:

cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/1.42.2/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.2; if not, check why: where.exe hledger

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 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.42.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: Quick start.

Contributors

simonmichael and thomie

Assets 6

13 Mar 07:59

simonmichael

1.42.1

daafa05

1.42.1

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

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):

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)

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

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 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.42.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 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.

Contributors

simonmichael, adept, and 3 other contributors

Assets 6

08 Mar 04:17

simonmichael

1.42

36ef67b

1.42

Release notes

run & repl commands, non-UTF8 CSV, same-line if matchers, more pivot targets, fixes.

hledger 1.42

Fixes

hledger's default options for the less pager no longer include --use-color,
which caused older less versions (eg 551) to break. #2335
In balance --budget reports, costs no longer prevent display of percentages. #2327
In the balance command's HTML output, -H/--historical now suppresses the total heading.
print --help now shows the correct default for --round. #2318
close --infer-costs no longer implies the -x/--explicit flag. #1826
add: Account names provided on the command line are no longer ignored. #2305
bs/bse/cf/is no longer show the unsupported --budget option in their help. #2302
The print command now ignores --depth entirely. Previously, a depth
limit caused it to show only transactions referencing accounts as
deep or deeper than that.
Week periods beginning in the previous year are now shown correctly.
Eg the week beginning 2024-12-30 (which is week 1 of 2025 because the
thursday falls in 2025) was previously shown as 2024-W01, and is now shown as 2025-W01.
#2304

Features

run and repl are new commands which run multiple commands
without re-parsing data files, so they run faster.
run runs a sequence of commands from files or command line arguments,
and repl provides an interactive prompt with readline-style history.
(Dmitry Astapov, Simon Michael, #2323, #2328)
commands is a new explicit command for showing the commands list; it's useful in the REPL.
With --builtin, it shows only the builtin commands.
hledger can now read CSV/SSV/TSV data in encodings other than UTF8,
using the new encoding CSV rule. (Joschua Kesper, #2319)
if matchers in CSV rules can now be combined on the same line,
separated by && (AND) or && ! (AND NOT). This makes if tables more expressive.
Examples:
```
if %description amazon && %date 2025-02-22
    account2 expenses:books

if,account2
%description amazon && %date 2025-02-22, expenses:books
```
The next-line & operator also may now be written as &&, for consistency.
(Thomas Miedema, #2333)

Improvements

Terminal width is now detected more robustly, using the POSIX API.
This means that register commands will more reliably use the proper terminal width,
eg when $TERM or $COLUMNS do not have a correct value, and on Windows.
hledger no longer uses $COLUMNS.
(gesh, #2332, #2340)
Error messages (first line) in the terminal are now shown in red (and bold),
and warning messages are shown in yellow,
when ANSI codes are supported and permitted.
--pivot can now also pivot on amount quantity (amt),
amount cost (cost), and/or commodity symbol (comm or cur).
The close command's --migrate flag has been renamed to --clopen.
The start: tag has been renamed to clopen:,
and its default value now excludes the new file's extension.
And close --assign's tag has been renamed to assign:.
The print command now supports the --invert flag. #2314
The roi command is now faster:
it no longer checks every day with P directive,
and the "one period per report interval" case has been optimised.
(Dmitry Astapov)
Two more file extensions are now recognised as possible hledger addon
commands: .osh and .ysh.

Docs

aregister: Drop an inconsistent newline from options help.
balance: improve --layout option help.
close: doc rewrites
shell completions: mention zsh; cleanups
cost/lot notations: clarify
cost, value reporting: edits
Directive effects: fix account types link #126
commodity styles: fix typo [hledger_site#123]
commodity directive: clarify
close: mention the balance assertions
pager: mention --pager=no
Aliases and account types: better troubleshooting command
Beancount output: mention limitations: P and balance assignments
Balance report output: drop outdated note about --tree and HTML #1846

Scripts/addons

hledger-balance-as-budget properly applies commodity styles now. (Dmitry Astapov)
hledger-git now runs pass-through git commands in the right repo.
hledger-git now checks for a git repo more robustly. (Lars Kellogg-Stedman)
hledger-jj is another easy CLI for keeping hledger files in version control,
using newer tech (jujutsu and oil shell's ysh).
hledger-script-example.hs has had some cleanup.

hledger-ui 1.42

Fixes

Startup arguments provided at the CLI are no longer passed to add when pressing the a key. #2313

Improvements

Allow vty 6.3.
Allow brick 2.8.

hledger-web 1.42

Fixes

Fix a test suite build issue: build it with -threaded.

project changes 1.42

Docs

new/updated: ACHIEVEMENTS, CREDITS, FINANCE, MOCKUPS, REGRESSIONS, RELEASING, Scripts
examples/csv: pooltool-rewards.csv.rule cleanup
examples: some sample hledger run scripts
examples: test files for CSV encoding #2319

Infrastructure/Misc

Unix bindists in github releases now include the man pages and info manuals. #2309
Unix bindists in github releases are now normal .tar.gz files, without the extra zip compression. [#2299]
Release notes and install instructions in github releases are now collapsed by default again.
This makes the sequence of dates and releases clearer.
Github automatically expands the assets of the latest release, so those will be visible by default.
For a full text search of all release notes, use the https://hledger.org/relnotes.html page.
hledger-install: if installing third party packages fails, it now tries again with bounds relaxed.
This makes hledger-iadd and hledger-interest more likely to install successfully,
even if their bounds have not yet been updated for a new hledger release.
just functest now fails if there are warnings.
(It does not force recompilation of already compiled modules,
but even so this should help catch more warnings before pushing them to CI.)
new/changed recipes/tools:
bench*.sh,
changelogs-catchup,
changelogs-finalise,
changelogs-reset,
devtag,
ghrelnotes,
ghrelnotes-publish,
log-headtail,
log-push,
log-save,
modulediag,
modulediags,
modulediags-view,
packagediags,
packagediags-view,
releasediag,
relnotes
relprep -> relbranch,
reltags,
reltags-push,
showrelnotes,
site-manuals-snapshot,
site-watch,
time,
tldr-diff
gitignore cleanups.

credits 1.42

Simon Michael (@simonmichael),
Dmitry Astapov (@adept),
gesh (@hseg),
Thomas Miedema (@thomie),
Joschua Kesper (@jokesper),
Lars Kellogg-Stedman (@larks).

Install

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

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

On Intel macs:

cd /usr/local/bin
curl -fLOC- https://github.com/simonmichael/hledger/releases/download/1.42/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

Windows, 64-bit ARM or Intel

In a powershell window...

Contributors

simonmichael, adept, and 4 other contributors

Assets 6

Uh oh!

Releases: simonmichael/hledger

Nightly

Install

All platforms

GNU/Linux, 64-bit Intel

Mac, 64-bit ARM or Intel

Windows, 64-bit ARM or Intel

Uh oh!

1.50.2

Release notes

hledger 1.50.2

hledger-ui 1.50.2

hledger-web 1.50.2

credits 1.50.2

Install

All platforms

GNU/Linux, 64-bit Intel

Mac, 64-bit ARM or Intel

Windows, 64-bit ARM or Intel

Windows 7, 64-bit Intel

Next steps

Contributors

Uh oh!

1.50.1

Release notes

hledger 1.50.1

hledger-ui 1.50.1

hledger-web 1.50.1

credits 1.50.1

Install

All platforms

GNU/Linux, 64-bit Intel

Mac, 64-bit ARM or Intel

Windows, 64-bit ARM or Intel

Windows 7, 64-bit Intel

Next steps

Contributors

Uh oh!

1.50

Release notes

hledger 1.50

hledger-ui 1.50

hledger-web 1.50

project changes 1.50

Contributors

Uh oh!

1.43.2

Release notes

hledger 1.43.2

hledger-ui 1.43.2

hledger-web 1.43.2

credits 1.43.2

Install

All platforms

GNU/Linux, 64-bit Intel

Mac, 64-bit ARM or Intel

Windows, 64-bit ARM or Intel

Windows 7, 64-bit Intel

Next steps

Uh oh!

1.43.1

Release notes

hledger 1.43.1

hledger-ui 1.43.1

hledger-web 1.43.1

project changes 1.43.1

credits 1.43.1

Install

All platforms

GNU/Linux, 64-bit Intel

Mac, 64-bit ARM or Intel

Windows, 64-bit ARM or Intel

Windows 7, 64-bit Intel

Next steps

Uh oh!

1.43

Release notes

hledger 1.43

hledger-ui 1.43