https://github.com/ledger-rs/dinero-rs
A command line tool for managing ledger files. Inspired by ledger-cli
https://github.com/ledger-rs/dinero-rs
finances ledger plaintext-accounting
Last synced: about 1 month ago
JSON representation
A command line tool for managing ledger files. Inspired by ledger-cli
- Host: GitHub
- URL: https://github.com/ledger-rs/dinero-rs
- Owner: ledger-rs
- Created: 2021-01-04T23:17:32.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-01-09T00:39:22.000Z (over 3 years ago)
- Last Synced: 2024-03-15T14:42:26.277Z (about 1 year ago)
- Topics: finances, ledger, plaintext-accounting
- Language: Rust
- Homepage:
- Size: 2.35 MB
- Stars: 19
- Watchers: 3
- Forks: 2
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
[](https://github.com/frosklis/dinero-rs/actions/workflows/main.yml)
[](https://codecov.io/gh/frosklis/dinero-rs)
[](https://crates.io/crates/dinero-rs)
[](https://deps.rs/repo/github/frosklis/dinero-rs)
Dinero (spanish for money) is a command line tool that can deal with ledger files, as defined by John Wiegley's wonderful [ledger-cli](https://www.ledger-cli.org/).
# Quickstart
## Install
If Rust and cargo are available in your system, the easiest way to get dinero-rs is by installing the crate:
```sh
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:
```ledger
; 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:
```sh
# 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](https://www.buymeacoffee.com/7CLlJGE).