NAME¶

ledger2beancount - ledger to beancount converter

SYNOPSIS¶

ledger2beancount [options] input.ledger > output.beancount

cat input.ledger | ledger2beancount [options] > output.beancount

DESCRIPTION¶

ledger2beancount is a script to automatically convert ledger(1)-based textual ledgers to beancount files.

Conversion is based on (concrete) syntax, so that information that is not meaningful for accounting reasons but still valuable (e.g., comments, formatting, etc.) can be preserved.

OPTIONS¶

-c, --config

-h, --help

-V, --version

USAGE¶

ledger2beancount accepts input from stdin or from a file and will write the converted data to stdout. You can run ledger2beancount like this on the example provided:

After you convert your ledger(1) file, you should validate the generated beancount file with bean-check(1) and fix all errors:

You should also inspect the generated beancount file to see if it looks correct to you. Please note that ledger2beancount puts notes at the beginning of the generated beancount file if it encounters problems with the conversion.

FILES¶

$PWD/.ledger2beancount.yaml or $PWD/ledger2beancount.yaml

$XDG_CONFIG_HOME/ledger2beancount/config.yaml (usually $HOME/.config/ledger2beancount/config.yaml)

BUGS¶

If you find any bugs in ledger2beancount or believe the conversion from ledger to beancount could be improved, please open an issue on GitHub:

Please include a small test case so we can reproduce the problem.

AUTHORS¶

Stefano Zacchiroli and Martin Michlmayr

SEE ALSO¶

ledger2beancount(5), ledger(1), bean-check(1)

The full documentation for ledger2beancount can be found in its manual.