/powerline-taskwarrior

A Powerline segment for showing information from Taskwarrior task manager.

Primary LanguagePythonMIT LicenseMIT

Powerline Taskwarrior

Build Status PyPI PyPI

The set of the Powerline segments for showing information from the Taskwarrior task manager.

It will show current context and the most urgent active task.

screenshot

Requirements

The Taskwarrior segments require task of version 2.4.2 or higher.

Installation

Installing the Taskwarrior segments can be done with pip:

pip install powerline-taskwarrior

On Debian (testing or unstable), installation can be performed with apt:

apt install python-powerline-taskwarrior

Then you can activate the Taskwarrior segments by adding it to your segment configuration, for example in ~/.config/powerline/themes/shell/default.json:

segment displays current context name

{
    "function": "powerline_taskwarrior.context",
    "priority": 70
}

segment displays the most urgent active task

{
    "function": "powerline_taskwarrior.active_task",
    "priority": 70
}

segment displays the most urgent next task

{
    "function": "powerline_taskwarrior.next_task",
    "priority": 70
}

obsolete segment displays both of listed above

{
    "function": "powerline_taskwarrior.taskwarrior",
    "priority": 70
}

Configuration

If you have custom name for task, you should specify it in segment configuration. powerline_taskwarrior.active_task and powerline_taskwarrior.next_task segments accept description_length parameter. It's maximum length of description. If the description is longer, it is truncated by words. powerline_taskwarrior.next_task segment accepts ignore_active parameter. If it set to true segment will be shown always, regardless of existence active task.

{
    "function": "powerline_taskwarrior.next_task",
    "priority": 70,
    "args": {
        "task": "taskwarrior",
        "description_length": 40
    }
}

You can add you custom color set by adding:

{
  "taskwarrior:context":       "information:regular",
  "taskwarrior:active_id":     { "bg": "mediumgreen", "fg": "black", "attrs": [] },
  "taskwarrior:active_desc":   { "bg": "green", "fg": "black", "attrs": [] },
  "taskwarrior:next_id":       { "bg": "brightyellow", "fg": "black", "attrs": [] },
  "taskwarrior:next_desc":     { "bg": "yellow", "fg": "black", "attrs": [] }
}

to your colorschemes (.config/powerline/colorschemes/default.json). See powerline colorschemes docs.

License

Licensed under the MIT License.

By German Lashevich.