1.26.1

Release notes (https://hledger.org/release-notes.html#hledger-1-26-1)

hledger 1.26.1

• require safe 0.3.19+ to avoid deprecation warning

hledger-ui 1.26.1

• support doclayout 0.4, brick 0.72+

• require safe 0.3.19+ to avoid deprecation warning

Installing

At https://hledger.org/install, binary packages should be available for this release within a few days (look for green badges).

Or, you can build from source as described there, after cloning at tag 1.26.1:
git clone https://github.com/simonmichael/hledger --depth 1 -b 1.26.1

Or, if there are release binaries below suitable for your OS and hardware, you can use those.
Note: release binaries have been updated:

• 2022-07-31: binaries have been generated with commit b0822c9, slightly newer than the 1.26.1 tag
  to avoid a GHC bug. #1900

Here are some approximate per-platform instructions. (You can copy & paste each block of commands as a unit, to save time.)

GNU/Linux on 64-bit Intel

At the command line,

cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/1.26.1/hledger-linux-x64.zip   # can rerun this if interrupted
unzip hledger-linux-x64.zip
chmod +x hledger hledger-ui hledger-web
cd -
hledger --version  # should show the new version
touch $HOME/.hledger.journal   # ensure a default journal file exists

Mac on 64-bit Intel

In a terminal window,

cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/1.26.1/hledger-mac-x64.zip
unzip hledger-mac-x64.zip
chmod +x hledger hledger-ui hledger-web
open .
# for the hledger, hledger-ui, hledger-web icons: right-click the executable, Open, confirm it's ok to run

cd -
hledger --version  # should show the new version
touch $HOME/.hledger.journal   # ensure a default journal file exists

Windows on 64-bit Intel

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
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
$ENV:PATH += ";"+$HOME+"\bin"

Download and install the release binaries:

cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/1.26.1/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath .
rm hledger-windows-x64.zip
cd $HOME
hledger --version           # should show the new version

And ensure a default journal file exists:

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

Problems:

• Starting hledger/hledger-web by double-clicking their icon won't work; run them from a cmd or powershell window instead.

Next steps

Once installed, you could try these quick starts / tutorials:

• https://hledger.org/#how-to-get-started
• https://hledger.org/add.html
• https://hledger.org/ui.html
• https://hledger.org/web.html

1.26

Release notes (https://hledger.org/release-notes.html#hledger-1-26)

2022-06-04 hledger-1.26

Miscellaneous improvements.

hledger 1.26

Improvements

• register and aregister have been made faster, by

  • considering only the first 1000 items for choosing column
    widths. You can restore the old behaviour (guaranteed alignment
    across all items) with the new --align-all flag.
    (#1839, Stephen Morgan)

  • discarding cost data more aggressively, giving big speedups for
    large journals with many costs.
    (#1828, Stephen Morgan)

• Most error messages from the journal reader and the check command now use
  a consistent layout, with an "Error:" prefix, line and column numbers,
  and an excerpt highlighting the problem. Work in progress.
  (#1436) (Simon Michael, Stephen Morgan)

• hledger check ordereddates now always checks all transactions
  (previously it could be restricted by query arguments).

• The --pivot options now supports a status argument, to pivot on transaction status.

• Update bash completions (Jakob Schöttl)

Fixes

• Value reports with --date2 and a report interval (like hledger bal -VM --date2)
  were failing with a "expected all spans to have an end date" error since 1.22;
  this is now fixed.
  (#1851, Stephen Morgan)

• In CSV rules, interpolation of a non-existent field like %999 or %nosuchfield
  is now ignored (previously it inserted that literal text).
  Note this means such an error will not be reported;
  Simon chose this as the more convenient behaviour when converting CSV.
  Experimental.
  (#1803, #1814) (Stephen Morgan)

• --infer-market-price was inferring a negative price when selling.
  (#1813, Stephen Morgan)

• Allow an escaped forward slash in regular expression account aliases.
  (#982, Stephen Morgan)

• The tags command now also lists tags from unused account declarations.
  It also has improved command-line help layout.
  (#1857)

• hledger accounts now shows its debug output at a more appropriate level (4).

hledger-ui 1.26

• Uses hledger 1.26.

hledger-web 1.26

Fixes

• Don't add link URLs when printing.

Improvements

• Now builds with GHC 9.2.

• Uses hledger 1.26.

project changes 1.26

Scripts/addons

• renamed hledger-number.sh to hledger-simplebal

• added hledger-git, hledger-pijul

• fin (and bin) scripts show available scripts and their help

• renamed aliases.sh to bashrc

• Get hledger-print-location working. (Stephen Morgan)

Docs

• README cleanup, inspired by feedback from README reviewer Lars Wirzenius.

• Clearer sponsoring info and more complete sponsor lists on website and README.

• The new https://github.com/simonmichael/hledger_finance repo
  keeps track of our public finances (on Open Collective, Liberapay etc.)

Examples

• invoice: calculate dates accurately on last days of month

Process

• Stackage nightly and GHC 9.2 are now the default for dev builds.

• CI workflows:

  • Workflows and binaries have more consistent naming, mentioning platform and architecture.
  • The main test workflow is now linux-x64-test, replacing push and pull.
    It runs for both pushes and pull requests, and generates binaries on every run.
  • Pushes/merges to master, including Simon's, are required to have passed
    linux-x64-test on another github branch first.
  • Mac and Windows binaries are now stripped also (if applicable).

• make buildtimes, make buildtimes-cabal show GHC codegen times.

credits 1.26

Simon Michael,
Stephen Morgan,
Jakob Schöttl,
Patrik Keller.

Installing

At https://hledger.org/install, binary packages should be available for this release within a few days (look for green badges).

Or, you can build from source as described there, after cloning at tag 1.26:
git clone https://github.com/simonmichael/hledger --depth 1 -b 1.26

Or, if there are release binaries below suitable for your OS and hardware, you can use those.
(Release binaries have been updated:

• 2022-06-05: linux-x64 binaries updated to run at normal speed. #1867
• 2022-06-08: windows-x64 binaries fixed. #1869)

Here are some approximate per-platform instructions. (You can copy & paste each block of commands as a unit, to save time.)

GNU/Linux on 64-bit Intel

At the command line,

cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/1.26/hledger-linux-x64.zip   # can rerun this if interrupted
unzip hledger-linux-x64.zip
chmod +x hledger hledger-ui hledger-web
cd -
hledger --version  # should show the new version
touch $HOME/.hledger.journal   # ensure a default journal file exists

Mac on 64-bit Intel

In a terminal window,

cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/1.26/hledger-mac-x64.zip
unzip hledger-mac-x64.zip
chmod +x hledger hledger-ui hledger-web
open .
# for the hledger, hledger-ui, hledger-web icons: right-click the executable, Open, confirm it's ok to run

cd -
hledger --version  # should show the new version
touch $HOME/.hledger.journal   # ensure a default journal file exists

Windows on 64-bit Intel

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
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
$ENV:PATH += ";"+$HOME+"\bin"

Download and install the release binaries:

cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/1.26/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath .
rm hledger-windows-x64.zip
cd $HOME
hledger --version           # should show the new version

And ensure a default journal file exists:

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

Problems:

• Starting hledger/hledger-web by double-clicking their icon won't work; run them from a cmd or powershell window instead.

Windows 7 on 64-bit Intel, using Firefox

• 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 should show the new version
• echo # >> .hledger.journal to ensure a default journal file exists

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 because Explorer's command window is too small;
  configure that to be larger, or run hledger-web from a command window.
• hledger or hledger-web may fail to run if there is not enough memory available.

Next steps

Once installed, you could try these quick starts / tutorials:

• https://hledger.org/#how-to-get-started
• https://hledger.org/add.html
• https://hledger.org/ui.html
• https://hledger.org/web.html

1.25

Release notes (https://hledger.org/release-notes.html#hledger-1-25)

2022-03-04 hledger 1.25

Account type and tag querying, infer equity postings from @ notation, easily-consumed "tidy" CSV output.

hledger 1.25

Breaking changes

• Journal format's account NAME TYPECODE syntax, deprecated in 1.13, has been dropped.
  Please use account NAME ; type:TYPECODE instead.
  (Stephen Morgan)

• The rule for auto-detecting "cash" (liquid asset) accounts from account names
  for the cashflow report has been simplified.
  If you have been using the cashflow report, without explicitly declaring Cash accounts,
  you might notice a change, and might need to declare your Cash accounts explicitly
  (by adding type:C tags to top-level cash account directives).

Features

• The new type:TYPECODES query matches accounts by their accounting type.
  Account types are declared with a type: tag in account directives,
  or inferred from common english account names, or inherited from parent accounts,
  as described at Declaring accounts > Account types.
  This generalises the account type detection of balancesheet, incomestatement etc.,
  so you can now select accounts by type without needing fragile account name regexps.
  Also, the accounts command has a new --types flag to show account types.
  Eg:

  hledger bal type:AL  # balance report showing assets and liabilities
  hledger reg type:x   # register of all expenses
  hledger acc --types  # list accounts and their types
  

  (#1820,
  #1822)
  (Simon Michael, Stephen Morgan)

• The tag: query can now also match account tags, as defined in account directives.
  Subaccounts inherit tags from their parents.
  Accounts, postings and transactions can be filtered by account tag.
  (#1817)

• The new --infer-equity flag replaces the @/@@ price notation in commodity
  conversion transactions with more correct equity postings (when not using -B/--cost).
  This makes these transactions fully balanced, and preserves the accounting equation.
  For example:

  2000-01-01
    a             1 AAA @@ 2 BBB
    b            -2 BBB
  
  $ hledger print --infer-equity
  2000-01-01
    a                               1 AAA
    equity:conversion:AAA-BBB:AAA  -1 AAA
    equity:conversion:AAA-BBB:BBB   2 BBB
    b                              -2 BBB
  

  equity:conversion is the account used by default. To use a different account,
  declare it with an account directive and the new V (Conversion) account type.
  Eg:

  account Equity:Trading    ; type:V
  

  (#1554) (Stephen Morgan, Simon Michael)

• Normalised, easy-to-process "tidy" CSV data can now be generated with --layout tidy -O csv.
  In tidy data, every variable is a column and each row represents a single data point
  (cf https://vita.had.co.nz/papers/tidy-data.html).
  (#1768,
  #1773,
  #1775)
  (Stephen Morgan)

Improvements

• Strict mode (-s/--strict) now also checks periodic transactions (--forecast)
  and auto postings (--auto).
  (#1810) (Stephen Morgan)

• hledger check commodities now always accepts zero amounts which have no commodity symbol.
  (#1767) (Stephen Morgan)

• Relative smart dates may now specify an arbitrary number of some period into the future or past).
  Some examples:

  • in 5 days
  • in -6 months
  • 5 weeks ahead
  • 2 quarters ago

  (Stephen Morgan)

• CSV output now always disables digit group marks (eg, thousands separators),
  making it more machine readable by default.
  (#1771) (Stephen Morgan)

• Unicode may now be used in field names/references in CSV rules files.
  (#1809) (Stephen Morgan)

• Error messages improved:

  • Balance assignments
  • aregister
  • Command line parsing (less "user error")

Fixes

• --layout=bare no longer shows a commodity symbol for zero amounts.
  (#1789) (Stephen Morgan)

• balance --budget no longer elides boring parents of unbudgeted accounts
  if they have a budget.
  (#1800) (Stephen Morgan)

• roi now reports TWR correctly

  • when there are several PnL changes occurring on a single day
  • and also when investment is fully sold/withdrawn/discounted at the end of a particular reporting period.

  (#1791) (Dmitry Astapov)

Documentation

• There is a new CONVERSION & COST section, replacing COSTING.
  (#1554)

• Some problematic interactions of account aliases with other features have been noted.
  (#1788)

hledger-ui 1.25

• Uses hledger 1.25.

hledger-web 1.25

• Uses hledger 1.25.

project changes 1.25

Scripts/addons

• hledger-install.sh now also installs Pavan Rikhi's hledger-stockquotes tool.

• The bin/hledger-number addon was added.

• The bin/hledger-check-fancyassertions addon now shows docs in --help.

• A new invoice-making script was added: examples/invoicing/invoice-script/invoice

Process/tools

• The RELEASING doc and release process has been updated,
  and a new helper script added: tools/releaseprep.
  make hackageupload now only works from a branch named
  VERSION-branch or VERSION-release. Ie, making releases from master
  is no longer allowed, a release branch is always required,

• CI: The commitlint check is more robust, and now runs only in
  the push to master and pull request workflows, and not eg when
  building release binaries. linux-x64 binaries are now built
  with ghc 9.0, not 8.10. Workflow, branch, and binary names
  have been improved.

• make ghci-ui/make ghcid-ui now use older ghc 8.10 to avoid
  ghc 9.0-triggered failures.

• hls support: The hie.yaml added to help hls work on mac m1
  has been moved out of the way, since it probably makes things worse
  on other architectures.

credits 1.25

Simon Michael,
Stephen Morgan,
Dmitry Astapov,
Patrik Keller.

How to install

You can build this release from tag 1.25, or try the binaries below, or see https://hledger.org/install for other install methods.

About these binaries:
Download and unzip the appropriate zip file. Unix and mac users will need to chmod +x the binaries to make them executable. Mac users will need to mark them as trusted, eg right-click the file in Finder and option-click Open. Windows users will need to do something similar. There is no hledger-ui binary for Windows.

1.24.99.2 (1.25 preview 2)

This is an early preview of the WIP hledger 1.25, with binaries for easy installation by testers and early adopters. Your testing and feedback is appreciated and will make the final release better.

You can build this prerelease from tag 1.24.99.2, or try the CI binaries below. Download and unzip the appropriate zip file. Unix and mac users will need to chmod +x the binaries to make them executable. Mac users will need to mark them as trusted, eg right-click the file in Finder and option-click Open. WIndows users will need to do something similar. There is no hledger-ui binary for Windows.

Changes since 1.24

hledger 1.24.99.2 2022-02-05

Breaking changes

• Journal format's account NAME TYPECODE syntax, deprecated in 1.13, has been dropped.
  Please use account NAME ; type:TYPECODE instead.
  (Stephen Morgan)

• The rule for auto-detecting "cash" (liquid asset) accounts from account names
  for the cashflow report has been simplified.
  If you have been using the cashflow report, without explicitly declaring Cash accounts,
  you might notice a change, and might need to declare your Cash accounts explicitly
  (by adding type:C tags to top-level cash account directives).

Features

• The new type:TYPECODES query matches accounts by their accounting type.
  Account types are declared with a type: tag in account directives,
  or inferred from common english account names, or inherited from parent accounts,
  as described at Declaring accounts > Account types.
  This generalises the account type detection of balancesheet, incomestatement etc.,
  so you can now select accounts by type without needing fragile account name regexps.
  Also, the accounts command has a new --types flag to show account types.
  Eg:

  hledger bal type:AL  # balance report showing assets and liabilities
  hledger reg type:x   # register of all expenses
  hledger acc --types  # list accounts and their types
  

  (#1820, #1822) (Simon Michael, Stephen Morgan)

• The tag: query can now also match account tags, as defined in account directives.
  Subaccounts inherit tags from their parents.
  Accounts, postings and transactions can be filtered by account tag.
  (#1817)

• The new --infer-equity flag replaces the @/@@ price notation in commodity
  conversion transactions with more correct equity postings (when not using -B/--cost).
  This makes these transactions fully balanced, and preserves the accounting equation.
  For example:

  2000-01-01
    a             1 AAA @@ 2 BBB
    b            -2 BBB
  
  $ hledger print --infer-equity
  2000-01-01
    a                               1 AAA
    equity:conversion:AAA-BBB:AAA  -1 AAA
    equity:conversion:AAA-BBB:BBB   2 BBB
    b                              -2 BBB
  

  equity:conversion is the account used by default. To use a different account,
  declare it with an account directive and the new V (Conversion) account type.
  Eg:

  account Equity:Trading    ; type:V
  

  (#1554) (Stephen Morgan, Simon Michael)

• Normalised, easy-to-process "tidy" CSV data can now be generated with --layout tidy -O csv.
  In tidy data, every variable is a column and each row represents a single data point
  (cf https://vita.had.co.nz/papers/tidy-data.html).
  (#1768, #1773, #1775) (Stephen Morgan)

Improvements

• Strict mode (-s/--strict) now also checks periodic transactions (--forecast)
  and auto postings (--auto).
  (#1810) (Stephen Morgan)

• hledger check commodities now always accepts zero amounts which have no commodity symbol.
  (#1767) (Stephen Morgan)

• Relative smart dates may now specify an arbitrary number of some period into the future or past).
  Some examples:

  • in 5 days
  • in -6 months
  • 5 weeks ahead
  • 2 quarters ago

  (Stephen Morgan)

• CSV output now always disables digit group marks (eg, thousands separators),
  making it more machine readable by default.
  (#1771) (Stephen Morgan)

• Error messages improved:

  • Balance assignments
  • aregister
  • Command line parsing (less "user error")

Fixes

• --layout=bare no longer shows a commodity symbol for zero amounts.
  (#1789) (Stephen Morgan)

• balance --budget no longer elides boring parents of unbudgeted accounts
  if they have a budget.
  (#1800) (Stephen Morgan)

• roi now reports TWR correctly

  • when there are several PnL changes occurring on a single day
  • and also when investment is fully sold/withdrawn/discounted at the end of a particular reporting period.

  (#1791) (Dmitry Astapov)

Documentation

• There is a new CONVERSION & COST section, replacing COSTING. (#1554)

• Some problematic interactions of account aliases with other features have been noted. (#1788)

hledger-ui 1.24.99.2 2022-02-05

• Use hledger 1.24.99.2

hledger-web 1.24.99.2 2022-02-05

• Use hledger 1.24.99.2

hledger-lib 1.24.99.2 2022-02-05

• hledger-lib now builds with GHC 9.2 and latest deps. (#1774)

• Journal has a new jaccounttypes map.
  The journalAccountType lookup function makes it easy to check an account's type.
  The journalTags and journalInheritedTags functions look up an account's tags.
  Functions like journalFilterPostings and journalFilterTransactions,
  and new matching functions matchesAccountExtra, matchesPostingExtra
  and matchesTransactionExtra, use these to allow more powerful matching
  that is aware of account types and tags.

• Journal has a new jdeclaredaccounttags field
  for easy lookup of account tags.
  Query.matchesTaggedAccount is a tag-aware version of matchesAccount.

• Renamed: CommodityLayout to Layout.

1.24.99.1 (1.25 preview 1)

This is not a full hledger release, just an early preview of the 1.25 release for testers and early adopters. Your testing and feedback will help make the final release better! Preview releases are new in 2022, RELEASING has more details.

Changelog

hledger 1.24.99.1 2022-01-06

Features

• The new --infer-equity flag replaces @/@@ prices in commodity
  conversion transactions with equity postings, making them fully
  balanced and preserving the accounting equation. (When not doing
  cost reporting; --cost/-B overrides and disables --infer-equity.)
  For example, hledger print --infer-equity will show:

  2000-01-01
    a   1 AAA @@ 2 BBB
    b  -2 BBB
  

  as:

  2000-01-01
    a                               1 AAA
    equity:conversion:AAA-BBB:AAA  -1 AAA
    equity:conversion:AAA-BBB:BBB   2 BBB
    b                              -2 BBB
  

  The equity:conversion account name is used by default. You can use
  another account by declaring it with the new Conversion/V
  account type (a subtype of Equity/E), eg:

  account Equity:Currency Conversions   ; type: V
  

• Normalised, easy-to-process "tidy" CSV data can now be generated with --layout tidy -O csv.
  In tidy data, every variable is a column and each row represents a single data point
  (cf https://vita.had.co.nz/papers/tidy-data.html).
  (#1768, #1773, #1775) (Stephen Morgan)

Improvements

• CSV output now always disables digit group marks (eg, thousands separators),
  making it more machine readable by default.
  (#1771) (Stephen Morgan)

Fixes

• ;roi: fixes #1791 (fix TWR when investment=0, several pnls per day) (Dmitry Astapov)

Documentation

• Account aliases' ability to cause malformed account names is noted. (#1788)

• There is a new CONVERSION & COST section, replacing COSTING. (#1554)

hledger-ui 1.24.99.1 2022-01-06

• Use hledger 1.24.99.1

hledger-web 1.24.99.1 2022-01-06

• Use hledger 1.24.99.1

hledger-lib 1.24.99.1 2022-01-06

Improvements

• Costing has been changed to ConversionOp with three options:
  NoConversionOp, ToCost, and InferEquity.
  The first correspond to the previous NoCost and Cost options, while the
  third corresponds to the --infer-equity flag. This converts transactions with costs
  (one or more transaction prices) to transactions with equity:conversion postings.
  It is in ConversionOp because converting to cost with -B/--cost and inferring conversion
  equity postings with --infer-equity are mutually exclusive.
  The cost_ record of ReportOpts has been changed to conversionop_.

• hledger-lib now builds with GHC 9.2 and newer libs (#1774).

• Renamed: CommodityLayout to Layout.
  (Stephen Morgan)

Installing

You can build this prerelease from source (tag 1.24.99.1).
Or, you can try the CI binaries below. Download the appropriate "hledger-PLATFORM.zip" file and unzip it to get 2 or 3 hledger binaries in the current directory. On GNU/Linux, you will need to chmod +x these files to make them executable. They should run on most GNU/Linux machines with x64 or (when provided) arm32v7 architecture. On mac machines, you will need to chmod +x them and then mark them as trusted: in Finder, right-click the file then option-click Open. On windows machines you'll need to do something similar. There is no hledger-ui binary for Windows.

1.24.1

https://hledger.org/release-notes.html#hledger-1-24-1

hledger 1.24.1

Fixes

• balance --declared is now filtered correctly by a not:ACCT query.
  (#1783)
• More reliable --version output, with commit date and without patch level.

hledger-ui 1.24.1

Fixes

• An extra "root" account is no longer shown (a regression in 1.24).
  (#1782)
• Declared accounts are now filtered correctly by a not:ACCT query.
  (#1783)
• More reliable --version output, with commit date and without patch level.

hledger-web 1.24.1

Fixes

• More reliable --version output, with commit date and without patch level.

Installing

This release may be packaged for your system: check https://hledger.org/install.
Or, you can try the CI binaries below. Download the appropriate "hledger-PLATFORM.zip" file below. Unzip it to get 2 or 3 hledger binaries in the current directory. On GNU/Linux, you will need to chmod +x these files to make them executable. They should run on most GNU/Linux machines with x64 or (when provided) arm32v7 architecture. On mac machines, you will need to chmod +x them and then mark them as trusted: in Finder, right-click the file then option-click Open. On windows machines you'll need to do something similar. There is no hledger-ui binary for Windows.

1.24

Installing

This release may be packaged for your system: check https://hledger.org/download.html#binary-packages. Or, you can try the binaries built by our github CI setup, below. Notes:

• Download and unzip the appropriate "hledger-PLATFORM.zip" file below. This will unpack 2 or 3 hledger binaries into the current directory. On mac and unix machines, you will need to chmod +x these files to make them executable.

• Windows binaries are built on Windows Server 2019. There is no hledger-ui binary for Windows.

• Mac binaries are built on macos 10.15 catalina. You will need to mark them as trusted before you can run them: run open . to view the current folder in Finder; control-click hledger; option-click "Open"; allow running it.

• Linux binaries are static and should run on most GNU/Linux machines with x64 or (when provided) arm32v7 architecture.

Release notes

New report layout options with less eliding, hledger-ui mouse support, misc fixes and improvements.
https://hledger.org/release-notes.html#hledger-1-24

1.23

Capital gains report,
separate symbol/number display,
command line commodity styling,
budget selection,
weekday/weekend recurrence,
10% speedup,
fixes.

Release notes: https://hledger.org/release-notes.html#hledger-1-23

This release may be packaged for your system: check https://hledger.org/download.html#binary-packages. Or, you can try the binaries built by our github CI setup, below. Notes:

• Download and unzip the appropriate "hledger-PLATFORM.zip" file below. This will unpack 2 or 3 hledger binaries into the current directory. On mac and unix machines, you will need to chmod +x these files to make them executable.

• Windows binaries are built on Windows Server 2019. There is no hledger-ui binary for Windows.

• Mac binaries are built on macos 10.15 catalina. You will need to mark them as trusted before you can run them: run open . to view the current folder in Finder; control-click hledger; option-click "Open"; allow running it.

• Linux binaries are static and should run on most GNU/Linux machines with x64 or (when provided) arm32v7 architecture.

1.22.2

Bugfixes.
Release notes: https://hledger.org/release-notes.html#hledger-1-22-2

This release may be packaged for your system: check https://hledger.org/download.html#binary-packages. Or, you can try the binaries built by our github CI setup, below. Notes:

• Download and unzip the appropriate "hledger-PLATFORM.zip" file below. This will unpack 2 or 3 hledger binaries into the current directory. On mac and unix machines, you will need to chmod +x these files to make them executable.

• Windows binaries are built on Windows Server 2019. There is no hledger-ui binary for Windows.

• Mac binaries are built on macos 10.15 catalina. You will need to mark them as trusted before you can run them: run open . to view the current folder in Finder; control-click hledger; option-click "Open"; allow running it.

• Linux binaries are static and should run on most GNU/Linux machines with x64 or (when provided) arm32v7 architecture.

1.22.1

Bugfixes.
Release notes: https://hledger.org/release-notes.html#hledger-1-22-1

This release may be packaged for your system: check https://hledger.org/download.html#binary-packages. Or, you can try the binaries built by our github CI setup, below. Notes:

• Download and unzip the appropriate "hledger-PLATFORM.zip" file below. This will unpack 2 or 3 hledger binaries into the current directory.

• On unix machines, you will need to chmod +x these files to make them executable before you can run them.

• Mac binaries are built on macos 10.15 catalina. You will need to mark them as trusted before you can run them: run open . to view the current folder in Finder; control-click hledger; option-click "Open"; allow running it.

• Windows binaries are built on Windows Server 2019. There is no hledger-ui binary for Windows.

• "z-contrib-*" binaries, if any, are provided by hledger contributors, but not built from our repo. You should treat these as unsafe (run at your own risk).