ledger2beancount - ledger to beancount converter
Contents
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:
https://github.com/beancount/ledger2beancount/issues
Please include a small test case so we can reproduce the problem.
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.
Files
$PWD/.ledger2beancount.yaml or $PWD/ledger2beancount.yaml
The configuration file for the current directory.
$XDG_CONFIG_HOME/ledger2beancount/config.yaml (usually $HOME/.config/ledger2beancount/config.yaml)
The default configuration file.
Name
ledger2beancount - ledger to beancount converter
Options
-c,--config
Specify a configuration file. The options of the configuration file are described in
ledger2beancount(5) and the ledger2beancount manual.
-h,--help
Show help message and quit.
-V,--version
Show version and quit.
See Also
ledger2beancount(5), ledger(1), bean-check(1) The full documentation for ledger2beancount can be found in its manual. 2022-12-18 ledger2beancount(1)
Synopsis
ledger2beancount [options] input.ledger > output.beancountcatinput.ledger | ledger2beancount [options] > output.beancount
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:
ledger2beancountexamples/simple.ledger > simple.beancount
After you convert your ledger(1) file, you should validate the generated beancount file with bean-check(1) and fix all errors:
bean-checksimple.beancount
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.
