Adding Categories & Properties

Ivan Frade

Defining Categories
Defining Properties

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.