Skip to content

Command line application used to help plan personal finances.

Notifications You must be signed in to change notification settings

TomWright/finance-planner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Finance Planner

Finance planner gives a simple and easy way of tracking your common incomings and outgoings in order to give yourself a daily or weekly budget.

You can add transactions against a profile, and tag these transactions to get a breakdown of how you're spending your money.

Installation

Download a binary from the releases page and save it as /usr/local/bin/finance.

Depending on your platform, you'll likely want to save the following binary:

  • Mac OS: finance_darwin_amd64
  • Windows: finance_windows_amd64.exe
  • Linux: finance_linux_amd64

Usage

Add a transaction

Transactions have a few properties:

  • Label: What is it for?
  • Amount: Positive or negative number that will impact your ending balance.
  • Tags: Comma separate list of tags, used to categorise the transactions.
finance add-transaction --profile=tom --label="Train ticket" --amount=-43500 --tags=commute,travel

List your transactions

finance list-transactions --profile=tom
  • Append --in to only show incoming transactions
  • Append --out to only show outgoing transactions

Update a transaction

update-transaction looks a lot like add-transaction, but with an added id argument.

Any given values will overwrite existing values on the transaction.

finance update-transaction --id="tra:11111111-1111-1111-1111-111111111111" --profile=tom --label="Train ticket" --amount=-43500 --tags=commute,travel

Storage

Data is stored in a SQLite database at ~/finance_planner/finance.db.

About

Command line application used to help plan personal finances.

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages