LEDGER(1) General Commands Manual LEDGER(1) (NAME) ledger - (SYNOPSIS) ledger [options] [command] [arguments] (DESCRIPTION) ledger ( ) . . (COMMANDS) ledger . report-query . report-query QUERIES . . ledger REPL . : accounts [report-query] report-query . balance [report-query] report-query . : --basis (-B) . report-query . . --empty (-E) . --flat report-query . --no-total . bal b . budget [report-query] : ( ). " " () . . cleared [report-query] : . . . commodities [report-query] ( ) report-query. convert CSV ( ) ledger. csv [report-query] report-query CSV ( ). . entry [entry-template] ledger entry-template () . ENTRIES . xact . emacs [query] Emacs Lisp. ledger-mode Emacs ledger . equity [report-query] report-query Equity:Opening Balances . () . payees [report-query] (/) report-query. pricemap graphviz / ledger . prices [report-query] / report-query. . pricedb [report-query] / report-query. ~/.pricedb . print [report-query] . ledger . push [options] REPL options . pop REPL push . register [report-query] report-query. . : --average (-A) . --current (-c) . --exchange "COMMODITY [, COMMODITY, ...]" (-X) commodity . / . . register . balance . --gain (-G) ( ) / . --head number number . --historical (-H) / . --invert . --market (-V) . . --exchange . --period time-period (-p) time-period . --related (-r) . " " . --sort value-expression (-S) value-expression . . : ledger reg --sort 'date, amount' '-' . : ledger reg --sort '-date' --tail number number . --uncleared (-U) ( ). : --by-payee (-P) ( ). --daily (-D) . --weekly (-W) ( ). --start-of-week day day . --monthly (-M) . --quarterly . --yearly (-Y) . --days-of-week . --subtotal (-s) . balance . reg r . select [sql-query] sql-query. SQL : ledger select date,amount from posts where account=~/Income/ source . ledger . stats [report-query] report-query. : o o o o o o o o o xml [report-query] XML. . . (OPTIONS) --abbrev-len INT account-width . INT . INT account-width . --account EXPR EXPR . --account "'Personal'" Personal: --account "tag('VAT')" VAT balance register . --account-width INT register INT . --actual (-L) . --add-budget . --align-intervals . --amount EXPR (-t) . --amount EXPR . --amount-data (-j) register . . --amount-width INT register . --anon (). --ansi . --color. --args-only ledger. --auto-match ledger CSV convert Ledger . --aux-date . --effective. --average (-A) . --average-lot-prices / . --balance-format FMT balance. --base . --basis (-B) . --cost. --begin DATE (-b) (DATE) . . --bold-if EXPR (bold) (true) . --budget . register balance . --budget-format FMT budget. --by-payee (-P) register ( ). --check-payees . --cleared (-C) . --cleared-format FMT cleared. --collapse (-n) . --collapse-if-zero . --color . --ansi. --columns INT register INT . ledger . --cost . --basis. --count ledger commodities accounts payees . --csv-format FMT csv FMT. --current (-c) --limit 'date <= today'. --daily (-D) --period daily. --date EXPR EXPR. --date-format DATEFMT (-y) DATEFMT. strftime(3) . --datetime-format DATETIMEFMT DATETIMEFMT. strftime(3) . --date-width INT register . --day-break timelog register . --days-of-week . --dow. --dc /. --dc register balance . --debug STR ledger . --decimal-comma ledger . --depth INT balance register. . --depth 2 Expenses:Entertainment:Dining Expenses:Entertainment . . --detail convert. --rich-data. --deviation . register prices . --display EXPR (-d) EXPR . --display-amount EXPR . . --display-total EXPR . . --dow . --days-of-week. --download getquote ledger . getquote . LEDGER_PRICE_DB . --effective . --aux-date. --empty (-E) . --end DATE (-e) DATE . --equity equity. register . --exact . --exchange "COMMODITY [, COMMODITY, ...]" (-X) COMMODITY . / . --file FILE (-f) FILE. --first INT INT . --last INT. --head. --flat balance. balance . --force-color TTY TTY . . --force-pager ledger . --forecast-while EXPR VEXPR . --forecast. --forecast-years INT INT . --format FMT (-F) FMT . --gain (-G) . --generated ( ) . --group-by EXPR register. EXPR payee commodity . tag() . --group-title-format FMT . register --group-by EXPR . --hashes ALGO Hash ALGO. sha512 sha512_half SHA512 . Hash . . --head INT INT . --tail INT. --first --help . --immediate (lazy). --import FILE FILE . --init-file FILE (-i) FILE ledger. . . --inject STR STR . STR . --input-date-format DATEFMT . --invert . --last INT. INT . --first INT. register . --tail. --leeway INT (-Z) --price-exp. --limit EXPR (-l) . --lisp-date-format FORMAT lisp. Emacs Lisp . `seconds' ( ) strftime `%Y-%m-%d'. --lot-dates / . --lot-notes . --lot-prices . --lots . --lots-actual . --market (-V) /. --master-account STR STR . --meta STR register STR . --meta-width INT Meta --meta TAG. --monthly (-M) --period monthly. --no-aliases . --no-color TTY. --no-pager TTY. --no-revalued ledger. --no-rounding "". ! --amount-data (-j) --total-data (-J) . --no-titles . --no-total . --now DATE DATE . --period - --begin - --end --current . --only EXPR . --options . --output FILE (-o) ledger FILE. --pager STR STR (pager). --payee . register . --payee-width INT register INT. --pedantic . --pending (pending) . --percent (-%) . / . --period PERIOD (-p) . register . . --period-sort . --permissive (assertions). --pivot TAG "" TAG. --plot-amount-format FMT . --plot-total-format FMT . --prepend-format FMT FMT . --prepend-width INT INT . --price (-I) . --price-db FILE --price-exp INT (-Z) INT . --download . . --leeway. --prices-format FMT prices. --pricedb-format FMT . --primary-date . --actual-dates. --quantity (-O) ( ). --quarterly --period quarterly. --raw print . . . --real (-R) . --recursive-aliases ledger . --register-format FMT register. --related (-r) register . . --related-all --related . --revalued . --exchange (-X) --market (-V) . --revalued-only . --revalued-total / . --rich-data ledger CSV convert CSV Imported UUID . --seed INT INT generate. . --script FILE ledger. --sort EXPR (-S) register EXPR. --sort-xacts . --start-of-week STR STR --weekly. STR "Mon " 0 . --sort-all . --strict . --subtotal (-s) register . --tail INT INT . register . --last INT. --time-colon . 8100s 2.25h 2:15h . --time-report balance timelog. --total EXPR (-T) . --total-data (-J) . --total-width INT register. --trace INT (trace). INT . --truncate STR . STR leading middle trailing. ( "abbreviate" ). --unbudgeted . --uncleared (-U) . --unrealized balance. --unrealized-gains . Equity:Unrealized Gains . . --unrealized-losses . Equity:Unrealized Losses . . --unround . --values tags. --value-expr EXPR . --verbose ledger. --verify (assertions) . . --debug CODE ledger . --verify-memory . . --version . --weekly (-W) --period weekly. --wide (-w) (TTY). --yearly (-Y) --period yearly. (PRE-COMMANDS) . . args / query ledger : 2004/05/27 Book Store ; This note applies to all postings. :SecondTag: Expenses:Books 20 BOOK @ $10 ; Metadata: Some Value ; Typed:: $100 + $200 ; :ExampleTag: ; Here follows a note describing the posting. Liabilities:MasterCard $-200.00 eval . format ledger . parse / expr ledger . generate ledger (seed). GenerateTests . period ledger. template xact . . (QUERIES) . OR . : regex (PCRE) . : ledger bal asset liab payee regex (@regex) ( ) . tag regex (%regex) . note regex (=regex) . code regex (#regex) ( ). term and term OR . and AND . Shakee's Pizza : ledger reg food and @Shakee term or term OR . show not term . : ledger reg food and @Shakee and not dining ( term ) OR AND . : : ledger bal \( assets or liab \) and not food (EXPRESSIONS) abs(value) (value). account . account_base ':' . actual (true) (false) . amount . amount_expr --amount. ansify_if(value, color, bool) (value) ANSI (color) bool . --color : ansify_if(amount, blue, options.color) beg_line . beg_pos . ceiling(value) (value) (). cleared . code . commodity(value) / (value) value . date . end_line . end_pos . floor(value) (value) (). filename ledger . format(string) string --format. format_date(date, format) (date) (format). strftime(3) . format_datetime(datetime, format) (datetime) (format). strftime(3) . get_at(seq, index) (index) (seq). . has_meta(tag) tag . has_tag(tag) tag . is_seq(value) value . . join(value) value \n. justify(value, first_width, latter_width, right_justify, colorize) value . first_width . latter_width . latter_width 1- first_width . right_justify . . colorize ledger . market(value, datetime) value datetime. datetime [2012/03/23]. meta(name) name. note . now . options --daily (-D) option.daily . payee . percent(value_a, value_b) value_a value_b ( ). pending (pending) . percent(value_a, value_b) value_a value_b. print(value) value (stdout). . quantity(value) value . quoted(expression) expression (). quoted_rfc(expression) expression RFC 4180. real . roundto(value, n) value n . . should_bold --bold-if . ! scrub(value) value . strip(value) value. tag(name) name. to_amount(value) value . ! to_balance(value) value . ! to_boolean(value) value . ! to_date(value) value . ! to_datetime(value) value . ! to_int(value) value. to_mask(value) value . ! to_sequence(value) value . ! to_string(value) value . today . total . total_expr --total. trim(value) value. truncated(string, total_len, account_len) string total_len account_len . virtual ( ) . averaged_lots() . clear_commodity() /. commodity_price(commodity) / . display_amount(amount) . display_total(total) . lot_date(posting) . lot_price(posting) . lot_tag(posting) . nail_down(amount) . round(amount) . rounded(amount) . set_commodity_price(commodity, price) /. top_amount(amount) . unround(amount) . unrounded(amount) . (DEBUG COMMANDS) ledger : args [report-query] report-query ledger. . eval [value-expression] value-expression . EXPRESSIONS . format [format-string] format-string . FORMATS . generate ledger. parse [value-expression] value-expression . EXPRESSIONS . python [file] file . ledger ledger . reload . REPL . template [draft-template] draft-template. DRAFTS . (ENVIRONMENT) ledger . LEDGER_DATE_FORMAT="%d.%m.%Y" --date-format '%d.%m.%Y' . . (FILES) $XDG_CONFIG_HOME/ledger/ledgerrc ~/.config/ledger/ledgerrc ~/.ledgerrc ledger. (SEE ALSO) beancount(1), hledger(1) ledger Texinfo . info info ledger3 . (AUTHORS) John Wiegley Linux 6.12.107+deb13-amd64 December 13, 2023 Linux 6.12.107+deb13-amd64