[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.
Differences
This shows you the differences between two versions of the page.
Next revisionBoth sides next revision | |||
howtos:general_admin:taskwarrior [2012/09/26 00:49 (UTC)] – moved page from the general howtos namespace mfillpot | howtos:general_admin:taskwarrior [2013/01/07 02:22 (UTC)] – general cleanup mfillpot | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | <!-- Reviewed 2013-01-06 mfillpot --> | ||
<!-- Add your text below. We strongly advise to start with a Headline (see button bar above). --> | <!-- Add your text below. We strongly advise to start with a Headline (see button bar above). --> | ||
====== Todo Lists in TaskWarrior ====== | ====== Todo Lists in TaskWarrior ====== | ||
- | + | [[http:// | |
- | [[http:// | + | powerful command-line todo list manager which can be installed from |
+ | [[http:// | ||
+ | that it depends on [[http:// | ||
===== Managing Your Todo List ===== | ===== Managing Your Todo List ===== | ||
Line 9: | Line 12: | ||
1. By invoking the '' | 1. By invoking the '' | ||
- | + | < | |
- | < | + | % task shell |
task 2.1.1 shell | task 2.1.1 shell | ||
Line 17: | Line 20: | ||
Enter ' | Enter ' | ||
- | task></ | + | task> |
+ | </ | ||
- | 2. By typing '' | + | 2. By typing '' |
- | + | preceded with the '' | |
- | <code>alias t=task</code> | + | to take in this tutorial. In order to limit the amount of typing we could |
+ | create a shell alias. If you use Bash, please edit (or create) the | ||
+ | following file '' | ||
+ | <file sh .bashrc> | ||
+ | alias t=task | ||
+ | </file> | ||
In this HOWTO we are going to use the full '' | In this HOWTO we are going to use the full '' | ||
=== Adding Tasks === | === Adding Tasks === | ||
- | + | < | |
- | < | + | % task add Email Bob |
Created task 1. | Created task 1. | ||
% task add priority:H Book a ticket | % task add priority:H Book a ticket | ||
- | Created task 2.</ | + | Created task 2. |
+ | </ | ||
We have just created 2 tasks with the second one being of high priority. | We have just created 2 tasks with the second one being of high priority. | ||
=== Adding Due Dates === | === Adding Due Dates === | ||
- | + | < | |
- | < | + | % task 1 modify due: |
% task 4 modify due:today | % task 4 modify due:today | ||
- | % task 5 modify due: | + | % task 5 modify due:3days |
+ | </ | ||
=== Displaying Tasks === | === Displaying Tasks === | ||
- | + | < | |
- | < | + | % task |
ID Project Pri Due A Age Urgency Description | ID Project Pri Due A Age Urgency Description | ||
Line 48: | Line 59: | ||
| | ||
- | 2 tasks</ | + | 2 tasks |
- | + | </ | |
- | Please note that because of high priority, task 2 is at the top of the list. There are a few ways you can list your tasks: | + | |
+ | Please note that because of high priority, task 2 is at the top of the | ||
+ | list. There are a few ways you can list your tasks: | ||
* task | * task | ||
* task minimal | * task minimal | ||
Line 61: | Line 73: | ||
=== Starting a Task === | === Starting a Task === | ||
- | + | < | |
- | < | + | % task 1 start |
+ | </ | ||
=== Marking Tasks as Done === | === Marking Tasks as Done === | ||
- | + | < | |
- | < | + | % task 2 done |
Completed task 2 'Book a ticket' | Completed task 2 'Book a ticket' | ||
Completed 1 task. | Completed 1 task. | ||
Line 74: | Line 87: | ||
| | ||
- | 1 task</ | + | 1 task |
+ | </ | ||
=== Deleting Tasks === | === Deleting Tasks === | ||
- | + | < | |
- | < | + | % task 1 delete |
+ | </ | ||
Alternatively, | Alternatively, | ||
- | < | + | < |
+ | % task undo | ||
+ | </ | ||
=== Duplicating Tasks === | === Duplicating Tasks === | ||
- | |||
We have got the following task: | We have got the following task: | ||
- | < | + | < |
- | | + | ID Project Pri Due A Age Urgency Description |
+ | | ||
+ | </ | ||
You can duplicate the task with some modifications | You can duplicate the task with some modifications | ||
- | < | + | < |
+ | % task 4 duplicate / | ||
+ | </ | ||
- | < | + | < |
+ | ID Project Pri Due A Age Urgency Description | ||
| | ||
- | | + | |
+ | </ | ||
=== Modifying Tasks === | === Modifying Tasks === | ||
- | |||
You have just realised that one of your tasks contains a spelling mistake: | You have just realised that one of your tasks contains a spelling mistake: | ||
- | < | + | < |
+ | ID Project Pri Due A Age Urgency Description | ||
... | ... | ||
- | | + | |
+ | </ | ||
We can modify an existing task: | We can modify an existing task: | ||
+ | < | ||
+ | % task 6 modify / | ||
+ | </ | ||
- | <code>% task 6 modify / | + | < |
- | + | ID Project Pri Due A Age Urgency Description | |
- | < | + | |
| | ||
| | ||
Line 123: | Line 148: | ||
11 2m 0 Change my email address on SlackBuilds.org | 11 2m 0 Change my email address on SlackBuilds.org | ||
12 | 12 | ||
- | 13 1s 0 Upgrade SlackBuilds</ | + | 13 1s 0 Upgrade SlackBuilds |
+ | </ | ||
- | + | < | |
- | < | + | % task 1-6 modify project: |
% task 7,9,11,13 modify project:SB | % task 7,9,11,13 modify project:SB | ||
- | % task 8,10 modify project: | + | % task 8,10 modify project: |
+ | </ | ||
- | < | + | < |
+ | ID Project Pri Due A Age Urgency Description | ||
13 SB H | 13 SB H | ||
10 home H | 10 home H | ||
Line 145: | Line 173: | ||
3 misc L | 3 misc L | ||
- | 13 tasks</ | + | 13 tasks |
+ | </ | ||
You can display a breakdown of your projects: | You can display a breakdown of your projects: | ||
- | + | < | |
- | < | + | % task projects |
Project Tasks Pri:None Pri:L Pri:M Pri:H | Project Tasks Pri:None Pri:L Pri:M Pri:H | ||
Line 157: | Line 186: | ||
misc 6 0 | misc 6 0 | ||
- | 3 projects (13 tasks)</ | + | 3 projects (13 tasks) |
+ | </ | ||
=== Adding / Removing Tags === | === Adding / Removing Tags === | ||
- | |||
You can add tags by: | You can add tags by: | ||
- | + | < | |
- | < | + | % task 3,5,7-10 modify +work |
+ | </ | ||
You can remove tags by: | You can remove tags by: | ||
+ | < | ||
+ | % task 7 modify -work | ||
+ | </ | ||
- | <code>% task 7 modify -work</ | + | <note> |
- | + | Please note that tags are only displayed when you list your tasks with the | |
- | < | + | '' |
+ | </ | ||
=== Selective Display of Tasks === | === Selective Display of Tasks === | ||
- | |||
Display your tasks by priority: | Display your tasks by priority: | ||
- | + | < | |
- | < | + | % task priority:H |
[task next priority:H] | [task next priority:H] | ||
Line 185: | Line 218: | ||
12 | 12 | ||
- | 5 tasks</ | + | 5 tasks |
+ | </ | ||
Display your tasks by project: | Display your tasks by project: | ||
- | + | < | |
- | < | + | % task project:SB |
[task next project:SB] | [task next project:SB] | ||
Line 198: | Line 232: | ||
7 SB L | 7 SB L | ||
- | 4 tasks</ | + | 4 tasks |
+ | </ | ||
Display your tasks by tag: | Display your tasks by tag: | ||
- | + | < | |
- | < | + | % task +work |
+ | </ | ||
=== Adding annotations === | === Adding annotations === | ||
- | |||
You can annotate a task: | You can annotate a task: | ||
+ | < | ||
+ | % task 9 annotate i3 builds fine | ||
+ | </ | ||
- | <code>% task 9 annotate i3 builds fine</code> | + | < |
- | + | ID Project Pri Due A Age Urgency Description | |
- | < | + | |
... | ... | ||
9 SB M 1h 5.8 Test my SlackBuilds on Slackware 14 | 9 SB M 1h 5.8 Test my SlackBuilds on Slackware 14 | ||
| | ||
| | ||
- | ...</ | + | ... |
+ | </ | ||
=== Displaying Statistics === | === Displaying Statistics === | ||
- | + | < | |
- | < | + | % task stats |
+ | </ | ||
===== Colours in TaskWarrior ===== | ===== Colours in TaskWarrior ===== | ||
- | + | You can enable one of the colour themes in '' | |
- | You can enable one of the colour themes in ~/.taskrc by uncommenting one of the lines: | + | one of the lines: |
- | + | <file sh .taskrc> | |
- | <code># Color theme (uncomment one to use) | + | # Color theme (uncomment one to use) |
#include / | #include / | ||
#include / | #include / | ||
Line 235: | Line 274: | ||
#include / | #include / | ||
#include / | #include / | ||
- | #include / | + | #include / |
+ | </file> | ||
The '' | The '' | ||
- | + | {{ : | |
- | {{ : | + | |
You can display current colours (variables + colour values) with: | You can display current colours (variables + colour values) with: | ||
+ | < | ||
+ | % task color legend | ||
+ | </ | ||
- | < | + | Colour themes can be easily customised by editing theme files. All |
- | + | the theme files are located in ''/ | |
- | Colour themes can be easily customised by editing theme files. All the theme files are located in ''/ | + | |
===== Displaying a Calendar ===== | ===== Displaying a Calendar ===== | ||
+ | All the tasks that have a due date assigned will be marked on the | ||
+ | calendar. Additionally you can enable the display of holidays by | ||
+ | specifying a country in '' | ||
+ | <file sh .taskrc> | ||
+ | include / | ||
+ | </ | ||
- | All the tasks that have a due date assigned will be marked on the calendar. Additionally you can enable the display of holidays by specifying a country in '' | + | The ''/ |
- | + | countries as well. | |
- | < | + | |
- | + | ||
- | The ''/ | + | |
===== TaskWarrior Integration ===== | ===== TaskWarrior Integration ===== | ||
- | + | TaskWarrior is a very flexible and powerful tool. What makes it even | |
- | TaskWarrior is a very flexible and powerful tool. What makes it even more useful is the possibility of integrating it into your working environment. | + | more useful is the possibility of integrating it into your working |
+ | environment. | ||
==== TaskWarrior and i3 ==== | ==== TaskWarrior and i3 ==== | ||
- | + | 1. You issue TaskWarrior commands from '' | |
- | 1. You issue TaskWarrior commands from '' | + | <key>A-d</ |
- | + | < | |
- | < | + | task add priority:H due:2days Mom's birthday |
+ | </ | ||
2. Assign basic keybindings. | 2. Assign basic keybindings. | ||
- | + | <file sh display_tasks.sh> | |
- | <file sh display_tasks.sh># | + | #!/bin/sh |
task ls | task ls | ||
read -p "Press Enter to close the window."</ | read -p "Press Enter to close the window."</ | ||
'' | '' | ||
- | < | + | < |
... | ... | ||
for_window [title=" | for_window [title=" | ||
Line 280: | Line 326: | ||
</ | </ | ||
- | This will enable the floating mode for any window entitled '' | + | This will enable the floating mode for any window entitled '' |
- | + | The < | |
- | 3. [[howtos: | + | your tasks in a floating mode in the middle of the screen. The |
+ | < | ||
+ | keybinding will mark your top task as completed (Please see | ||
+ | [[howtos: | ||
+ | keys]]). | ||
+ | 3. [[howtos: | ||
+ | the top task]] in '' | ||
====== Sources ====== | ====== Sources ====== | ||
- | |||
* Originally written by [[wiki: | * Originally written by [[wiki: | ||
<!-- * Contrbutions by [[wiki: | <!-- * Contrbutions by [[wiki: | ||
Line 294: | Line 344: | ||
<!-- You must also remove the tag-word " | <!-- You must also remove the tag-word " | ||
{{tag> | {{tag> | ||
+ |