1TIMEW-SUMMARY(1)                 User Manuals                 TIMEW-SUMMARY(1)
2
3
4

NAME

6       timew-summary - display a time-tracking summary
7

SYNOPSIS

9       timew summary [<range>] [<tag>...]
10

DESCRIPTION

12       Displays a table summarizing tracked time, by default for the current
13       day. Accepts date ranges, or range hints, and tags for filtering.
14

HINTS

16       Apart from range hints (see timew-hints(7)), the summary report adheres
17       to the following hints:
18
19       :annotations, :no-annotations
20           Toggle the display of annotations in the summary report. Can be
21           used on the command line to override the configured setting. The
22           ':annotations' hint adds an 'Annotation' column to the summary
23           table. The annotation column is limited to 15 characters. Longer
24           values in this column are truncated to 12 characters and shown with
25           an ellipsis attached.
26
27       :holidays, :no-holidays
28           Toggle the display of holidays in the summary report. Can be used
29           on the command line to override the configured setting.
30
31       :ids, :no-ids
32           Toggle the display of ids in the summary report. Can be used on the
33           command line to override the configured setting. The ':ids' hint
34           adds an 'ID' column to the summary table. Those ids can be used for
35           interval modification.
36
37       :tags, :no-tags
38           Toggle the display of tags in the summary report. Can be used on
39           the command line to override the configured setting. The ':tags'
40           hint adds a 'Tags' column to the summary table.
41

CONFIGURATION

43       reports.summary.annotations
44           Determines whether the annotation column is shown in the summary.
45           Can be overridden by the ':annotations' or ':no-annotations' hint,
46           respectively. Default value is 'no'
47
48       reports.summary.holidays
49           Determines whether relevant holidays are shown beneath the report.
50           Can be overridden by the ':holidays' or ':no-holidays' hint,
51           respectively. Default value is 'yes'.
52
53       reports.summary.ids
54           Determines whether the id column is shown in the summary. Can be
55           overridden by the ':ids' or ':no-ids' hint, respectively. Default
56           value is 'no'.
57
58       reports.summary.tags
59           Determines whether the tags column is shown in the summary. Can be
60           overridden by the ':tags' or ':no-tags' hint, respectively. Default
61           value is 'yes'.
62
63       reports.summary.range
64           Set the date range for the summary report. The value has to
65           correspond to a range hint, see timew-hints(7). Default value is
66           'day'
67
68       reports.summary.weekdays
69           Determines whether the weekday column is shown in the summary.
70           Default value is 'yes'
71
72       reports.summary.weeks
73           Determines whether the week column is shown in the summary. Default
74           value is 'yes'
75
76       tags.<tag>.color
77           Assigns a specific foreground and background color to a tag.
78           Examples of valid colors include 'white', 'gray8', 'black on
79           yellow', and 'rgb345'.
80

SEE ALSO

82       timew-day(1), timew-hints(7), timew-lengthen(1), timew-modify(1),
83       timew-month(1), timew-shorten(1), timew-tag(1), timew-untag(1),
84       timew-week(1)
85
86
87
88timew 1.6.0                       2023-09-18                  TIMEW-SUMMARY(1)
Impressum