Settings

Settings

Each TMSU database (since version 0.4.0) carries a setting table in which per-database settings can be entered.

Making Changes

To change a setting use the 'config' subcommand. Without arguments 'config' will list the current settings from the database, if present, or from the defaults.

$ tmsu config
autoCreateTags=yes
autoCreateValues=yes
fileFingerprintAlgorithm=dynamic:SHA256
directoryFingerprintAlgorithm=none

To change a setting, assign a new value using '='. For example, to turn off automatic tag creation:

$ tmsu config autoCreateTags=no

Settings Explained

Fingerprint Algorithm

fileFingerprintAlgorithm: the fingerprint algorithm TMSU uses to identify files by their contents. See [Fingerprint Algorithms](Fingerprint Algorithms).

Permitted values:

• none
• SHA256
• MD5
• SHA1
• dynamic:SHA256 (default)
• dynamic:MD5
• dynamic:SHA1
• symlinkTargetName
• symlinkTargetNameNoExt

directoryFingerprintAlgorithm: the fingerprint algorithm TMSU uses to identify directories by their contents.

Permitted values:

• none
• dynamic:sumSizes
• sumSizes

Note: directory fingerprinting is a work in progress. Whilst fingerprints can be calculated for directories they cannot currently identified when moved by 'repair'.

Automatic Tag Creation

autoCreateTags: whether TMSU will automatically create a tag if a file is tagged with a new tag name.

Permitted values:

• yes (default)
• no

When set to no, new tags must be created manually using tmsu tag --create tagname.

Automatic Tag Value Creation

autoCreateValues: whether TMSU will automatically create a tag value if a file is tagged with a new tag value.

Permitted values:

• yes (default)
• no

When set to no it is not possible to create new tag values.