1TIMEW-CONFIG(7)                  User Manuals                  TIMEW-CONFIG(7)
2
3
4

NAME

6       timew-config - Timewarrior configuration file and override options
7

SYNOPSIS

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

DESCRIPTION

12       Timewarrior stores its configuration in the user’s home directory in
13       ~/.timewarrior/timewarrior.cfg on non-Unix systems (e.g. Windows).
14
15       On Unix systems, XDG Base Directory specification is supported, if
16       ~/.timewarrior directory doesn’t exist (old config directory is still
17       supported and has precedence over XDG BD compliant locations).
18
19       This means configuration is stored in
20       $XDG_CONFIG_HOME/timewarrior/timewarrior.cfg, which defaults to
21       ~/.config/timewarrior/timewarrior.cfg if $XDG_CONFIG_HOME environment
22       variable is not specified.
23
24       Those wanting to migrate their data to a new directory scheme, might do
25       that with following shell snippet:
26
27           LEGACY="${HOME}/.timewarrior"
28           CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/timewarrior"
29           DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/timewarrior"
30           mkdir -p "${CONFIG_DIR}"
31           mkdir -p "${DATA_DIR}"
32           mv "${LEGACY}/timewarrior.cfg" "${CONFIG_DIR}"
33           mv "${LEGACY}/extensions" "${CONFIG_DIR}"
34           mv "${LEGACY}/data" "${DATA_DIR}"
35           rmdir "${LEGACY}"
36
37       This file contains a mix of rules and configuration settings. Note that
38       the TIMEWARRIORDB environment variable can be set to override this
39       location.
40
41       The values 'true', '1', 'y', 'yes' and 'on' are all equivalent and
42       enable a setting. Any other value means disable the setting.
43
44       Default values may be overridden by timewarrior.cfg values, which may
45       in turn be overridden on the command line using: rc.<name>=<value>
46
47       For example, to turn off verbose mode:
48
49           rc.verbose=0
50
51       Note that hints can also do this (:quiet).
52

CONFIGURATION

54       confirmation
55           Determines whether harmful operations require interactive
56           confirmation.
57
58           May be overridden by the ':yes' hint.
59
60           Default value is 'yes'.
61
62       verbose
63           Determines whether Timewarrior generates feedback.
64
65           May be overridden by the ':quiet' hint.
66
67           Default value is 'yes'.
68
69       debug
70           Determines whether diagnostic debugging information is shown.
71
72           Useful for troubleshooting, but not for general use.
73
74           Default value is 'off'.
75
76       debug.indicator
77           The debug output prefix string.
78
79           Default value is '>>'.
80
81
82
83timew 1.6.0                       2023-09-18                   TIMEW-CONFIG(7)
Impressum