Malin Freeborn
ba8026e0c3
input examples are now given as ```bash input $ARG1 ``` While outputs use md's '> ' sign as a quote.
173 lines
2.1 KiB
Markdown
173 lines
2.1 KiB
Markdown
---
|
|
title: "timew"
|
|
tags: [ "Documentation", "Data" ]
|
|
---
|
|
# Summaries
|
|
|
|
Try:
|
|
|
|
```bash
|
|
timew summary :yesterday
|
|
```
|
|
|
|
You can also use :week, :lastweek, :month, :quarter, :year, or a range such as:
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
timew start
|
|
timew stop
|
|
timew continue
|
|
timew summary
|
|
timew tags
|
|
```
|
|
|
|
And add ids with:
|
|
|
|
```bash
|
|
timew summary :ids
|
|
timew track 10am - 1pm timewarrior
|
|
timew track 1pm for 2h walk
|
|
```
|
|
|
|
# Adjusting Timewarrior
|
|
|
|
First get ids.
|
|
|
|
```bash
|
|
timew summary :ids
|
|
```
|
|
|
|
Then if we're looking at task @2:
|
|
|
|
```bash
|
|
timew move @2 12:00
|
|
timew lengthen @2 3mins
|
|
```
|
|
|
|
```bash
|
|
time shorten @2 40mins
|
|
```
|
|
|
|
# Forgetting
|
|
|
|
```bash
|
|
timew start 1h ago @4
|
|
```
|
|
|
|
Or if your action actually had a break:
|
|
|
|
```bash
|
|
timew split @8
|
|
```
|
|
|
|
Or maybe not?
|
|
|
|
```bash
|
|
timew join @4 @8
|
|
timew @8 delete
|
|
```
|
|
|
|
Start at previous time
|
|
|
|
```bash
|
|
timew start 3pm 'Read chapter 12'
|
|
timew start 90mins ago 'Read chapter 12'
|
|
```
|
|
|
|
Cancel currently tracked time.
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
curl -O https://taskwarrior.org/download/timew-dbcorrection.py
|
|
```
|
|
|
|
```bash
|
|
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).
|
|
|