svenhertle/tasktime

Calculate and print spent time for a project from taskwarrior

tasktime

tasktime reads information of a project from taskwarrior and calculates, how much time was spent with this project. tasktime can print CSV or readable output.

Usage

./tasktime.py [parameters...] <project>

Parameters

-h, --help              Show help message
-c, --csv               Print output in CSV format
-n, --null              Print also tasks without time information (default: no)
-t, --task [cmd]        Change task command

Prepare taskwarrior

You have to add journal.time=on to your taskwarrior configuration (.taskrc). Taskwarrior will save start and stop annotations from now on. This annotations are evaluated by tasktime.

Note time with taskwarrior

taskwarrior has the operations start and stop. This information is used to calculate the spent time. You have to start and stop the tasks you work on.

Example:

task 2 start

# Work on task 2...

task 2 stop

Examples

Default output

./tasktime.py cool-project

Output:

Project: cool-project

Do something cool
    Duration: 00:13:05
Do something really cool
    Duration: 02:18:35

Sum: 02:31:40

Print also tasks without time

./tasktime.py -n cool-project

Output:

Project: cool-project

Do something cool
    Duration: 00:13:05
Do something boring
Do something really cool
    Duration: 02:18:35

Sum: 02:31:40

CSV output

./tasktime.py -c cool-project

Output:

"Project","cool-project"
"",""
"Description","Duration (hours)"
"",""
"Do something cool","00:13:05"
"Do something really cool","02:18:35"
"",""
"Sum","02:31:40"

Contact and copyright

Sven Hertle <sven.hertle@googlemail.com>

tasktime is distributed under the MIT license. See http://www.opensource.org/licenses/MIT for more information.