## Adding Categories & Properties

### Ivan Frade

`<ivan.frade@`nokia.com`>`

A category is something which identifies one or more files with particular attributes, for example, Files, Folders, Audio, Video, etc. These are all categories. This will help you understand how to add a category for your 3rd party application to integrate it with Tracker.

## Defining Categories

The essential attributes are:

    [CategoryName]
    DisplayName=CategoryName
    Description=A description to the user
    Parent=Parent category. Usually Files. [1]
    Mimes=Mime types we want to assign to this category (e.g.
    audio/x-playlist)
    MimePrefixes=Prefix to match mimetypes (e.g. audio/ will match all mime types as audio/*)
    HasMetadata=Should tracker extract meta-data from these files?
    HasFullText=Shoudl tracker extract text content from these files?
    HasThumb= Should tracker generate thumbnails from these files?
    ShowServiceFiles=Do we want to see these files in the text search results?

### Note

[1] At the moment we only support two levels of hierarchy.

Example 1. A Play List

    [Playlist]
    DisplayName=Playlists
    Description=Music playlists
    Mimes=audio/x-mpegurl
    HasMetadata=true
    HasFullText=false
    HasThumbs=false
    ShowServiceFiles=true

This is because we want to extract meta-data (i.e. the number of songs) but don't want to index the full text and don't want to generate thumbnails.

In this case the properties will have the category name as prefix (we will call them Playlist.X). We can add the PropertyPrefix key in the category description to use a different prefix.