Day & Night

World map with the live day/night terminator, twinkling city lights, you, the sun and the moon.

At a glance

OutputBaked loopRendered once into a GIF that the panel loops with its own firmware: perfectly smooth, no Bluetooth traffic.

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

Sourcedaynight.pysrc/deskdot/apps/daynight.py

Settings
Setting	Type	Default	Options / range
Map
Layout`layout`	choice	World + times	World + timesHalf worldGlobe
Centre on my location`center_on_home`	on/off	On	on / off
Centre longitude`center_lon`Used when not centred on your location.	whole number	0	-180 – 180
Markers
City lights`show_cities`	on/off	On	on / off
My location`show_home`	on/off	On	on / off
Sun marker`show_sun`	on/off	On	on / off
Moon marker`show_moon`	on/off	On	on / off
24-hour times`hour24`	on/off	On	on / off
Colours
Land (day)`day_land`	colour	#1e9a3c	any colour (#rrggbb)
Sea (day)`day_sea`	colour	#002a78	any colour (#rrggbb)
Land (night)`night_land`	colour	#1c2a4a	any colour (#rrggbb)
City lights`lights`	colour	#ffbe50	any colour (#rrggbb)

render a frame to PNG (no panel needed)

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

show it on your panel (engine running)

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

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

A city where it's 17:xx right now (from local time-zone data), toasted with clinking glasses.

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

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.