TIMEW-CHART(1)

📦
version 1.9.1 · 9 versions
, in ubuntu resolute, ubuntu stonking

✨ TIMEW-CHART 💅 (that's section 1, bestie)

okay so picture this: you've been tracking your time like a good little productivity icon, and now you want the glow-up visual — that's timew-chart(1), the chart report. it draws your life as colored blocks on a timeline and honestly? it's giving main character energy. 🌈

🎀 NAME 🎀

timew-chart — display chart report. that's it, that's the vibe. ✨

🦋 SYNOPSIS 🦋

timew day [<range>] [<tag>...]
timew month [<range>] [<tag>...]
timew week [<range>] [<tag>...]

🌸 DESCRIPTION 🌸

A chart summarizes the tracked and untracked time with colored blocks drawn on a timeline. lowkey gorgeous. It accepts date ranges and tags for filtering, because obviously you need to filter.

There are three types — day, week, and month — each with their respective commands. The reports.<type>.range configuration setting overrides the default date range. and if you wanna go even bigger, one can override the global default date range with the reports.range configuration. For more details, and precise times, use the summary report (that's the spreadsheet-girlie of reports, this one is the aesthetic one). 💅

month 🌙

The month command shows a chart depicting a single month (current month by default). The default date range shown is :month.

week 🗓️

The week command shows a chart depicting a single week (current week by default). The default date range shown is :week.

day ☀️

The day command shows a chart depicting a single day (today by default). The default date range shown is :day.

🧚 HINTS 🧚

Apart from range hints (see timew-hints(7)), the chart reports adhere to the following hints:

  • :blank — The :blank hint causes only the excluded time to be shown, with no tracked time. This can be used to display the exclusions. literally just the gaps, no cap. 🫥
  • :ids — The :ids hint causes the intervals to be displayed with their IDs. yes bestie, you get the receipts. 🔢

👑 CONFIGURATION 👑

<type> is one of month, week, day. (iykyk)

  • reports.<type>.cell — Determines how many minutes are represented by a single character cell, for the charts. The value must be greater than 0. A value of 15 means that an hour is represented by 60/15, or 4 character cells. Suitable values are the divisors of 60 (30, 20, 15, 12, ...). Default value is 15. 🍓
  • reports.<type>.day — Determines whether the current day of the month is shown at left margin. Default value is yes.
  • reports.<type>.holidays — Determines whether relevant holidays are shown beneath the report. Default value is yes. 🎉
  • reports.<type>.hours — Determines how the <type> report shows all the hours in a day (all), or is limited to only hours when data is tracked (auto). Default value is all.
  • reports.<type>.lines — Determines how many lines are used to render each day on the <type> report. Default value is 1.
  • reports.<type>.month — Determines whether the current month is shown at left margin. Default value is yes.
  • reports.<type>.range — For reports that show a range of data, this setting will override the default value. The value has to be a range hint (without the prefix colon), see timew-hints(7).
  • reports.<type>.spacing — Specifies how many spaces are inserted between the hours in the <type> report exclusions. A value of 0 yields a more compact report. Default value is 1.
  • reports.<type>.axis — The value internal puts the hour markers (timeline at the top) inside the exclusion blocks, external puts the hour markers in a separate line; additional values might be defined in the future. Default is internal for the day report and external for other reports.
  • reports.<type>.summary — Determines whether the hours summary is shown. Default value is on.
  • reports.<type>.totals — Determines whether the time totals are shown for each day on the report. Default value is on.
  • reports.<type>.week — Determines whether the current week number is shown at left margin. Default value is yes.
  • reports.<type>.weekday — Determines whether the current weekday is shown at left margin. Default value is yes.
  • tags.<tag>.color — Assigns a specific foreground and background color to a tag, instead of the default color palette determined by your current theme. Examples of valid colors include white, gray8, black on yellow, and rgb345. ✨🎨

💖 EXAMPLES 💖

Charts accept date ranges and/or tags, or ids for filtering:

$ timew month 1st - today
$ timew week FOO BAR
$ timew day @3 @4

See timew-ranges(7) and timew-hints(7) on the different ways to provide date ranges. 🫶

🔥 SEE ALSO 🔥

timew-summary(1)

ok that's the whole page, no notes. go forth and make your timeline pretty. 💜

sign-off time, bestie: this is from timew 1.9.1, dated 2025-11-02 — TIMEW-CHART(1), periodt. 🎀✨

📦 where this page comes from