2022-10-10 17:17:43 +02:00
|
|
|
# hledger
|
|
|
|
|
2024-05-23 16:49:48 -10:00
|
|
|
> A robust, friendly plain text accounting app.
|
|
|
|
> See also: `hledger-ui` for TUI, `hledger-web` for web interface.
|
|
|
|
> More information: <https://hledger.org/hledger.html>.
|
2022-10-10 17:17:43 +02:00
|
|
|
|
2024-05-23 16:49:48 -10:00
|
|
|
- Record new transactions interactively, saving to the default journal file:
|
2022-10-10 17:17:43 +02:00
|
|
|
|
|
|
|
`hledger add`
|
|
|
|
|
2024-05-23 16:49:48 -10:00
|
|
|
- Import new transactions from `bank.csv`, using `bank.csv.rules` to convert:
|
2022-10-10 17:17:43 +02:00
|
|
|
|
2024-05-23 16:49:48 -10:00
|
|
|
`hledger import {{path/to/bank.csv}}`
|
2022-10-10 17:17:43 +02:00
|
|
|
|
2024-05-23 16:49:48 -10:00
|
|
|
- Print all transactions, reading from multiple specified journal files:
|
2022-10-10 17:17:43 +02:00
|
|
|
|
2025-04-22 15:48:30 +03:00
|
|
|
`hledger print {{[-f|--file]}} {{path/to/prices-2024.journal}} {{[-f|--file]}} {{path/to/prices-2023.journal}}`
|
2022-10-10 17:17:43 +02:00
|
|
|
|
2024-05-23 16:49:48 -10:00
|
|
|
- Show all accounts, as a hierarchy, and their types:
|
2022-10-10 17:17:43 +02:00
|
|
|
|
2025-04-22 15:48:30 +03:00
|
|
|
`hledger accounts {{[-t|--tree]}} --types`
|
2024-05-23 16:49:48 -10:00
|
|
|
|
|
|
|
- Show asset and liability account balances, including zeros, hierarchically:
|
|
|
|
|
2025-04-22 15:48:30 +03:00
|
|
|
`hledger {{[bs|balancesheet]}} {{[-E|--empty]}} {{[-t|--tree]}} --no-elide`
|
2024-05-23 16:49:48 -10:00
|
|
|
|
|
|
|
- Show monthly incomes/expenses/totals, largest first, summarised to 2 levels:
|
|
|
|
|
2025-05-04 10:20:26 +03:00
|
|
|
`hledger {{[is|incomestatement]}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} --sort {{[-2|--depth 2]}}`
|
2024-05-23 16:49:48 -10:00
|
|
|
|
|
|
|
- Show the `assets:bank:checking` account's transactions and running balance:
|
|
|
|
|
2025-04-22 15:48:30 +03:00
|
|
|
`hledger {{[areg|aregister]}} assets:bank:checking`
|
2024-05-23 16:49:48 -10:00
|
|
|
|
|
|
|
- Show the amount spent on food from the `assets:cash` account:
|
|
|
|
|
2025-04-22 15:48:30 +03:00
|
|
|
`hledger print assets:cash | hledger {{-f|--file}} - {{[-I|--ignore-assertions]}} aregister expenses:food`
|