00:00-01:00 00:00 0%

× v1.2 @

Average : per day.

Used in the calendar view to center the color of a day around this targeted average value; and in the headlines view as the day divisor.

Pace day by minutes.

Used in the day view as the time span of each box.

Display weekends , or count as bonus.

Used in the calendar view to display weekend days. When weekends are not displayed, the bonus increases the working time without increasing the number of days.

First glance for weekdays , months and years.

Used in the calendar view to independently display ellipses for weekdays, months and years.

With file org-clock.csv from to spanning 240 days, with an average of 05:13 worked per day.

The CSV input file contains, in any order, the following mandatory and ~~optional~~ fields:

task
parents
start
end
~~effort~~
~~ishabit~~
~~tags~~

A task is placed under its parents in the headlines view.
The start and end fields must be in any format that will correctly be parsed by the JavaScript Date constructor (eg.
```
'YYYY-MM-DD HH:mm'
```
).
The ~~effort~~ should be in a form that can be parsed as a duration, typically
```
'HH:mm'
```
, while ~~ishabit~~ must contain
```
t
```
to be considered true.
For a task with multiple entries, only the last encountered entry will be kept for those two fields.
The ~~tags~~ field is however incremental as each entry will add its own set of tags to the list of tags previously collected for a task.

Such a file can easily be obtained for Org-mode documents using org-clock-csv.

All displayed data in every view is within the starting date and the ending date.

The number of days for which at least one entry exists is displayed and a mouse hover shows the number of weekend days that it encompasses.

The average number of hours per day is then displayed and a mouse hover shows the percentage of the targeted average.

Day

Displays the typical averaged repartition of working hours during a day.

Every box represents a period of time by which the day is paced. Its color indicates the amount of time spent in average during this period, white being 0 and the maximum of the period being the selected color. When the mouse hovers a box, the spanning duration is displayed as well as the average amount of time spent and the corresponding percentage.

When the pace is not a divider of the number of minutes in a day, the last square represents the remainder to 00:00, although it as the same size as the others.

Headlines

Displays the hierarchy of headlines, with for each headline, the total number of hours spent between the starting date end the ending date, cumulating children; a mouse hover the duration reveals the percentage within its parent cumulated time.

If in bold font, the headline is selected and counted in the day and calendar views, it also counts towards its parent time.
Headlines can be toggled on and off by clicking on their titles. They can also be folded using the arrows on the beginning of the line. A folded arrow will be plain if all the headlines within it are selected, otherwise, it will be empty.

If an effort is specified for an headline, a gauge will be displayed. When mouse hovered, it displays the exact percentage as well as the effort itself.
If the pointer is vertical, then the amount of time spent is equal to the anticipated effort. When on the right side, the time spent is less than anticipated. When on the left side, more time has been spent and the pointer remains on the leftmost position as soon as the time spent exceed the anticipated effort by a factor 2.

The first line displays all tags. If all the headlines with a given tag are selected the background is colored, otherwise it is greyed. The first tag called

None

can be used to toggle all tags at the same time.

Similarly, the

None

and

All

texts on the second line can be used to toggle headlines all at once. It also displays the total amount of time spent.

Calendar

Displays every day between the starting date end the ending date.

The color of a day is white for 0 hours and corresponds to the selected color when equal to the targeted average. It gets darker past this point until it becomes black when it is over the maximum per day set at 10 hours.

Ellipses are displayed for weekdays, months and years such that:

their color is centered around the targeted average per day across all the corresponding period of time;
their X radius is a factor of the standard deviation divided by the average per day, yielding a circle for a standard deviation of 0.

A mouse hover on a weekday, month, or year ellipse displays the total time spent during those durations; a mouse hover on the associated ellipses reveals the average and the standard deviation.