TIMEW-DOM(7)

✨ NAME ✨

timew-dom β€” Timewarrior DOM πŸ’…

okay so bestie, welcome to TIMEW-DOM(7) β€” the manual page for timew-dom, aka Timewarrior DOM. this is the whole vibe: DOM refs for Timewarrior, and yes they all start with dom.

🌸 SYNOPSIS 🌸

(no synopsis line in the original, bestie β€” it's giving mysterious πŸ’…)

πŸ¦‹ DESCRIPTION πŸ¦‹

All DOM references start with dom, and there are 4 subreferences you can access:

  • dom.tracked β€” all intervals πŸ’–
  • dom.active β€” active time tracking ⏱️
  • dom.tags β€” all tags 🏷️
  • dom.rc β€” configuration settings βš™οΈ

πŸ‘‘ All intervals πŸ‘‘

dom.tracked is a reference to all intervals of the database query result. When you use this reference, you can apply filtering by range and tags. slay.

  • 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> β€” the 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.

⚠️ lowkey important: 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> β€” the 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 β€” the n-th tag

Without filtering applied, dom.tracked.tags refers to the same set of tags as dom.tags. no cap.

🌈 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. iykyk.

  • dom.rc.<name> β€” configuration setting <name>

okay that's the whole page, bestie β€” it's from timew 1.9.1, dated 2025-11-02, and the manual is TIMEW-DOM(7). slay, go track your time πŸ’…βœ¨

πŸ“¦ where this page comes from