'\" t
.\"     Title: timew-config
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2023-12-30
.\"    Manual: User Manuals
.\"    Source: timew 1.7.0-dev
.\"  Language: English
.\"
.TH "TIMEW\-CONFIG" "7" "2023-12-30" "timew 1.7.0\-dev" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE pass:[blue\ R\ <\ >]
.\}
.SH "NAME"
timew-config \- Timewarrior configuration file and override options
.SH "SYNOPSIS"
.sp
\fBtimew rc.\fP\fI<name>\fP\fB=\fP\fI<value>\fP \fI<command>\fP
.SH "DESCRIPTION"
.sp
Timewarrior stores its configuration in the user\(cqs home directory in \fI~/.timewarrior/timewarrior.cfg\fP on non\-Unix systems (e.g. Windows).
.sp
On Unix systems, XDG Base Directory specification is supported, if \fI~/.timewarrior\fP directory doesn\(cqt exist
(old config directory is still supported and has precedence over XDG BD compliant locations).
.sp
This means configuration is stored in \fI$XDG_CONFIG_HOME/timewarrior/timewarrior.cfg\fP, which defaults to \fI~/.config/timewarrior/timewarrior.cfg\fP if \fI$XDG_CONFIG_HOME\fP environment variable is not specified.
.sp
Those wanting to migrate their data to a new directory scheme, might do that with following shell snippet:
.sp
.if n .RS 4
.nf
.fam C
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}"
.fam
.fi
.if n .RE
.sp
This file contains a mix of rules and configuration settings.
Note that the TIMEWARRIORDB environment variable can be set to override this location.
.sp
The values \*(Aqtrue\*(Aq, \*(Aq1\*(Aq, \*(Aqy\*(Aq, \*(Aqyes\*(Aq and \*(Aqon\*(Aq are all equivalent and enable a setting.
Any other value means disable the setting.
.sp
Default values may be overridden by timewarrior.cfg values, which may in turn be overridden on the command line using: \fBrc.\fP\fI<name>\fP\fB=\fP\fI<value>\fP
.sp
For example, to turn off verbose mode:
.sp
.if n .RS 4
.nf
.fam C
rc.verbose=0
.fam
.fi
.if n .RE
.sp
Note that hints can also do this (:quiet).
.SH "CONFIGURATION"
.sp
\fBconfirmation\fP
.RS 4
Determines whether harmful operations require interactive confirmation.
.sp
May be overridden by the \*(Aq:yes\*(Aq hint.
.sp
Default value is \*(Aqyes\*(Aq.
.RE
.sp
\fBverbose\fP
.RS 4
Determines whether Timewarrior generates feedback.
.sp
May be overridden by the \*(Aq:quiet\*(Aq hint.
.sp
Default value is \*(Aqyes\*(Aq.
.RE
.sp
\fBdebug\fP
.RS 4
Determines whether diagnostic debugging information is shown.
.sp
Useful for troubleshooting, but not for general use.
.sp
Default value is \*(Aqoff\*(Aq.
.RE
.sp
\fBdebug.indicator\fP
.RS 4
The debug output prefix string.
.sp
Default value is \*(Aq>>\*(Aq.
.RE