Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TIMEW-SUMMARY(1)		  User Manuals			TIMEW-SUMMARY(1)

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, respec-
	 tively. 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  over-
	 ridden  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'.

SEE ALSO
     timew-day(1),     timew-hints(7),	  timew-lengthen(1),	timew-modify(1),
     timew-month(1),	 timew-shorten(1),     timew-tag(1),	 timew-untag(1),
     timew-week(1)

timew 1.9.1			   2025-08-27			TIMEW-SUMMARY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=timew-summary&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help