NAME

       ledger2beancount - configuration file for ledger2beancount(1)

INPUT OPTIONS

       The following options may be needed for ledger2beancount to interpret your ledger files
       correctly.

       date_format <string>
           The date format used in your ledger file (default: %Y-%m-%d).

       date_format_no_year <string>
           The date format for dates without the year when ledger's Y/year directive is used
           (default: %m-%d).

       ledger_indent <int>
           Sets the indentation level used in your ledger file (default: 4).

       decimal_comma true|false
           Parses amounts with the decimal comma (e.g. 10,00 EUR).  Set this option to true if
           you use option --decimal-comma in ledger.

       hledger true|false
           Tells ledger2beancount whether to attempt to parse hledger(1)-specific features.

OTHER OPTIONS

       beancount_indent <int>
           Sets the indentation level for the generated beancount file (default: 2).

       operating_currencies
           A list of frequently used currencies.  This is used by fava, the web UI for beancount.

       automatic_declarations true|false
           Emit account and commodity declarations. (Default: true)

           Note: the declarations done in ledger via account and commodity declarations are
           always converted.  If this option is true, declarations are created for those which
           have not been explicitly declared in ledger but used.

       account_open_date <string>
           The date used to open accounts (default: 1970-01-01).

       commodities_date <string>
           The date used to create commodities (default: 1970-01-01).

       beancount_header <file>
           Specifies a file which serves as a beancount "header", i.e. it's put at the beginning
           of the converted beancount file.  You can use such a header to specify options for
           beancount, such as option "title", define plugin directives or beancount query
           information.

       ignore_marker <string>
           Specifies a marker that tells ledger2beancount(1) to ignore a line if the marker is
           found.

       keep_marker <string>
           Specifies a marker that tells ledger2beancount(1) to take a line from the input that
           is commented out, uncomment it and display it in the output.

       convert_virtual true|false
           Specifies whether virtual postings should be converted.  If set to true, virtual
           postings in brackets will be made into real accounts.  (Virtual postings in
           parentheses are always ignored, regardless of this option.)

       account_map
           Specifies a hash of account names to be mapped to other account names.

       account_regex
           Specifies a hash of regular expressions to replace account names.

       commodity_map
           Specifies a mapping of ledger commodities to beancount commodities.

       metadata_map
           Specifies a mapping of ledger metadata keys to corresponding beancount keys.

       payee_tag and payer_tag
           Specify a metadata tag (after the mapping done by metadata_map) used to set the payee.

       narration_tag
           Specify a metadata tag (after the mapping done by metadata_map) used to set the
           narration.

       payee_split
           Specifies a list of regular expressions to split ledger's payee field into payee and
           narration.  You have to use the named capture groups payee and narration.

       payee_match
           Specifies a list of regular expressions and corresponding payees. The whole ledger
           payee becomes the narration and the matched payee from the regular expression becomes
           the payee.

       postdate_tag <string>
           Specifies the metadata tag to be used to store posting dates. (Use the empty string if
           you don't want the metadata to be added to beancount.)

       auxdate_tag <string>
           Specifies the metadata tag to be used to store auxiliary dates (also known as
           effective dates; or date2 in hledger). (Use the empty string if you don't want the
           metadata to be added to beancount.)

       code_tag <string>
           Specifies the metadata tag to be used to store transaction codes. (Use the empty
           string if you don't want the metadata to be added to beancount.)

       link_match
           Specifies a list of regular expressions that will cause a tag to be rendered as a
           link.

       link_tags
           Specifies a list of metadata tags whose values should be converted to beancount links
           instead of metadata. Tags are case insensitive and values must not contain whitespace.

       currency_is_commodity
           Specifies a list of commodities that should be treated as commodities rather than
           currencies even though they consist of 3 characters (which is usually a characteristic
           of a currency).  Expects beancount commodities (i.e. after transformation and
           mapping).

       commodity_is_currency
           Specifies a list of commodities that should be treated as currencies (in the sense
           that cost is not retained). Expects beancount commodities (i.e. after transformation
           and mapping).

       move_posting_tags
           Move posting-level tags to the transaction itself to work around the lack of posting-
           level tags in beancount.

AUTHORS

       Stefano Zacchiroli and Martin Michlmayr

SEE ALSO

       ledger2beancount(1), ledger(1), hledger(1)

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

                                            2022-12-18                        ledger2beancount(5)