Bankr

Bankr is simple Python for your Bank Accounting to categorize your incomes and expenses

About

Bankr…

• …collects all your bank transactions or entries on your chart of accounts using a CLI. The collection of the entries is performed via CSV export from your bank accounts.
• …categorizes the entries using a simple filter mechanism for repeated bookings. One-time entries can be categorized manually.
• …allows to add, edit and delete entries manually.
• …shows, finally, plots and statistics on the Book within the CLI or your web browser.
• …is configured via small and human-readable YAML files, which you can modify using any editor.
• …creates, hopefully, an overview over your finances.

Alpha Software

This software is in Alpha state. There are a several TODOs in the source code, and some further limitations to remove for completion of its functionality! However, v3 of the data format should be quite stable right now.

Motivation

My motivation for writing these lines of Python code are two-fold:

1. Learning Python, Pandas, and Panel within this Python project.
2. Starting with CSV based accounting, especially after some negative experiences with trying to use an HBCI (now FinTS) based accounting system. At least in Germany, banks tend to break their own HBCI accesses, especially since their most important accesses seem to be their own and individual banking apps. Fortunately, I am not aware of a bank, which does not allow a CSV based download of the respective transaction data.

Installation

Install python and pip for your system, and do the following installation into a virtual environment bankr:

python -m venv bankr
cd bankr
pip install bankr

Bankr includes fictional sample data in bankr/data.sample and a sample config file bankr/bankr.sample.yaml. Linking to the folder and the config file from your working directory, having the virtual environment activated, should allow to run Bankr on this sample data:

ln -s <path/to/bankr/bankr.sample.yaml> bankr.yaml
ln -s <path/to/bankr/data.sample> data

Check the consistency of your configuration, and give it a try: bankr iban. If you see a big Bankr headline and a table of four "fantastic" bank accounts, you are in.

Note Bankr is tested on Linux only right now. Give it a try on BSD, Windows or Mac. I would not expect any hickups, but be prepared. You are heartily invited to provide feedback.

Documentation

Bankr is fully documented here.

License

Bankr is distributed under the terms of the Unlicense license.