SysTutorials

Linux Manual Pages › Section 5

taskrc(5)

taskrc – Configuration details for the

task(1) command

Synopsis

$HOME/.taskrc
task rc:<directory-path>/.taskrc …
TASKRC=<directory-path>/.taskrc task …

Description

Taskwarrior obtains its configuration data from a file called .taskrc . This file is normally located in the user’s home directory:

$HOME/.taskrc

The default location can be overridden using the rc: attribute when running task:

$ task rc:<directory-path>/.taskrc …

or using the TASKRC environment variable:

$ TASKRC=/tmp/.taskrc task …

Individual options can be overridden by using the rc.<name>: attribute when running task:

$ task rc.<name>:<value> …

or

$ task rc.<name>=<value> …

If Taskwarrior is run without an existing configuration file it will ask if it should create a default, sample .taskrc file in the user’s home directory. The .taskrc file follows a very simply syntax defining name/value pairs:

<name> = <value>

There may be whitespace around <name>, ‘=’ and <value>, and it is ignored. Whitespace within the <value> is left intact. Whitespace is not permitted in comma-separated lists. The entry must be on a single line, no continuations. Values support UTF8 as well as JSON encoding, such as