logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

ledger2beancount - ledger to beancount converter

Authors

       Stefano Zacchiroli and Martin Michlmayr

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.

See Also