
Holidays
Countdown to the next public holiday, a list, a month calendar and a celebration on the day.
At a glance
update_app_settingsSettings
| Setting | Type | Default | Options / range |
|---|---|---|---|
| Data | |||
Country codecountryISO code such as IN, US, DE. Blank = the country of your location | text | empty | up to 2 characters |
Include observancesobservancesAlso show observances and regional-only days | on/off | Off | on / off |
| Layout | |||
Layoutlayout | choice | Countdown | CountdownListMonth calendar |
Holidays in the listcount | whole number | 4 | 1 – 8 |
Celebrate on the daycelebrate | on/off | On | on / off |
| Colours | |||
Festive iconicon | choice | Auto (by holiday) | Auto (by holiday)FireworksConfettiLampStarNone |
Accentaccent | colour | #ffaa00 | any colour (#rrggbb) |
Name colourtext_color | colour | #ffffff | any colour (#rrggbb) |
Follow page themefollow_themeUse the page theme's colours (Settings → Display & colour) for the colours you haven't changed. Off = this app's own colours. | on/off | On | on / off |
Try it
$ uv run deskdot preview holidays --settings '{"layout":"list"}' --out holidays.png$ curl -X POST http://127.0.0.1:8765/api/apps/holidays/activateOr ask your agent: “Show Holidays on my panel”. It calls show_app with "holidays". New here? Set up DeskDot first.
More time apps

Long Weekend
Days until the next long weekend from public holidays — and when one day off makes it longer.

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

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

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