NAME¶

timew-config - Timewarrior configuration file and override options

SYNOPSIS¶

timew rc.<name>=<value> <command>

DESCRIPTION¶

Timewarrior stores its configuration in the user’s home directory in ~/.timewarrior/timewarrior.cfg on non-Unix systems (e.g. Windows).

On Unix systems, XDG Base Directory specification is supported, if ~/.timewarrior directory doesn’t exist (old config directory is still supported and has precedence over XDG BD compliant locations).

This means configuration is stored in $XDG_CONFIG_HOME/timewarrior/timewarrior.cfg, which defaults to ~/.config/timewarrior/timewarrior.cfg if $XDG_CONFIG_HOME environment variable is not specified.

Those wanting to migrate their data to a new directory scheme, might do that with following shell snippet:

LEGACY="${HOME}/.timewarrior"
CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/timewarrior"
DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/timewarrior"
mkdir -p "${CONFIG_DIR}"
mkdir -p "${DATA_DIR}"
mv "${LEGACY}/timewarrior.cfg" "${CONFIG_DIR}"
mv "${LEGACY}/extensions" "${CONFIG_DIR}"
mv "${LEGACY}/data" "${DATA_DIR}"
rmdir "${LEGACY}"

This file contains a mix of rules and configuration settings. Note that the TIMEWARRIORDB environment variable can be set to override this location.

The values 'true', '1', 'y', 'yes' and 'on' are all equivalent and enable a setting. Any other value means disable the setting.

Default values may be overridden by timewarrior.cfg values, which may in turn be overridden on the command line using: rc.<name>=<value>

For example, to turn off verbose mode:

rc.verbose=0

Note that hints can also do this (:quiet).

CONFIGURATION¶

confirmation

verbose

debug

debug.indicator