TIMEW-DOM(7) User Manuals TIMEW-DOM(7)
timew-dom - Timewarrior DOM
All DOM references start with dom, there are 4 subreferences that can
be accessed:
+o dom.tracked, all intervals
+o dom.active, active time tracking
+o dom.tags, all tags
+o dom.rc, configuration settings
All intervals
dom.tracked is a reference to all intervals of the database
query result. When using this reference, filtering by range
and tags can be applied.
dom.tracked.count Count of all intervals in the query result
dom.tracked.ids Ids of all intervals in the query result
dom.tracked.tags Tags of all intervals in the query result
dom.tracked.tags.count Count of all tags in the query result
dom.tracked.tags.<n> N-th Tag of all tags in the query result
dom.tracked.<n> is a reference to the n-th interval of the
database query result. Depending on the filtering applied,
the n-th interval is not necessarily the one with ID @n!
dom.tracked.<n>.tags All tags of the n-th interval
dom.tracked.<n>.tags.count Count of tags of the n-th interval
dom.tracked.<n>.tags.<m> N-th interval, m-th tag
dom.tracked.<n>.start N-th interval, start time (ISO Extended date)
dom.tracked.<n>.end N-th interval, end time (ISO Extended date, blank if open)
dom.tracked.<n>.duration N-th interval, duration (ISO Duration)
dom.tracked.<n>.json N-th interval, as JSON
Active time tracking
dom.active is a reference to the latest interval in active
time tracking. It is invalid when no time is tracked.
dom.active '1' if there is active tracking, otherwise '0'
dom.active.tags All tags of the active tracking
dom.active.tags.count Count of tags
dom.active.tags.<n> N-th tag
dom.active.start Start timestamp (ISO Extended date)
dom.active.duration Elapsed (ISO Period)
dom.active.json Interval as JSON
All tags
dom.tags is a reference to all tags in the database.
dom.tags All tags
dom.tags.count Count of all tags
dom.tags.1 N-th tag
Without filtering applied, dom.tracked.tags refers to the
same set of tags as dom.tags.
Configuration settings
dom.rc is a reference to all Timewarrior configuration
settings. As there are no restrictions for the configuration
keys, all those references are valid by design.
dom.rc.<name> Configuration setting <name>
timew 1.9.1 2025-08-16 TIMEW-DOM(7)
NAME
timew-dom - Timewarrior DOM
SYNOPSIS
DESCRIPTION
All DOM references start with dom, there are 4 subreferences that can
be accessed:
+o dom.tracked, all intervals
+o dom.active, active time tracking
+o dom.tags, all tags
+o dom.rc, configuration settings
All intervals
dom.tracked is a reference to all intervals of the database
query result. When using this reference, filtering by range
and tags can be applied.
dom.tracked.count Count of all intervals in the query result
dom.tracked.ids Ids of all intervals in the query result
dom.tracked.tags Tags of all intervals in the query result
dom.tracked.tags.count Count of all tags in the query result
dom.tracked.tags.<n> N-th Tag of all tags in the query result
dom.tracked.<n> is a reference to the n-th interval of the
database query result. Depending on the filtering applied,
the n-th interval is not necessarily the one with ID @n!
dom.tracked.<n>.tags All tags of the n-th interval
dom.tracked.<n>.tags.count Count of tags of the n-th interval
dom.tracked.<n>.tags.<m> N-th interval, m-th tag
dom.tracked.<n>.start N-th interval, start time (ISO Extended date)
dom.tracked.<n>.end N-th interval, end time (ISO Extended date, blank if open)
dom.tracked.<n>.duration N-th interval, duration (ISO Duration)
dom.tracked.<n>.json N-th interval, as JSON
Active time tracking
dom.active is a reference to the latest interval in active
time tracking. It is invalid when no time is tracked.
dom.active '1' if there is active tracking, otherwise '0'
dom.active.tags All tags of the active tracking
dom.active.tags.count Count of tags
dom.active.tags.<n> N-th tag
dom.active.start Start timestamp (ISO Extended date)
dom.active.duration Elapsed (ISO Period)
dom.active.json Interval as JSON
All tags
dom.tags is a reference to all tags in the database.
dom.tags All tags
dom.tags.count Count of all tags
dom.tags.1 N-th tag
Without filtering applied, dom.tracked.tags refers to the
same set of tags as dom.tags.
Configuration settings
dom.rc is a reference to all Timewarrior configuration
settings. As there are no restrictions for the configuration
keys, all those references are valid by design.
dom.rc.<name> Configuration setting <name>
timew 1.9.1 2025-08-16 TIMEW-DOM(7)