Color Configuration

taskwarrior-tui reads color values from your Taskwarrior taskrc file (default: ~/.taskrc).

For example, color.active is used to style the active task. If you would like to try it, open your taskrc file and change color.active=white on blue.

So color.active will take precedence over color.overdue. You can see what color.active is by running task show color.active in your shell.

The following color attributes are supported:

color.deleted
color.completed
color.active
color.alternate
color.overdue
color.scheduled
color.due.today
color.due
color.blocked
color.blocking
color.recurring
color.tagged

color.alternate is applied to every other row in the task report by default. If you want to keep that Taskwarrior color defined but disable it in the TUI, set uda.taskwarrior-tui.task-report.use-alternate-style=false.

Similarly, taskwarrior-tui-specific styles can also be customized in taskrc with the following attributes:

uda.taskwarrior-tui.style.context.active
uda.taskwarrior-tui.style.calendar.title
uda.taskwarrior-tui.style.navbar
uda.taskwarrior-tui.style.command
uda.taskwarrior-tui.style.report.scrollbar
uda.taskwarrior-tui.style.report.scrollbar.area

Color Formats

All color formats supported by Taskwarrior are recognized:

Named colors (16-color)

black  red  green  yellow  blue  magenta  cyan  white

Use on <color> to set the background:

red on blue        # red foreground, blue background
on yellow          # default foreground, yellow background

High-intensity (bright) colors

Use the bright prefix on backgrounds to get the high-intensity variant (terminal colors 8-15):

black on bright green    # bright green background
white on bright black    # bright black (dark gray) background

256-color indexed

Use color0 through color255 to access the full 256-color palette:

color196           # bright red
color60 on color60 # foreground and background using index 60

Grayscale ramp

Use gray0 through gray23 (or grey0-grey23) to access the 24-step grayscale ramp (terminal colors 232-255):

gray5              # dark gray (Color::Indexed(237))
white on gray10    # white text on mid-gray background

RGB color cube

Use rgbRGB where R, G, and B are each a digit from 0 to 5 to address the 6x6x6 color cube (terminal colors 16-231):

rgb500             # bright red  (Color::Indexed(196))
rgb050             # bright green
rgb005             # bright blue
rgb444             # medium gray-ish

Modifiers

The following text modifiers can be combined with any color:

Modifier	Effect
bold	Bold text
underline	Underlined text
inverse	Swapped foreground/background
italic	Italic text
strikethrough	Strikethrough text

Multiple modifiers can be combined:

bold underline red on blue
italic color111 on color60

bold vs bright

• bold is a text attribute. It makes text bold and uses the regular color index.
• bright is a color variant. For backgrounds, it selects the high-intensity color (index + 8).

bold red           # regular red (#1) + bold attribute
on bright red      # high-intensity red background (#9)
bold on bright red # bold text + high-intensity red background

Example: TokyoNight Moon Theme

color.active=color111 on color60
color.overdue=color203
color.due.today=color215
color.due=color111
color.blocked=color245
color.tagged=color141
color.recurring=color147
color.scheduled=color109

See advanced configuration for TUI-specific style keys.