Holidays

Countdown to the next public holiday, a list, a month calendar and a celebration on the day.

At a glance

OutputLiveRendered by the engine and streamed over Bluetooth as its data changes (about 5–9 frames a second).

Settings8every one editable live in the studio, or by an agent with update_app_settings

Sourceholidays.pysrc/deskdot/apps/holidays.py

Settings
Setting	Type	Default	Options / range
Data
Country code`country`ISO code such as IN, US, DE. Blank = the country of your location	text	empty	up to 2 characters
Include observances`observances`Also show observances and regional-only days	on/off	Off	on / off
Layout
Layout`layout`	choice	Countdown	CountdownListMonth calendar
Holidays in the list`count`	whole number	4	1 – 8
Celebrate on the day`celebrate`	on/off	On	on / off
Colours
Festive icon`icon`	choice	Auto (by holiday)	Auto (by holiday)FireworksConfettiLampStarNone
Accent`accent`	colour	#ffaa00	any colour (#rrggbb)
Name colour`text_color`	colour	#ffffff	any colour (#rrggbb)

render a frame to PNG (no panel needed)

$ uv run deskdot preview holidays --settings '{"layout":"list"}' --out holidays.png

show it on your panel (engine running)

$ curl -X POST http://127.0.0.1:8765/api/apps/holidays/activate

Or ask your agent: “Show Holidays on my panel”. It calls show_app with "holidays". New here? Set up DeskDot first.

Day, week, month, year, life and custom-event progress as bars, a big ring or a dots grid.

Sunrise, sunset and the sun's path today, golden and blue hour, and the moon's phase.

Hero, stacked, minimal and analog faces with a seconds ring.

Counts down to any moment — days, then hours, then a live seconds clock.