1timew(1)                         User Manuals                         timew(1)
2
3
4

NAME

6       timew - A command line time tracker.
7
8

SYNOPSIS

10       timew <command> [<arg> ...]
11
12

DESCRIPTION

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

SUBCOMMANDS

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

INTERVAL

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

HINTS

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

DATES

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

DURATIONS

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

DOM

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

CONFIGURATION FILE AND OVERRIDE OPTIONS

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

MORE EXAMPLES

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

FILES

870       ~/.timewarrior/timewarrior.cfg
871              User configuration file.
872
873
874       ~/.timewarrior/data/YYYY-MM.data
875              Time tracking data files.
876
877

CREDITS & COPYRIGHTS

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

SEE ALSO

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

REPORTING BUGS

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