TIMEW-CHART(1)

💖 TIMEW-CHART(1) 💖

okay bestie, welcome to the timew-chart manual page, from the User Manuals collection 🎀 this is literally the chart report, and it's about to eat 💅

---

✨ NAME ✨

timew-chart — display chart report 🦋

---

🌸 SYNOPSIS 🌸

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

---

👑 DESCRIPTION 👑

A chart is basically a timeline with colored blocks drawn on it, summarizing the tracked and untracked time. So you can see your time, not just read about it. It accepts date ranges and tags for filtering, no cap.

There are three types: day, week, and month, and each one has its own command. The reports.<type>.range configuration setting overrides the default date range. And listen — if you want more details, and precise times, go use the summary report instead, okay? 🫶

• month — the month command shows a chart depicting a single month (current month by default, obviously 💅). 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, bestie 🌸). The default date range shown is :day.

---

🎀 CONFIGURATION 🎀

so <type> is one of month, week, day — keep that in mind, it goes in every single one of these settings 💖

• 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 the 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 where 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 the 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 should be a range hint — 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 (time line at the top) inside the exclusion blocks, and external puts the hour markers in a separate line; additional values might be defined in the future (mysterious 👀). 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 the left margin. Default value is yes.
• reports.<type>.weekday — determines whether the current weekday is shown at the left margin. Default value is yes.

---

🦋 HINTS 🦋

• :blank — the :blank hint causes only the excluded time to be shown, with no tracked time. This can be used to see the exclusions 👀
• :ids — the :ids hint causes the intervals to be displayed with their ids ✨

---

🌈 EXAMPLES 🌈

Charts accept date ranges and tags for filtering, or shortcut hints — pick your fighter 💅

$ timew month 1st - today
$ timew week FOO BAR
$ timew day :week

---

💜 SEE ALSO 💜

timew-day(1), timew-month(1), timew-summary(1), timew-week(1)

---

and that's the whole page, bestie 🫶 this was timew version 1.4.3, dated 2021-10-27 — go make some iconic charts, you absolute main character 👑✨