39 releases (breaking)

0.33.3-dev Dec 29, 2021
0.33.1 Sep 26, 2021
0.25.0 Mar 31, 2021

#111 in Finance

Download history 25/week @ 2024-02-17 34/week @ 2024-02-24 17/week @ 2024-03-09 1/week @ 2024-03-16 152/week @ 2024-03-30 44/week @ 2024-04-06

196 downloads per month

MIT license

255KB
6.5K SLoC

Build status codecov crates.io Crates.io dependency status

Dinero (spanish for money) is a command line tool that can deal with ledger files, as defined by John Wiegley's wonderful ledger-cli.

Quickstart

Install

If Rust and cargo are available in your system, the easiest way to get dinero-rs is by installing the crate:

cargo install dinero-rs
  • Installation for Windows
  • Installation for Mac
  • Installation for Linux

First steps

Dinero uses double entry accounting. Store your journal files in ledger files. The main item is a transaction, which in its basic form looks something like this:

; This is a comment
; A date followed by a description identifies the beginning of a transaction
2021-02-01 Buy fruit
     Expenses:Groceries          7.92 EUR
     Assets:Checking account             ; you can leave this blank, dinero balances the transactions for you

After that, you can issue all the commands you want and combine them with options to have complete control over your finances!

The most basic ones are:

# Get a balance report: How much is there in every account 
dinero bal -f myledger.ledger

# Get a list of transactions
dinero reg -f myledger.ledger

Features

Currently supported are:

  • Balance reports
  • Register reports
  • Account and payees reports
  • Automated transactions
  • Multicurrency transactions
  • Currency conversion

Report filtering by account name and by date.

Motivation

I use ledger-cli extensively for my personal finances. My goal is to be able to run all the commands I use the most with my own tool while at the same time learning Rust.

Run dinero --help for a list of available commands and options.

If you use this software and want to say thanks, feel free to buy me a coffee.

Dependencies

~12–23MB
~320K SLoC