Timewarrior can show simple charts in your terminal that show how your day is being tracked. These are neither high-resolution, nor precise, and are only intended to show a crude representation of the day.
As an example, let's do some gardening time tracking. We will add
an interval, then use the
day report to represent that:
A two-hour interval was tracked for this morning. The
report shows that as a red interval superimposed on the hours of the day.
The tags are displayed within red rectangle.
At the left you see the day is Sunday the 19th, and the date and the current hour, 14, is highlighted. Beneath the chart are some totals, showing that two hours are tracked, 22 hours remain open, for a total of 24 hours in the day.
Now we'll add another interval:
The second interval is shown in blue, and these colors are extracted from a palette defined in the theme. See how the totals are adjusted. Finally we add an open interval:
The open interval, shown in green, has a
+ symbol that
indicates it is open and being actively tracked. If you run this report
periodically, you'll see the green interval grow to the right as time
Various command-line overrides can be used to customize the
report. Here is an example that makes the color bars taller. For a complete
set of all configuration settings, use the
man timew command
where the man page lists everything.
This override changes how many hours are shown, from all of them, to a clipped range slightly wider than the tracked hours.
day report is simply an interpretation of the same data
shown by the
summary report. Use the
report to show precise timings.
If you have defined your
day report will show the blocked-off time, here
shown in gray. Notice that this affects the totals.
Now with both intervals and exclusions, the
will tell you where the blocks of untracked time are.
All reports support the
:blank hint, which hides all data.
This is useful for checking that the excluded time is set up correctly.
In addition to the
day report, there is a
report, which shows multiple days in a more compact form, for the current
There is also a
month report. These are defined just for
convenience, but with a command line interval specified, the reports
can show any date range:
In place of specifying a date range, a hint may be used, such as:
See also how the holidays are shown, in this case with 2016-05-30 being Memorial Day in the US. The day is marked as an exclusion, and the date grayed out.
Many of the elements of the
day report are customizable.
For a complete set of all configuration settings, use the
man timew command for all supoprted overrides.