NAME¶
timew-summary - display a time-tracking summary
SYNOPSIS¶
timew summary [<range>] [<tag>...]
timew summary [<id>...]
DESCRIPTION¶
Displays a table summarizing tracked time, by default for the
current day. Accepts date ranges (or range hints) and tags, or ids for
filtering.
When ids are given, date ranges are ignored. Specifying both, tags
and ids, is an error.
HINTS¶
Apart from range hints (see timew-hints(7)), the summary
report adheres to the following hints:
:annotations, :no-annotations
Toggle the display of annotations in the summary report.
Can be used on the command line to override the configured setting. The
':annotations' hint adds an 'Annotation' column to the summary table. The
annotation column is limited to 15 characters. Longer values in this column
are truncated to 12 characters and shown with an ellipsis attached.
:holidays, :no-holidays
Toggle the display of holidays in the summary report. Can
be used on the command line to override the configured setting.
:ids, :no-ids
Toggle the display of ids in the summary report. Can be
used on the command line to override the configured setting. The ':ids' hint
adds an 'ID' column to the summary table. Those ids can be used for interval
modification.
:tags, :no-tags
Toggle the display of tags in the summary report. Can be
used on the command line to override the configured setting. The ':tags' hint
adds a 'Tags' column to the summary table.
CONFIGURATION¶
reports.summary.annotations
Determines whether the annotation column is shown in the
summary. Can be overridden by the ':annotations' or ':no-annotations' hint,
respectively. Default value is 'no'
reports.summary.holidays
Determines whether relevant holidays are shown beneath
the report. Can be overridden by the ':holidays' or ':no-holidays' hint,
respectively. Default value is 'yes'.
reports.summary.ids
Determines whether the id column is shown in the summary.
Can be overridden by the ':ids' or ':no-ids' hint, respectively. Default value
is 'no'.
reports.summary.tags
Determines whether the tags column is shown in the
summary. Can be overridden by the ':tags' or ':no-tags' hint, respectively.
Default value is 'yes'.
reports.summary.range
Set the date range for the summary report. The value has
to correspond to a range hint, see
timew-hints(7). Default value is
'day'
reports.summary.weekdays
Determines whether the weekday column is shown in the
summary. Default value is 'yes'
reports.summary.weeks
Determines whether the week column is shown in the
summary. Default value is 'yes'
tags.<tag>.color
Assigns a specific foreground and background color to a
tag. Examples of valid colors include 'white', 'gray8', 'black on yellow', and
'rgb345'.