fctracker

Track balances and transactions across foreign currency accounts.

Configuration

Setting	Default	Description
`transactions_dir`	`""`	Directory containing transaction files
`local_currency`	`code=CZK, symbol=Kč, precision=2`	Local currency config
`foreign_currencies`	`{}`	Map of currency code to `{symbol, precision}`

Example YAML config:

transactions_dir: ~/finance/transactions
local_currency:
  code: CZK
  symbol: "Kč"
  precision: 2
foreign_currencies:
  EUR:
    symbol: "€"
    precision: 2
  USD:
    symbol: "$"
    precision: 2

Commands

fctracker balance

Print current balance across all accounts and currencies.

fctracker balance

fctracker transactions

Print transaction ledger with optional filters.

fctracker transactions
fctracker transactions -a savings -c EUR
fctracker transactions -m 2025-01

Options:

-a, --account TEXT — filter by account
-c, --currency TEXT — filter by currency
-m, --month TEXT — filter by month (YYYY-MM)