Module i3status_rs::blocks::taskwarrior

source ·
Expand description

The number of tasks from the taskwarrior list

Clicking the right mouse button on the icon cycles the view of the block through the user’s filters.

§Configuration

KeyValuesDefault
intervalUpdate interval in seconds600 (10min)
warning_thresholdThe threshold of pending (or started) tasks when the block turns into a warning state10
critical_thresholdThe threshold of pending (or started) tasks when the block turns into a critical state20
filtersA list of tables with the keys name and filter. filter specifies the criteria that must be met for a task to be counted towards this filter.[{name = "pending", filter = "-COMPLETED -DELETED"}]
formatA string to customise the output of this block. See below for available placeholders." $icon $count.eng(w:1) "
format_singularSame as format but for when exactly one task is pending." $icon $count.eng(w:1) "
format_everything_doneSame as format but for when all tasks are completed." $icon $count.eng(w:1) "
data_locationDirectory in which taskwarrior stores its data files. Supports path expansions e.g. ~."~/.task"
PlaceholderValueTypeUnit
iconA static iconIcon-
countThe number of tasks matching current filterNumber-
filter_nameThe name of current filterText-
ActionDefault button
next_filterRight

§Example

In this example, block will be hidden if count is zero.

[[block]]
block = "taskwarrior"
interval = 60
format = " $icon count.eng(w:1) tasks "
format_singular = " $icon 1 task "
format_everything_done = ""
warning_threshold = 10
critical_threshold = 20
[[block.filters]]
name = "today"
filter = "+PENDING +OVERDUE or +DUETODAY"
[[block.filters]]
name = "some-project"
filter = "project:some-project +PENDING"

§Icons Used

  • tasks

Structs§

Functions§