budgetwarrior 0.1.0 - command-line personal budgeting tool

Being bored by using Google spreadsheets for my personal budgeting, I decided to write an application to do that. Being a huge fan of taskwarrior, I decided to write a kind of similar application for my personal budget, budgetwarrior was born. I use it since two months and I thought that it could be useful for other persons. The application is developed in C++. More information is available on Github: https://github.com/wichtounet/budgetwarrior.

budgetwarrior 0.1.0 is a command-line only tool. It works on this principle: you create a set of accounts with a certain limit and then you declare your expenses in each of these accounts. You can also manage earnings that are not each month in each account. You can also keeps track of your debts via this application. It also supports automatic creation of recurring expenses, for instance when you pay the rent (for now, only monthly expenses are supported).

Once you've put all your data in the application, it provides you report on the state of your budget by month or by year. For instance, here is my current monthly report:

You can see directly which accounts are in a good shape and which are not.

Here is the current yearly report:

In this view, you can see directly how your accounts evolve during the year and where are your biggest expenses and earnings.

As everything is displayed horizontally, the more accounts you have the larger the view become. With the 7 accounts I have, it takes about 1600 pixels of width to display it. I will try to improve that in the future if some people are interested in making it work on smaller screens.

Installation

You can install budgetwarrior directly from the sources:

git clone -b master git://github.com/wichtounet/budgetwarrior.git
cd budgetwarrior
cmake .
make
sudo make install

After that, you can use budgetwarrior by using the command budget.

The usage is fairly simple, you can use budget help to have the list of the commands that you have to use to create expenses and earnings and display overviews.

The project

If you have any question on the project, don't hesitate to contact me or to post a comment to this post. If there are people interested, I can write a more complete help.

If you have a suggestion or you found a bug, please post an issue on the github project: https://github.com/wichtounet/budgetwarrior.

Related articles