rustledger rustfava PTA Standards
rustledger

title: rledger report description: Generate financial reports ​

rledger report ​

Generate standard financial reports from your ledger.

Usage ​

bash
rledger report [OPTIONS] [FILE] [COMMAND]

A report subcommand (e.g. balances, journal) is required — running rledger report FILE with no subcommand errors. FILE precedes the subcommand.

Subcommands ​

CommandAliasDescription
balancesAll account balances
balsheetbalBalance sheet (Assets, Liabilities, Equity)
incomeisIncome statement (Income, Expenses)
journalregisterTransaction register
holdingsInvestment holdings with cost basis
networthNet worth over time
accountsList all accounts
commoditiesList all currencies/commodities
pricesList price entries
statsLedger statistics

Global Options ​

OptionDescription
-P, --profile <PROFILE>Use a profile from config
-f, --format <FORMAT>Output: text, csv, json
-v, --verboseShow verbose output
--no-pagerDisable pager for output
--no-cacheDisable the on-disk parse cache (always re-parse)

Examples ​

Account Balances ​

bash
rledger report ledger.beancount balances

Filter by account:

bash
rledger report ledger.beancount balances -a Expenses
rledger report ledger.beancount balances -a Assets:Bank

Balance Sheet ​

bash
rledger report ledger.beancount balsheet
# or
rledger report ledger.beancount bal

Output:

Assets
  Bank:Checking         5,234.00 USD
  Bank:Savings         12,000.00 USD
  Investments           8,500.00 USD
───────────────────────────────────────
Total Assets           25,734.00 USD

Liabilities
  CreditCard              -450.00 USD
───────────────────────────────────────
Total Liabilities         -450.00 USD

Net Worth              25,284.00 USD

Income Statement ​

bash
rledger report ledger.beancount income
# or
rledger report ledger.beancount is

Transaction Journal ​

bash
# All transactions
rledger report ledger.beancount journal

# Filter by account
rledger report ledger.beancount journal -a Expenses:Food

# Limit entries
rledger report ledger.beancount journal -l 20

Holdings ​

bash
rledger report ledger.beancount holdings

Output:

Account                   Units     Cost Basis    Market Value    Gain/Loss
─────────────────────────────────────────────────────────────────────────────
Assets:Brokerage:AAPL     10.00     1,500.00 USD   1,750.00 USD   +250.00 USD
Assets:Brokerage:GOOGL     5.00     2,000.00 USD   2,100.00 USD   +100.00 USD

Net Worth Over Time ​

bash
rledger report ledger.beancount networth

Statistics ​

bash
rledger report ledger.beancount stats

Output:

Ledger Statistics
─────────────────
Transactions:     1,234
Accounts:            45
Commodities:          3
Directives:       1,456
Date range:       2020-01-01 to 2024-03-15

Output Formats ​

bash
# CSV for spreadsheets
rledger report -f csv ledger.beancount balances > balances.csv

# JSON for scripts
rledger report -f json ledger.beancount balances | jq '.'

See Also ​