https://github.com/noracodes/budget
A simple command line budgeting tool
https://github.com/noracodes/budget
Last synced: 12 days ago
JSON representation
A simple command line budgeting tool
- Host: GitHub
- URL: https://github.com/noracodes/budget
- Owner: NoraCodes
- License: apache-2.0
- Created: 2016-06-05T21:34:35.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2016-06-11T15:00:12.000Z (about 10 years ago)
- Last Synced: 2025-07-26T16:45:55.156Z (about 1 year ago)
- Language: Rust
- Size: 35.2 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# budget
A simple command line budgeting tool
## Paradigm
`budget` is based on the idea of a monthly budget. Many expenses, from
utilities to credit card payments to rent, are monthly, and most people
are paid each month. Therefore, `budget` works on the concept of a
"pay day" on which your budget resets. _Even if you are paid weekly,
you have to set a monthly payday._
As a user, you tell `budget` when you are paid, when your bills are due,
and how much you want to save each month. `budget` will then tell you
approximately how much you can spend weekly or daily.
You can log one-off expenses, as well, which will allow `budget` to tell you
how much money you have left for this month or week.
`budget` is just a helpful tool, and is not designed for keeping track of
money on a longer than monthly basis.
## Features
The tool can be called from the command line by typing `budget `.
+ `budget setup ` will set up your budget with your payday on day with amount
+ `budget status` (or just `budget`) will tell you how long until your next payday, next expense, and how much you have left.
+ `budget spend ` will add a one-time expense, reducing the amount of money you have left.
+ `budget tip ` will add a one-time income, increasing the amount of money you have left.
+ `budget expense ` will add a recurring expense.
+ `budget income ` will add a recurring income, _in addition_ to your payday income.
+ `budget remove ` will stop a recurring income or expense.
+ `budget list` will list all the recurring incomes and expenses you've set up.