gAcc - manages personnal bank accounts

gacc [-h] [-v] [ -f filename ]

gAcc is a small personnal bank accounts manager. Its goal is to keep easy to use with as much functionnalities as needed. The program loads the global configuration file /etc/gaccrc and then loads personnal configuration and the default (last) accounts wallet file. When gAcc loads, you can tell it to directly open the last account you modified.

gAcc functionnalities are next :

- Account editing

- Operation editing

- Operation search

- Operations printing

- Graphics

- Euro convertion

- Locales definitions

- Human readable definitions and wallet files

- ...

-h

Help / usage.

-v

Display version number

-f filename

Specify the accounts wallet file to load for modifications.

1. Getting started

Once you have compiled and installed gAcc without any problem, just launch it and it'll create it's own default configuration directory and file, and show you a window called "the accounts list". This is a list of the accounts you have put in the wallet file. Of course, the first time you launch gAcc, you have no wallet file.

You can try an example provided with the gAcc package or create your own new wallet file. To do so, you just have to add new accounts to the list and then save the file. Take also a look to the preferences menus to set up gAcc as you want.

After that you can start to add new operations to any of your accounts.

Note that not all of the functions are implemented.

2. Accounts

An accounts is composed of several elements. First its name by with you can know what account it is. Then its number, given by your bank. Next the bank where you opened it. The opening balance is the amount you have put in it at the opening or creation in gAcc. At last there is its operations list. The operations list is the mean to remember the operation you've done with this account and to keep you in mind how much there is left on this accounts.

The Accounts list which is displayed in the main window contains 4 columns that are for the name of the account, the bank where it is, its cleared operation's amount (that must be equal to your bank statement) and its balance. All accounts are listed in their entering order. Accounts the balance is below 0.0 have their last column in red.

You can execute some functions on each account :

- Open its operations list

- Edit its informations

- Delete it

- Add a new account

- Graph its list of operations (Only account and operations graph by now).

There are a few means to execute the functions you want. First there is a menu entry in the menu bar. But the others are attached to each mouse button :

- button 1 (left), when double-clicked, displays the account's operations list

- button 2 (middle) displays the account's informations

- button 3 (right), when double-clicked, displays a context pop-up menu that is similar to the menu in the menu bar.

3. Operations

An operation is composed of 8 elements. A number for a cheque, an object to know why you did that operation, the date when you bought/sold that thing, the amount of the transaction, the medium specifying how you did it, an entry saying if it's a credit or a debit operation, a flag to know if it is cleared or not, a category, a third party, and finaly a splits list.

The operations window that is displayed when ou open an account's list of operations contains 8 columns. The first is the date when you did the operation, next comes the number of the operation/cheque, after is the object or reason why you did that operation, then comes the category in which you classify that operation, the fifth column is the cleared state (when you've seen it in your bank statement) of the operation, the amount is in the sixth column if it's a debit operation or in the seventh column if it's a credit one. The last column is for the intermediate balance. Cancelled operations have their line in violet, and operation for which the intermediate balance is below 0.0 have their last column is red.

Functions available on an operation are :

- Edit the selected operation to make some modifications

- (un)Clear the selected operation

- (un)Cancel the selected operation

- Delete it

- Add a new operation

- Search for operations with differents criteria

- Print the operations list.

There are a few means to do want you want with operations :

- with the mouse's left button you can double-click to open the operation's informations

- with the middle button you can set that operation to Cleared / Uncleared

- and with a double-click on the right button you can display the pop-up menu.

4. Categories

Categories are a mean to create a classification in the list of operations an account contain. They are usefull for a research of a list of operations of a certain type.

You can modify an operation's category by editing it.

You have access to the categories list in the settings/categories menu. There you can add/remove/edit any category. Each category has a name (you can add a slash to specify a subcategory e.g. : "Car / Insurance") and a number. I don't give you the advise of modifying the number since they are internaly managed but in some cases you have to do this.

There are a few means to access caterogies' functions :

- the left mouse button, when double-clicked, displays the selected category's informations

- and the right button's double-click displays the pop-up menu.

5. Menus

5.1. The File menu

- New wallet

Create a new empty list of accounts and operations. If one is already opened, you'll be asked for saving (if the "automatic saving" is not on). Don't forget to save your changes.

- Open

Open a wallet file. You'll be asked to save the wallet (if the "automatic saving" is not on). Don't forget to save your changes.

- Save

Save the already opened wallet file.

- Save As

Save the already opened wallet file with another name.

- Close

Close the already opened wallet file. You'll be asked for saving (if the "automatic saving" is not on). Don't forget to save your changes.

- Quit

Exit the program. You'll be asked for saving (if the "automatic saving" is not on). Don't forget to save your changes.

5.2. The Settings menu

- Preferences

Open the preference window. It has 4 panes that allow to configure :

- 1 : The first is to configure your country's currency and it's position in relation to the amount of an operation or an account.

- 2 : The second is for the date and the way you like to see it. you can configure the date separator and the format (dd.mm.yyyy / mm.dd.yyyy).

- 3 : The third allow only to configure the Euro value in regard to your country's money.

- 4 : The forth is the one for printer configuration (ASCII/PostScript and command/options for each).

- 5 : The fifth pane contain a few options : "Auto save files", "Tear off menus" and "Use last opened account".

- 6 : The sixth and last pane determines if the advanced features are used or not (3rd parties and splits).

You can, after modification click either on "OK" that will keep your changes and save them later on, "Save" in order to immediately save your changes and "Cancel" which will discard them.

- Categories

Open the categories window. It display the list of categories you have defined in order to changes/see them. They are listed in alphabetical order, but debit and credit are separated : debit categories come first and credit categories come after. See the "Categories" menu.

- 3rd parties

If the advanced feature "3rd parties" has been selected in the preferences window, this option is available. Its opens a window that allow to edit 3rd parties the same way the categories window does it for categories.

- Scheduled operations

Opens the scheduler window. You can then add, change or remove some scheduled operation that can be periodicaly done. (Not yet implemented)

- Convert to Euro

Open a window that will ask you if you are sure you want to convert all your accounts and operations to Euro. If you answer "OK", your account will be converted to Euro and renamed with a ".wallet-euro" extension. Your old wallet file will remain in your ~/.gacc/ directory.

5.3. The Accounts menu

- Open

Open the operations list's window for the selected account.

- Edit

Edit the selected account's informations.

- Delete

Delete the selected account.

- Add

Add a new account to the opened wallet file.

- Graph

Graph the selected account's amount during the past year up now (by default since dates are modifiables), credit and debit operations and finaly a pies graph for categories (Not yet implemented).

5.4. The Operations menu

- Edit

Edit the operations informations. You can change anything for the selected operation except the cancelled state that is modifyed by the menu entry below. If you enter a category that is not in the categories list you are asked to save or not that new category.

- (un)Clear

Set or unset the cleared state of the selected operation.

- (un)Cancel

Set or unset the cancelled stats of the selected operation.

- Delete

Delete the selected operation.

- Add

Add a new operation.

- Search

Search for operations of the same medium, type, category, date or cleared state. After the search is complete, a window opens that lists all the matching operations. You can print that list the same way as using the print list menu (see below). The window used to display the resulting operations is the same as the usual operations' list window. So you can use the mouse buttons to display the operation's informations, change it's cleared state or display the pop-up menu...

- Print list

Print the operations list. A "Print" window is opened for you to choose the destination (printer or file) and the format (PostScript or ASCII). The defaults entries for printing are :

- ASCII printing : command = "a2ps", options = "--stdin="

- PostScript printing : command = "lpr", options = "-Plp "

Notice the space after "-Plp " : it's here to separate options from filename. The default ASCII printing command is a2ps, anyway, you can change it to what you want, but the printing function add a name for the print job that is the name of the file where are stored the informations befor printing. If you want to change that, you must know the option to use to deal with that. For example, with lpr, options would be "-Pascii -J ", with ascii = the name of your ASCII printer configured in /etc/printcap.

Note that the "Operations" menu is the same as the menu for editing and manipulate operations that come from a research result, except that the three last part are not shown (Add, Search and Print).

5.5. The Categories menu

- Edit

Edit the selected category informations.

- Add

Add a new category.

- Delete

Delete the selected category.

5.6. The 3rd parties menu

- Edit

Edit the selected 3rd party informations.

- Add

Add a new 3rd party.

- Delete

Delete the selected 3rd party.

5.7. The Help menu

- Help Index

Displays the Help System window at the Index page. Indexes are composed of buttons that open a new paragraph of the help file.

- About

Shows the "About box" :)

The HELP file might not be found. You can specify that with an option in the global configuration file or in your personnal configuration file if you have no access to the first.

CATFIL :

File where the personnal categories are stored.

ACCFIL :

Last accounts wallet file opened.

TRSFIL :

3rd parties file.

CURREN :

Currency.

CURPOS :

Currency position (0 = After, 1 = Before).

LSTACC :

Last opened account in your file.

USELOA :

Open last opened account on startup (0 = false, 1 = true).

AUTSAV :

Auto save files (0 = false, 1 = true).

TEAROF :

Tear of menus (0 = false, 1 = true). NOT YET IMPLEMENTED.

DATFOR :

Date format (0 = French date, 1 = English date).

DATSEP :

Date separator.

EURVAL :

Euro value for your country's money.

ADVANC :

Use advanced features.

PSPRNC :

PostScript printing command.

PSPRNO :

PostScript printing option.

ASPRNC :

ASCII printing command.

ASPRNO :

ASCII printing option.

HLPPTH :

Help path (with filename).

CATPTH :

Default categories file path (with filename).

HLPPTH :

System wide help path (with filename).

CATPTH :

System wide default categories file path (with filename).

~/.gAcc/gaccrc

~/.gAcc/categories.def

~/.gAcc/tiers.def

~/.gAcc/accounts.wallet

/etc/gaccrc

PREFIX/share/HELP

gAcc version 0.7.3

This program is released under the GPL. If you do anything interesting, please let me know, I would like to have a look.

Thomas Nemeth <tnemeth@free.fr>

http://gacc.sourceforge.net

Michel Verdier <mverdier@chez.com>

Julien Blache <jb@jblache.org>

Gianluca Montecchi <gianluca@pluto.linux.it>

cron(8), crontab(1), crontab(5)