KissCount

DocumentationENv01

You are looking at an old revision of the page DocumentationENv01. This revision was created by Grégory Soutadé.

Table of Content

English documentation

Introduction

Kisscount is a personal accounting software aimed to be as simple as possible and offers only necessary features to quick edit and view your accounts. This documentation will show you what it's possible to do with KissCount.

Pre requisite

To run the software, you need to install the followings packages : wxWidgets (>= 2.8), sqlite (>= 3) and gettext.

Let's go

At first launch, you'll be asked to create an user and an initial database. The new user will have an empty password. Database is named "kc.bdd", it's beside "kc" software. If you want to use another database, add its path to kc's parameters : ./kc /var/kc/xxx.bdd
It's recommended to use launch_kc.sh to start application (because of shared libraries).

Now you may go to "preferences" tab to custom your accounts and categories.

Main panel

Main panel

This panel is the start of all common operations (the goal is to do not have multiple windows).

On the upper left there is the month list. A the beginning of each month you have to "generate" a new month. By right-clicking on the list, a contextual menu will appears letting you generate or delete a month. Generate a month means to report all fix operations and accounts values to a new month (it's possible to do not report any operations if no start month is selected).

On the upper middle, all your accounts with start values, end values and current values (which correspond to the date selected into the near calendar, this is the current date, last day if you're on next month, first day if the month is in the future). Initial values and calendar date are editable. Modifying an initial value will not modify previous or next month values. The star beside account number indicate that the account is shared.

On the right there are statistics. Remains value is : total credit - total debit. These values are updated when an operation is modified. Two operations with inverse values (debit of 1000 and credit of 1000 for instance) with the same description are considered as a transfer and are not taken in account into statistics. For categories computation, only debit operations are taken in account.

The middle part is the most interesting one. On the upper (in yellow), there are "fix" operations, it's recurrent operations that you have each months (remuneration, rent ...). In green are others operations of the current month. Each week is automatically separated by a black line. To delete an operation just check the case with red cross. Operation edition is like in a spreadsheet, copy-paste and undo/redo are not implemented. If you type an operation that have the same description as an other operation entered until 3 months, account and category will be automatically filled.

Group operations

You can group a set of operation into one (operations with a "+" in front). To do that you have to select cells with "control" (ctrl) key pressed and click on "Group" button. You can also add an operation to an existing group by selecting "root" operation or a sub-operation of the group and another operation. But you can't group operations already grouped or group fix and non fix operations.

Formulas

It's possible to enter a mathematical formula instead of a numeric value into "debit" and "credit". You simply have to start with "=". Supported operations are +, -, *, / and brackets. Example : "=-3+5*(4/2)"

Check mode

Check mode

Check mode allows you to do a check between your bank account and operations registered into KissCount, you can activate this mode by checking "check mode" in the lower right. All operation checked will be lightened. In this mode only checked operations will be taken into account for account current value and final value computation. Values in brackets are current values +/- not checked operation of previous months (like non paid cheque).

Statistics

Statistics

Statistics panel shows account's values during an interval of time and total of expanses by categories. 0 line (in red) is always displayed. Points of curves show values at the beginning of the month.

Search

Search Do a search following some criteria. Description is case sensitive, but you can only enter a part of description. Try to do precise searches if you don't want to have a lot of results. Results are displayed in ascending (or descending) order without distinction between fix/non fix operations and without line separation between each week. Found operations can be edited like in main panel.

Preferences

Preferences

This panel allows you to modify you preferences, you can modify/add/delete accounts and categories. You can also :

  • Change user name
  • Change password
  • Delete an account (Kill me)
  • Change language (English or French)
  • Change chronological order (ascending or descending)
  • Change category's color and font to enlighten it

Default account is the first account shows into account's listbox when you add an operation, other accounts are alphabetical sorted.

Shared accounts

By selecting an account, the user list is updated. An user selected means that the account is shared with him (and account number will be followed by a star). So it's ease to share accounts. Only the account owner can really delete an account and share his account. If you delete an shared account that is not your own, it will only be removed from you accounts list.

Web

Web

A simple PHP page show your accounts online. Only main panel is accessible (in read only) and without statistics. No translation is offered for this page.