tracker.cfg5
Configuration file for the trackerd search daemon
Overview
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.
Examples
[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.