1timew(1) User Manuals timew(1)
2
3
4
6 timew - A command line time tracker.
7
8
10 timew <command> [<arg> ...]
11
12
14 Timewarrior is a command line time tracker. It allows you to easily
15 track your time and generate summary reports.
16
17 This is a reference, not a tutorial. If you are looking for a tutorial,
18 check the online documentation here:
19
20 https://taskwarrior.org/docs/timewarrior
21
22
24 Timewarrior supports many commands. Alphabetically:
25
26
27 timew
28 When run without arguments, the default command is run, which
29 indicates whether there is any active tracking, and if so, shows
30 a summary, then exits with a code 0. If there is no active time
31 tracking, exit code is 1. See also 'get'.
32
33
34 timew cancel
35 If there is an open interval, it is abandoned. See also 'stop'.
36
37
38 timew config [<name> [<value> | '']]
39 Allows setting and removing configuration values, as an alterna‐
40 tive to directly editing your ~/.timewarrior/timewarrior.cfg
41 file. For example:
42
43 $ timew config verbose yes
44 $ timew config verbose ''
45 $ timew config verbose
46
47 The first command sets 'verbose' to 'yes'. The second sets it to
48 a blank value which overrides the default value. The third exam‐
49 ple deletes the 'verbose' setting.
50
51 When modifying configuration in this way, interactive confirma‐
52 tion will be sought. To override this confirmation, use the
53 ':yes' hint, which means you intend to answer 'yes' to the con‐
54 firmation questions:
55
56 $ timew config verbose '' :yes
57
58 If no arguments are provided, all configuration settings are
59 shown:
60
61 $ timew config
62 verbose = yes
63 ...
64
65 See also 'hints', 'show'.
66
67
68 timew continue
69 Resumes tracking of closed intervals. For example:
70
71 $ timew track 9am - 10am tag1 tag2
72 $ timew track 11am - 1pm tag3
73 $ timew continue @2
74
75 The 'continue' command creates a new interval, starting now, and
76 using the tags 'tag1' and 'tag2'. Using the 'summary' command
77 and specifying the ':ids' hint shows interval IDs. This command
78 is a convenient way to resume work without re-entering the tags.
79
80 See also 'start', 'stop'.
81
82
83 timew day [<interval>] [<tag> ...]
84 The day command shows a chart depicting a single day (today by
85 default), with colored blocks drawn on a timeline. The chart
86 summarizes the tracked and untracked time.
87
88 Charts accept date ranges and tags for filtering, or shortcut
89 hints:
90
91 $ timew day monday - today
92 $ timew day :week
93 $ timew day :month
94
95 The 'reports.day.range' configuration setting overrides the
96 default date range. The default date range shown is ':day'.
97
98 The ':blank' hint causes only the excluded time to be shown,
99 with no tracked time. This can be used to see the exclusions.
100
101 For more details, and precise times, use the 'summary' report.
102
103 See also 'week', 'month', 'summary'.
104
105
106 timew delete @<id> [@<id> ...]
107 Deletes an interval. Using the 'summary' command, and specifying
108 the ':ids' hint shows interval IDs. Using the right ID, you can
109 identify an interval to delete. For example, show the IDs:
110
111 $ timew summary :week :ids
112
113 Then having selected '@2' as the interval you wish to delete:
114
115 $ timew delete @2
116
117 See also 'cancel'.
118
119
120 timew diagnostics
121 This command shows details about your version of Timewarrior,
122 your platform, how it was built, compiler features, configura‐
123 tion, file access, extensions and more. The purpose of this
124 command is to help diagnose configuration problems and provide
125 supplemental information when reporting a problem. See also
126 'extensions'.
127
128
129 timew export [<interval>] [<tag> ...]
130 Exports all the tracked time in JSON format. Supports filtering.
131 For example:
132
133 $ timew export from 2016-01-01 for 3wks tag1
134
135
136 timew extensions
137 Displays the directory containing the extension programs and a
138 table showing each extension and its status. See also 'diagnos‐
139 tics'.
140
141
142 timew fill @<id> [@<id> ...]
143
144 The 'fill' command is used to adjust any interval to fill in
145 surrounding gaps. Using the 'summary' command, and specifying
146 the ':ids' hint shows interval IDs. Using the right ID, you can
147 identify an interval to fill. For example, show the IDs:
148
149 $ timew summary :week :ids
150
151 Then having selected '@2' as the interval you wish to fill:
152
153 $ timew fill @2
154
155 Note that you can fill multiple intervals:
156
157 $ timew fill @2 @10 @23
158
159 See also 'hints'.
160
161
162 timew gaps [<interval>] [<tag> ...]
163 Displays a summary of time that is neither tracked nor excluded
164 from tracking.
165
166 The 'reports.gaps.range' configuration setting overrides the
167 default date range. The ':blank' hint causes only the excluded
168 time to be shown, with no tracked time. The default date range
169 shown is ':day'.
170
171 The ':blank' hint causes only the excluded time to be shown,
172 with no tracked time.
173
174 See also 'summary'.
175
176
177 timew get <DOM> [<DOM> ...]
178 Validates the DOM reference, then obtains the value and displays
179 it. For example:
180
181 $ timew get dom.active
182 1
183
184 It is an error to reference an interval or tag that does not
185 exist. See also 'DOM'.
186
187
188 timew help [<command> | interval | hints | date | duration]
189 The help command shows detailed descriptions and examples of
190 commands, interval syntax, supported hints, date and duration
191 formats and DOM references. For example:
192
193 $ timew help
194 $ timew help start
195 $ timew help hints
196 $ timew help interval
197 $ timew help date
198 $ timew help duration
199 $ timew help dom
200
201
202 timew join @<id> @<id>
203 Joins two intervals, by using the earlier of the two start
204 times, and the later of the two end times, and the combined set
205 of tags. Using the 'summary' command, and specifying the ':ids'
206 hint shows interval IDs. Using the correct IDs, you can identify
207 an intervals to join. For example, show the IDs:
208
209 $ timew summary :week :ids
210
211 Then having selected '@1' and '@2' as the intervals you wish to
212 join:
213
214 $ timew join @1 @2
215
216 See also 'split', 'lengthen', 'shorten', 'resize'.
217
218
219 timew lengthen @<id> [@<id> ...] <duration>
220 The 'lengthen' command is used to defer the end date of a closed
221 interval. Using the 'summary' command, and specifying the
222 ':ids' hint shows interval IDs. Using the right ID, you can
223 identify an interval to lengthen. For example, show the IDs:
224
225 $ timew summary :week :ids
226
227 Then having selected '@2' as the interval you wish to lengthen:
228
229 $ timew lengthen @2 10mins
230
231 Note that you can lengthen multiple intervals,:
232
233 $ timew lengthen @2 @10 @23 1hour
234
235 See also 'summary', 'tag', 'untag', 'shorten', 'resize'.
236
237
238 timew month [<interval>] [<tag> ...]
239 The month command shows a chart depicting a single month (cur‐
240 rent month by default), with colored blocks drawn on a timeline.
241 The chart summarizes the tracked and untracked time.
242
243 Accepts date ranges and tags for filtering, or shortcut hints:
244
245 $ timew month 1st - today
246 $ timew month :week
247
248 The 'reports.month.range' configuration setting overrides the
249 default date range. The default date range shown is ':month'.
250
251 The ':blank' hint causes only the excluded time to be shown,
252 with no tracked time.
253
254 For more details, and precise times, use the 'summary' report.
255
256 See also 'day', 'week', 'summary'.
257
258
259 timew move @<id> <date>
260 The 'move' command is used to reposition an interval at a new
261 start time. Using the 'summary' command, and specifying the
262 ':ids' hint shows interval IDs. Using the right ID, you can
263 identify an interval to move. For example, show the IDs:
264
265 $ timew summary :week :ids
266
267 Then having selected '@2' as the interval you wish to move:
268
269 $ timew move @2 9am
270
271 See also 'summary', 'tag', 'untag', 'lengthen', 'shorten',
272 'resize'.
273
274
275 timew [report] <report> [<interval>] [<tag> ...]
276 Runs an extension report, and supports filtering data. The
277 'report' command itself is optional, which means that these two
278 commands are equivalent:
279
280 $ timew report foo :week
281 $ timew foo :week
282
283 This does however assume there is a 'foo' extension installed.
284
285
286 timew resize @<id> [@<id> ...] <duration>
287 The 'resize' command is used to change the duration of a closed
288 interval. Using the 'summary' command, and specifying the
289 ':ids' hint shows interval IDs. Using the right ID, you can
290 identify an interval to resize. For example, show the IDs:
291
292 $ timew summary :week :ids
293
294 Then having selected '@3' as the interval you wish to resize:
295
296 $ timew resize @3 15mins
297
298 Note that you can resize multiple intervals,:
299
300 $ timew resize @3 @1 @13 1hour
301
302 See also 'summary', 'tag', 'untag', 'lengthen', 'shorten'.
303
304
305 timew shorten @<id> [@<id> ...] <duration>
306 The 'shorten' command is used to advance the end date of a
307 closed interval. Using the 'summary' command, and specifying
308 the ':ids' hint shows interval IDs. Using the right ID, you can
309 identify an interval to shorten. For example, show the IDs:
310
311 $ timew summary :week :ids
312
313 Then having selected '@2' as the interval you wish to shorten:
314
315 $ timew shorten @2 10mins
316
317 Note that you can shorten multiple intervals,:
318
319 $ timew shorten @2 @10 @23 1hour
320
321 See also 'summary', 'tag', 'untag', 'lengthen', 'resize'.
322
323
324 timew show
325 Displays the effective configuration in hierarchical form. See
326 also 'config'.
327
328
329 timew split @<id> [@<id> ...]
330 Ѕplits an interval into two equally sized adjacent intervals,
331 having the same tags. Using the 'summary' command, and specify‐
332 ing the ':ids' hint shows interval
333 IDs. Using the right ID, you can identify an interval to split.
334 For example, show the IDs:
335
336 $ timew summary :week :ids
337
338 Then having selected '@2' as the interval you wish to split:
339
340 $ timew split @2
341
342 See also 'join', 'lengthen', 'shorten'.
343
344
345 timew start [<date>] [<tag> ...]
346 Begins tracking using the current time with any specified set of
347 tags. If a tag contains multiple words, therefore containing
348 spaces, use quotes to surround the whole tag. For example, this
349 command specifies two tags ('weekend' and 'Home & Garden'), the
350 second of which requires quotes.
351
352 $ timew start weekend 'Home & Garden'
353
354 An optional date may be specified to indicate the intended start
355 of the tracked time:
356
357 $ timew start 8am weekend 'Home & Garden'
358
359 If there is a previous open interval, it will be closed at the
360 given start time.
361
362 Quotes are harmless if used unnecessarily. See also 'continue',
363 'stop', 'track'.
364
365
366 timew stop [<tag> ...]
367 Stops tracking time. If tags are specified, then they are no
368 longer tracked. If no tags are specified, all tracking stops.
369 For example:
370
371 $ timew start tag1 tag2
372 ...
373 $ timew stop tag1
374
375 Initially time is tracked for both 'tag1' and 'tag2', then
376 'tag1' tracking is stopped, leaving tag2 active. To stop all
377 tracking:
378
379 $ timew stop
380
381 See also 'cancel', 'continue', 'start', 'track'.
382
383
384 timew summary [<interval>] [<tag> ...]
385 Displays a report summarizing tracked and untracked time for the
386 current day by default. Accepts date ranges and tags for filter‐
387 ing, or shortcut hints:
388
389 $ timew summary monday - today
390 $ timew summary :week
391 $ timew summary :month
392
393 The ':ids' hint adds an 'ID' column to the summary report output
394 for interval modification.
395
396 See also 'day', 'week', 'month', 'shorten', 'lengthen', 'tag',
397 'untag'.
398
399
400 timew tag @<id> [@<id> ...] <tag> [<tag> ...]
401 The 'tag' command is used to add a tag to an interval. Using the
402 'summary' command, and specifying the ':ids' hint shows interval
403 IDs. Using the right ID, you can identify an interval to tag.
404 For example, show the IDs:
405
406 $ timew summary :week :ids
407
408 Then having selected '@2' as the interval you wish to tag:
409
410 $ timew tag @2 'New Tag'
411
412 Note that you can tag multiple intervals, with multiple tags:
413
414 $ timew tag @2 @10 @23 'Tag One' tag2 tag3
415
416 See also 'summary', 'shorten', 'lengthen', 'untag'.
417
418
419 timew tags [<interval>] [<tag> ...]
420 Displays all the tags that have been used by default. When a
421 filter is specified, shows only the tags that were used during
422 that time.
423
424
425 timew track <interval> [<tag> ...]
426 The track command is used to add tracked time in the past. Per‐
427 haps you forgot to record time, or are just filling in old
428 entries. For example:
429
430 $ timew track :yesterday 'Training Course'
431 $ timew track 9am - 11am 'Staff Meeting'
432
433 Note that the track command expects a closed interval (start and
434 end time), when recording. If a closed interval is not provided,
435 the 'track' command behaves the same as the 'start' command.
436
437
438 timew untag @<id> [@<id> ...] <tag> [<tag> ...]
439 The 'untag' command is used to remove a tag from an interval.
440 Using the 'summary' command, and specifying the ':ids' hint
441 shows interval IDs. Using the right ID, you can identify an
442 interval to untag. For example, show the IDs:
443
444 $ timew summary :week :ids
445
446 Then having selected '@2' as the interval you wish to untag:
447
448 $ timew untag @2 'Old Tag'
449
450 Note that you can untag multiple intervals, with multiple tags:
451
452 $ timew untag @2 @10 @23 'Old Tag' tag2 tag3
453
454 See also 'summary', 'shorten', 'lengthen', 'tag'.
455
456
457 timew week [<interval>] [<tag> ...]
458 The week command shows a chart depicting a single week (current
459 week by default), with colored blocks drawn on a timeline. The
460 chart summarizes the tracked and untracked time.
461
462 Accepts date ranges and tags for filtering, or shortcut hints:
463
464 $ timew week
465 $ timew week monday - today
466
467 The 'reports.week.range' configuration setting overrides the
468 default date range. The default date range shown is ':week'.
469
470 The ':blank' hint causes only the excluded time to be shown,
471 with no tracked time.
472
473 For more details, and precise times, use the 'summary' report.
474
475 See also 'day', 'month', 'summary'.
476
477
479 An interval defines a block of time that is tracked. The syntax for
480 specifying an interval is flexible, and may be one of:
481
482 [from] <date>
483 [from] <date> to/- <date>
484 [from] <date> for <duration>
485 <duration> before/after <date>
486 <duration> ago
487 [for] <duration>
488
489 Examples are:
490
491 from 9:00
492 from 9am - 11am
493 from 9:00:00 to 11:00
494 from 9:00 for 2h
495 2h after 9am
496 2h before 11:00
497 2h ago
498 for 2h
499
500 An interval is said to be 'closed' if there is both a start and end,
501 and 'open' if there is no end date.
502
503
505 Timewarrior supports hints, which are single-word command line features
506 that start with a colon like this:
507
508 :week
509
510 Hints serve several purposes. This example is a shortcut for the date
511 range that defines the current week. Other hints, such as:
512
513 :quiet
514
515 Are ways to control the behavior of Timewarrior, in this case eliminat‐
516 ing all forms of feedback, for purposes of automation. The supported
517 hints are:
518
519 :quiet Turns off all feedback. For automation
520 :debug Runs in debug mode, shows many runtime details
521 :yes Overrides confirmation by answering 'yes' to the ques‐
522 tions
523
524 :color Force color on, even if not connected to a TTY
525 :nocolor Force color off, even if connected to a TTY
526 :blank Leaves tracked time out of a report
527 :fill Expand time to fill surrounding available gap
528 :adjust Automatically correct overlaps
529 :ids Displays interval ID numbers in the summary report
530
531 Range hints provide convenient shortcuts to date ranges:
532
533 :yesterday The 24 hours of the previous day
534 :day The 24 hours of the current day
535 :week This week
536 :month This month
537 :quarter This quarter
538 :year This year
539 :lastweek Last week
540 :lastmonth Last month
541 :lastquarter Last quarter
542 :lastyear Last year
543 :monday Previous monday
544 :tuesday Previous tuesday
545 :wednesday Previous wednesday
546 :thursday Previous thursday
547 :friday Previous friday
548 :saturday Previous saturday
549 :sunday Previous sunday
550
551
553 Timewarrior supports the following date formats based on ISO-8601:
554
555 <extended-date> [T <extended-time>] Extended date, optional
556 extended time
557 <date> [T <time>] Date, optional time
558 <extended-time> Extended time
559 <time> Time
560
561 extended-date:
562 YYYY-MM-DD Year, month, day
563 YYYY-MM Year, month, 1st
564 YYYY-DDD Year, Julian day 001-366
565 YYYY-WwwD Year, week number, day number
566 YYYY-Www Year, week number, day 1
567
568 extended-time:
569 hh:mm[:ss]Z Hours, minutes, optional sec‐
570 onds, UTC
571 hh:mm[:ss][+/-hh:mm] Hours, minutes, optional sec‐
572 onds, TZ
573
574 date:
575 YYYYMMDD Year, month, day
576 YYYYWww Year, week number, day number
577 YYYYDDD Year, Julian day 001-366
578
579 time:
580 hhmm[ss]Z Hour, minutes, optional sec‐
581 onds, UTC
582 hhmm[ss][+/-hh[mm]] Hour, minutes, optional sec‐
583 onds, TZ
584
585 Examples:
586 2016-06-09T08:12:00Z
587 2016-06T08:12:00+01:00
588 2016-06T08:12Z
589 2016-161
590 2016-W244
591 2016-W24
592 20160609T081200Z
593 2016W24
594 8:12:00Z
595 0812-0500
596
597 In addition to the standard date formats, the following are supported:
598
599 now Current date and time
600 today Current date at 0:00:00
601 yesterday Yesterday at 0:00:00
602 tomorrow Tomorrow at 0:00:00 (midnight
603 tonight)
604 <day-of-week> Previous named day at 0:00:00
605 <month-of-year> Previous 1st of the month at
606 0:00:00
607 hh:mm[:ss][am|a|pm|p] Short time format
608 Nst, Nnd, Nrd, Nth Previous 1st, 2nd, 3rd ...
609 <epoch> POSIX time
610 later 2038-01-18T0:00:00 (Y2K38)
611 someday 2038-01-18T0:00:00 (Y2K38)
612 sopd, eopd Start/end of previous day
613 sod, eod Start/end of current day
614 sond, eond Start/end of next day
615 sopw, eopw Start/end of previous week
616 sow, eow Start/end of current week
617 sonw, eonw Start/end of next week
618 sopww, eopww Start/end of previous work week
619 (mon - fri)
620 soww, eoww Start/end of current work week
621 (mon - fri)
622 sonww, eonww Start/end of next work week
623 (mon - fri)
624 sopm, eopm Start/end of previous month
625 som, eom Start/end of current month
626 sonm, eonm Start/end of next month
627 sopq, eopq Start/end of previous quarter
628 soq, eoq Start/end of current quarter
629 sonq, eonq Start/end of next quarter
630 sopy, eopy Start/end of previous year
631 soy, eoy Start/end of current year
632 sony, eony Start/end of next year
633 easter Easter Sunday
634 eastermonday Easter Monday
635 ascension Ascension
636 pentecost Pentecost
637 goodfriday Good Friday
638 midsommar midnight, 1st Saturday after
639 20th June
640 midsommarafton midnight, 1st Friday after 19th
641 June
642 juhannus midnight, 1st Friday after 19th
643 June
644
645 Examples:
646 8am
647 24th
648 monday
649 august
650
651 See also 'duration', 'hints'.
652
653
655 Timewarrior supports the following duration formats based on ISO-8601:
656
657 'P' [nn 'Y'] [nn 'M'] [nn 'D'] ['T' [nn 'H'] [nn 'M'] [nn 'S']]
658 PnnW
659
660 Examples:
661 P1Y 1 year
662 P1.5M 1.5 months
663 PT1S 1 second
664 PT4.5H 4.5 hours
665 PT4H30M 4.5 hours
666 P600D 600 days
667 P3W 3 weeks
668 P1Y1DT1H1M1S 1 year and 25 hours, 61 seconds (imprecise term)
669
670 Note that the year and month terms are imprecise, being defined as
671 365d and
672 30d respectively. For precision use the other terms.
673
674 In addition to the standard duration formats, the following are sup‐
675 ported:
676
677 n[.n]<unit>
678
679 Where the <unit> is one of:
680
681 annual
682 biannual
683 bimonthly
684 biweekly
685 biyearly
686 daily
687 days, day, d
688 fortnight
689 hours, hour, hrs, hr, h
690 minutes, minute, mins, min
691 monthly, months, month, mnths, mths, mth, mos, mo, m
692 quarterly, quarters, quarter, qrtrs, qtr, q
693 semiannual
694 sennight
695 seconds, second, secs, sec, s
696 weekdays
697 weekly, weeks, week, wks, wk, w
698 yearly, years, year, yrs, yr, y
699
700 Examples:
701 1hour 60 minutes
702 1.5h 90 minutes
703 3mo 3 months
704 10d 10 days
705
706 Note that the year, quarter and month terms are imprecise, being
707 defined as
708 365d, 91d and 30d respectively. For precision use the other terms.
709
710
712 Supported DOM references are:
713
714 dom.tag.count Count of all tags
715 dom.tag.1 Nth tag used
716
717 dom.active '1' if there is active tracking, otherwise
718 '0'
719 dom.active.tag.count Count of active tags
720 dom.active.tag.1 Active Nth tag
721 dom.active.start Active start timestamp (ISO Extended local
722 date)
723 dom.active.duration Active elapsed (ISO Period)
724 dom.active.json Active interval as JSON
725
726 dom.tracked.count Count of tracked intervals
727 dom.tracked.1.tag.count Count of active tags
728 dom.tracked.1.tag.1 Tracked Nth, Nth tag
729 dom.tracked.1.start Tracked Nth, start time
730 dom.tracked.1.end Tracked Nth, end time, blank if closed
731 dom.tracked.1.duration Tracked Nth, elapsed
732 dom.tracked.1.json Tracked Nth, interval as JSON
733
734 dom.rc.<name> Configuration setting
735
736
738 Timewarrior stores its configuration in a file in the user's home
739 directory: ~/.timewarrior/timewarrior.cfg.
740
741 This file contains a mix of rules and configuration settings. Note that
742 the environment variable $TIMEWARRIORDB can be set to override this
743 location.
744
745 The values 'true', '1', 'y', 'yes' and 'on' are all equivalent and
746 enable a setting. Any other value means disable the setting.
747
748 Default values may be overridden by timewarrior.cfg values, which may
749 in turn be overridden on the command line using:
750
751 rc.<name>=<value>
752
753 For example, to turn off verbose mode:
754
755 rc.verbose=0
756
757 Note that hints can also do this (:quiet).
758
759
760 confirmation = yes
761 Determines whether harmful operations require interactive con‐
762 firmation. May be overridden by the ':yes' hint. Default value
763 is 'yes'.
764
765
766 debug = off
767 Determines whether diagnostic debugging information is shown.
768 Useful for troubleshooting, but not for general use. Default
769 value is 'off'.
770
771
772 debug.indicator = >>
773 The debug output prefix string. Default value is '>>'.
774
775
776 reports.<type>.cell = 15
777 Determines how many minutes are represented by a single charac‐
778 ter cell, for the charts. A value of '15' means that an hour is
779 represented by 60/15, or 4 character cells. Suitable values are
780 the divisors of 60 (30, 20, 15, 12, ...). The value must be
781 greater than '0'. Default value is '15'. Type is one of
782 'month', 'week', 'day'.
783
784
785 reports.<type>.day = yes
786 Determines whether the current day of the month is shown at left
787 margin. Default value is 'yes'. Type is one of 'month',
788 'week', 'day'.
789
790
791 reports.<type>.holidays = yes
792 Determines whether relevant holidays are shown beneath the
793 report. Default value is 'yes'. Type is one of 'month',
794 'week', 'day', 'summary'.
795
796
797 reports.<type>.hours = all
798 Determines how the <type> report shows all the hours in a day
799 ('all'), or is limited to only hours where data is tracked
800 ('auto'). Default value is 'all'. Type is one of 'month',
801 'week', 'day'.
802
803
804 reports.<type>.lines = 1
805 Determines how many lines are used to render each day on the
806 <type> report. Default value is '1'. Type is one of 'month',
807 'week', 'day'.
808
809
810 reports.<type>.month = yes
811 Determines whether the current month is shown at left margin.
812 Default value is 'yes'. Type is one of 'month', 'week', 'day'.
813
814
815 reports.<type>.range = <range hint>
816 For reports that show a range of data, this setting will over‐
817 ride the default value. The value should be a range hint, see
818 'hints' Type is one of 'gaps', 'day', 'week', 'month'.
819
820
821 reports.<type>.spacing = 1
822 Specifies how many spaces are inserted between the hours in the
823 <type> report exclusions. A value of '0' yields a more compact
824 report. Default value is '1'. Type is one of 'month', 'week',
825 'day'.
826
827
828 reports.<type>.axis = internal
829 The value 'internal' puts the hour markers inside the exclusion
830 blocks. Default is <no value>.
831
832
833 reports.<type>.summary = on
834 Determines whether the hours summary is shown. Default value is
835 'on'. Type is one of 'month', 'week', 'day'.
836
837
838 reports.<type>.totals = on
839 Determines whether the time totals are shown for each day on the
840 report. Default value is 'on'. Type is one of 'month', 'week',
841 'day'.
842
843
844 reports.<type>.week = yes
845 Determines whether the current week number is shown at left mar‐
846 gin. Default value is 'yes'. Type is one of 'month', 'week',
847 'day'.
848
849
850 reports.<type>.weekday = yes
851 Determines whether the current weekday is shown at left margin.
852 Default value is 'yes'. Type is one of 'month', 'week', 'day'.
853
854
855 verbose = yes
856 Determines whether Timewarrior generates feedback. May be over‐
857 ridden by the ':quiet' hint. Default value is 'yes'.
858
859
861 For examples please see the online documentation starting at:
862
863 <http://taskwarrior.org/docs/timewarrior/>
864
865 Note that the online documentation can be more detailed and more cur‐
866 rent than this man page.
867
868
870 ~/.timewarrior/timewarrior.cfg
871 User configuration file.
872
873
874 ~/.timewarrior/data/YYYY-MM.data
875 Time tracking data files.
876
877
879 Copyright (C) 2015 - 2018 P. Beckingham, F. Hernandez.
880
881 Timewarrior is distributed under the MIT license. See http://www.open‐
882 source.org/licenses/mit-license.php for more information.
883
884
886 For more information regarding Timewarrior, see the following:
887
888
889 The official site at
890 <http://taskwarrior.org>
891
892
893 The official code repository at
894 <https://git.tasktools.org/scm/tm/timew.git>
895
896
897 You can contact the project by emailing
898 <support@taskwarrior.org>
899
900
902 Bugs in Timewarrior may be reported to the issue-tracker at
903 <https://bug.tasktools.org/>
904
905
906
907
908timew 1.1.1 2018-02-03 timew(1)