1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
Powerline Taskwarrior
===================
[](https://travis-ci.org/Zebradil/powerline-taskwarrior)
[](https://pypi.python.org/pypi/powerline-taskwarrior)
[](https://opensource.org/licenses/MIT)
The set of the [Powerline][1] segments for showing information from the [Taskwarrior][2] task manager.
It will show current context and the most urgent active task.
![screenshot][4]
Requirements
------------
The Taskwarrior segments require [task][2] of version 2.4.2 or higher.
Installation
------------
Installing the Taskwarrior segments can be done with pip:
```txt
pip install powerline-taskwarrior
```
On Debian (testing or unstable), installation can be performed with apt:
```txt
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
```json
{
"function": "powerline_taskwarrior.context",
"priority": 70
}
```
segment displays the most urgent active task
```json
{
"function": "powerline_taskwarrior.active_task",
"priority": 70
}
```
segment displays the most urgent next task
```json
{
"function": "powerline_taskwarrior.next_task",
"priority": 70
}
```
obsolete segment displays both of listed above
```json
{
"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.
```json
{
"function": "powerline_taskwarrior.next_task",
"priority": 70,
"args": {
"task": "taskwarrior",
"description_length": 40
}
}
```
You can add you custom color set by adding:
```json
{
"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][6].
License
-------
Licensed under [the MIT License][5].
By [German Lashevich][3].
[1]: https://powerline.readthedocs.org/en/master/
[2]: http://taskwarrior.org/
[3]: https://github.com/zebradil
[4]: https://github.com/zebradil/powerline-taskwarrior/blob/master/screenshot.png
[5]: https://github.com/zebradil/powerline-taskwarrior/blob/master/LICENSE
[6]: http://powerline.readthedocs.io/en/master/configuration/reference.html#colorschemes
|
