Okane

A tiny, command-line-based tool to organize personal finances.

Introduction

Okane is a lightweight and command-line-based tool designed to easily organize personal finances on both Windows and Linux platforms. It allows users to add income or expenses with customizable tags, set up recurring payments, and choose between a simple or detailed view.

Usage

Basics

New entries can be added using the add or abo command. For these it is necessary to provide an amount and tag, with an optional date value, which is the current date by default. For abos there is an extra 'interval' option which can be either monthly (0, monthly, month) or yearly (1, 01, yearly, year).


The remove command can be used to delete an entry by its index, which can be obtained through the detailed command. A month and year may be provided for additional context.

Visualization

To have an overview of the current financial state, the status command gives a quick summary of all entries. A month any year can be provided as well.

+------------------------+
| Category | Amount      |
| Income   | 2344.00 €   |
| Abos     | -23.56 €    |
| Expenses | -123.00 €   |
| Balance  | 2197.44 €   |
+------------------------+

Example output for 'okane status'.

For a more in depth view, the detailed command presents a comprehensive list of entries, including the index and date, as well as the tag. A month and year may be provided.

Type 'okane help' for additional information.

Installation

Okane is currently only available through Winget (Paulanerus.Okane) on Windows and as a AUR-Package (okane) on Arch Linux. It will be available on more platforms soon.