Reference

tracker.cfg(5)

configuration file for the trackerd search daemon

NAME

tracker.cfg - configuration file for the trackerd search daemon

DESCRIPTION

The tracker.cfg file resides in the $HOME/.config/tracker directory.

The file is organized in sections, each section having a number of related options.

Comments

Empty lines and those starting with ; or # are ignored.

Value Types

VALUE

Denotes a positive integer.

BOOLEAN

Denotes either true or false.

Any other value

Any special keyword is to be replaced by one of the documented valid values, e.g. pathnames or language codes.

EXAMPLE

[General]

Verbosity=0

InitialSleep=50

Sections

General

This section may contain general settings for trackerd.

Verbosity=VALUE

Specifies how verbose trackerd should be logging. VALUE can be one of 0 through 3.

0

Show no but error and critical output, this is the default behavior.

1

Show minimal output, i.e. not just errors.

2

Show verbose output.

3

Show debugging output, enable this only if you know what you are doing.

LowMemoryMode=BOOLEAN

Enables low memory mode. Tracker may be slightly less fast at indexing/search but also needs less system memory.

InitialSleep=VALUE

Sets the initial sleep time for trackerd. This is a number of seconds that trackerd wait before indexing.

Watches

WatchDirectoryRoots=DIRECTORY[;MORE;DIRECTORIES]

Sets the directories trackerd should watch and index. Defaults to the users home directory.

NoWatchDirectory=DIRECTORY[;MORE;DIRECTORIES]

Sets directories trackerd should ignore, i.e. not index or watch.

CrawlDirectory=DIRECTORY[;MORE;DIRECTORIES]

Sets directories trackerd should index once but not watch for changes.

EnableWatching=BOOLEAN

Enables or disables watching of directories, i.e. re-index files when they change.

Indexing

This section may contain indexing related options.

Throttle=VALUE

Sets the throttling value for the Indexer. VALUE can be any number from 0 to 20 whereas higher values decrease indexing speed.

EnableIndexing=BOOLEAN

Enable or disable the indexer.

EnableFileContentIndexing=BOOLEAN

Enable or disable indexing of files text contents.

EnableThumbnails=BOOLEAN

Enable or disable the generation of thumbnails.

NoIndexFileTypes=FILEGLOB[;MORE;FILEGLOBS...]

List of partial file patterns (glob) separated by semicolons that specify files not to index. Only basic metadata (i.e. information retrieved by stat(2)) is indexed.

MinWordLength=VALUE

Sets the minimum word length to index. Words having less then VALUE characters will not be indexed.

MaxWordLength=VALUE

Sets the maximum word length to index. Words having more then VALUE characters will not be indexed.

Language=LANGCODE

Sets the language specific stemmer and stopword list to use. Valid values are:

en

English

da

Danish

nl

dutch

fi

Finnish

fr

French

de

German

it

Italian

nb

Norwegian

pt

Portuguese

ru

Russian

es

Spanish

sv

Swedish

EnableStemmer=BOOLEAN

Enable or disable the stemmer.

BatteryIndex=BOOLEAN

Enable or disable indexing when on battery power.

BatteryIndexInitial=BOOLEAN

Enable or disable initial index sweep (i.e. the very first indexing) when on battery power.

Emails

This section may contain Email specific options.

IndexEvolutionEmails=BOOLEAN

Enable or disable indexing for Evolution emails.

IndexThunderbirdEmails=BOOLEAN

Enable or disable indexing for Thunderbird emails.

Performance

Trackerd performance related options.

MaxTextToIndex=VALUE

Maximum size of text in bytes to index from a file's text contents. Defaults to 1048576.

MaxWordsToIndex=VALUE

Maximum number of unique words to index from a file's text contents. Defaults to 10000.

OptimizationSweepCount=VALUE

Specifies the no of entities to index before determining whether to perform index optimization. Default to 10000.

MaxBucketCount=VALUE

Sets the maximum bucket count for the indexer. Defaults to 524288.

MinBucketCount=VALUE

Sets the minimum bucket count. Defaults to 65536

Divisions=VALUE

Sets no. of divisions of the index file. Default to 4.

BucketRatio=VALUE

Selects the desired ratio of used records to buckets to be used when optimizing index (should be a value between 0 and 4). Defaults to 1.

Padding=VALUE

Alters how much padding is used to prevent index relocations. Higher values improve indexing speed but waste more disk space. Value should be in range (1..8). Defaults to 2.

SEE ALSO

tracker(1)