basic_calendar

Renders a Calendar payload from inline options. year / month / day default to today in the resolved timezone so a fresh config shows the current month with today highlighted; events lists extra days to mark.

Kind	Safety	Shapes
realtime	Safe	calendar

Options

Option	Type	Required	Default	Description
year	i32	no	current year	ISO year. Defaults to today's year in the resolved timezone.
month	u8 (1..=12)	no	current month	Month number. Defaults to today's month.
day	u8 (1..=31)	no	current day	Focused / highlighted day. Defaults to today.
events	list of u8 (1..=31)	no	[]	Additional days to highlight in the month grid (1..=31).
timezone	IANA timezone	no	[general].timezone	Timezone for the today fallback. Omit to use the project-wide setting.

Compatible renderers

Shape	Renderers
calendar	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_calendar

Preview

calendar via grid_calendar

      May 2026              
 Su Mo Tu We Th Fr Sa       
                 1  2       
  3  4  5  6  7  8  9       
 10 11 12 13 14 15 16       
 17 18 19 20 21 22 23       
 24 25 26 27 28 29 30       
 31                         
                            
                            

[[widget]]
id = "basic_calendar"
fetcher = "basic_calendar"
render = "grid_calendar"