## Groups

### What is a group?

A group is actually a filter for categories, it describes what categories should appear in what order at the application. There are already a few filters for different audiances, e. g. "office", "travel" or "physics". You can reach those by selecting the group combo box at the main graphical user interface. If you would like to add, hide, remove or reorder categories, you can edit the following textfiles:
`Installationsverzeichnis/data/groups/*.group`

### Description of a .group-file

A .group-file is just a flat text file stored in UTF-8. Each line in the file has to contain a category ID. Valid IDs have been specified in the categories.list.

A .group-file also requires an icon in the png-format (24x24 pixel are preferred) stored in the following directory:
`Installationsverzeichnis/data/images/groups/`

"all" and "random" are reserved words and those should not be used for naming a .group file.

### Edit a filter

There is a filter called "favorites.group" which can be used to redefine your preferred favorites:
`Installationsverzeichnis/data/groups/favorites.group`

At the end of the file you find all valid category IDs. Valid IDs have been specified in the categories.list.

### Translation of the title of a group

You can translate the title of a group by adding a new entry to a language resource bundle. The entry has to follow the following syntax:

Group.<filename of the group file>=<translation>

Example:

Group.math=Mathematik