---
name: "tracker.cfg"
section: "5"
platform: "linux"
package: "tracker"
version: "0.6.6-2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/tracker.cfg"
---

# 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)](/stat/2.md)) 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)**