Skip to content

martinezpl/eco-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Eco CLI

eco is a CLI tool for personal finance keeping.

It provides a quick way to record your money flow through a simple interface. The records are arranged & kept in neat tables that are being stored in your local $HOME/eco_tables path.

It takes about a minute an evening to keep your budget updated. Also, eco scraps a daily fun-fact to add a bit of motivation towards regular usage :)

Installation

Before installing, make sure you've added pip to your local environment variable. If you haven't, you will probably be notified during installation. Doing so allows eco to be a bash script.

pip install eco-cli

Usage

Simply type in eco in your terminal to invoke the program. First run will initialize a personalization process, in which you'll create flow categories.

Use flow to register money flow. You can use summary for a quick budget peek, or, for a closer inspection, import the .csv files under $HOME/eco_tables to your tabular software of choice.

Hints:

  • WALLET = income - spendings - savings

  • Register income, before you register a saving.

  • The three, main categories are a rolling sum (running total). Therefore, think of a saving category as of a sock. When you use your saved up money, you take the money out of the sock, so you update the saving category with a negative number. If you spent it - you register the amount taken as a spending. If you allocated it in a different sock - you update the right saving category.

  • If you delete a category, its previous records remain included in the sums.

summary

About

CLI tool for personal finance keeping.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages