---
title: "timewarrior"
tags: [ "data", "tracking", "time", "timew" ]
---
# Summaries

Try:

```sh
timew summary :yesterday
```

You can also use :week, :lastweek, :month, :quarter, :year, or a range such as:

```sh
timew summary today to tomorrow
timew today - tomorrow
2018-10-15T06:00 - 2018-10-17T06:00
```

Each of these can gain with the :ids tag.

# Basics

```sh
timew start
timew stop
timew continue
timew summary
timew tags
```

And add ids with:

```sh
timew summary :ids
timew track 10am - 1pm timewarrior
timew track 1pm for 2h walk
```

# Adjusting Timewarrior

First get ids.

```sh
timew summary :ids
```

Then if we're looking at task @2:

```sh
timew move @2 12:00
timew lengthen @2 3mins
```

```sh
time shorten @2 40mins
```

# Forgetting

```sh
timew start 1h ago @4
```

Or if your action actually had a break:

```sh
timew split @8
```

Or maybe not?

```sh
timew join @4 @8
timew @8 delete
```

Start at previous time

```sh
timew start 3pm 'Read chapter 12'
timew start 90mins ago 'Read chapter 12'
```

Cancel currently tracked time.

```sh
timew cancel
```

# Backdated tracking

> timew untag @3


# Hints

* :quit - for automation

* :yes

* :color

* :fill - expand the time to fill out available time

* :adjust - automatically correct overlaps

* :ids - show id numbers


# Times

* :yesterday

* :day

* :week

* :month

* :quarter

* :lastweek

* :lastmonth

* :lastquarter

* :lastyear



# Mistakes

task end.after:2015-05-01 and end.before:2015-05-31 completed

task end.after:today-1wk completed

# Errors with Python3

Replace 

> os.system('timew start ' + combined + ' :yes')

with:

> os.system('timew start ' + combined.decode() + ' :yes')

and 

> os.system('timew stop ' + combined + ' :yes')

with:

> os.system('timew stop ' + combined.decode() + ' :yes')

# Fixing Errors

```sh
curl -O https://taskwarrior.org/download/timew-dbcorrection.py
```

```sh
python timew-dbcorrections.py
```

# Setup

With taskwarrior installed as well, `locate on-modify-time`, then add it to ~/.task/hooks and make it executable.
This will track the time of any tasks used with [taskwarrior](task.md).