Charts

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 day 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 passes.

Like the summary report, the :ids hint is supported by the day report, for making corrections.

Various command-line overrides can be used to customize the day 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.

The day report is simply an interpretation of the same data shown by the summary report. Use the summary report to show precise timings.

If you have defined your work week then the 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 gaps command 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 week report, which shows multiple days in a more compact form, for the current week.

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: :yesterday, :week, :month, :quarter, :year, :lastweek, :lastmonth, :lastquarter, and :lastyear.

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.