How can I further filter this to show commits for a given year? Looks like we can show yearMonth, yearWeek, and a specific day. Do I need to give a range?

It supports several variation of that but apparently not just the year:

   ym=YYYY-MM      Show only events for the given year/month
   yw=YYYY-WW      Show only events for the given week of the given year
   yw=YYYY-MM-DD   Show events for the week that includes the given day
   ymd=YYYY-MM-DD  Show only events on the given day. The use "ymd=now"
                   to see all changes for the current week.

i'll take a look at that. Since we have the ym/etc filtering, it is presumably a simple change to add a year filter. It will have to be called something other than "y", as "y" is for the timeline event type (checkin, ticket, etc.).

Check out "a" and "b" (or even "c") in the help.

Edit: I didn't try it so don't know if they stack (can be used together in combination).

Yes, it works.

Example of "release" tags in 2021: https://fossil-scm.org/home/timeline?t=release&a=20210101&b=20211231

Edit: Ugh... typos.

That does seem to work:

https://fossil-scm.org/home/timeline?t=release&a=2021-01-01&b=2021-12-31

I won't stop Stephan from adding a specific query just for the year, though. ;)

I won't stop Stephan from adding a specific query just for the year, though. ;)

If you were going to try, it's too late ;). Please try out checkin f8681a9c062042d8 and report any problems. It's not, as of this writing, yet deployed on the main repo.

Management summary:

/timeline?year=YYYY

Use year 0 for the current year.

When using multiple time-based filters, which one(s) get(s) applied is unspecified any may change in any given fossil version, so please don't rely on any given multi-time-filter combinations working.