Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
TIMEW-CONFIG(7) 		  User Manuals			 TIMEW-CONFIG(7)

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 ~/.time-
     warrior 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/timewar-
     rior.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
	 Determines whether harmful operations require interactive confirmation.

	 May be overridden by the ':yes' hint.

	 Default value is 'yes'.

     verbose
	 Determines whether Timewarrior generates feedback.

	 May be overridden by the ':quiet' hint.

	 Default value is 'yes'.

     debug
	 Determines whether diagnostic debugging information is shown.

	 Useful for troubleshooting, but not for general use.

	 Default value is 'off'.

     debug.indicator
	 The debug output prefix string.

	 Default value is '>>'.

timew 1.9.1			   2025-08-27			 TIMEW-CONFIG(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=timew-config&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help