lk/data/taskwarrior/timew.md
Malin Freeborn ba8026e0c3
change formatting
input examples are now given as

```bash
input $ARG1
```

While outputs use md's '> ' sign as a quote.
2023-06-17 21:28:20 +02:00

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).