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

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:

           ledger2beancount examples/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-check simple.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.

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.

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.

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.

                                            2022-12-18                        ledger2beancount(1)