32×32 · Livereal render
TimeLive
Progress
Day, week, month, year, life and custom-event progress as bars, a big ring or a dots grid.
At a glance
OutputLiveRendered by the engine and streamed over Bluetooth as its data changes (about 5–9 frames a second).
Settings21every one editable live in the studio, or by an agent with
update_app_settingsSourceprogress.pysrc/deskdot/apps/progress.py
Settings
| Setting | Type | Default | Options / range |
|---|---|---|---|
| Layout | |||
Layoutlayout | choice | Stacked bars | Stacked barsBig ringDots grid |
Ring / dots showfocus | choice | Year | DayWeekMonthYearLifeEvent 1Event 2 |
Decimalsdecimals | whole number | 1 | 0 – 2 |
Seconds per pagepage_seconds | whole number | 6 | 2 – 60 |
| Bars | |||
Dayshow_day | on/off | On | on / off |
Weekshow_week | on/off | On | on / off |
Monthshow_month | on/off | On | on / off |
Yearshow_year | on/off | On | on / off |
Lifeshow_life | on/off | Off | on / off |
Custom eventsshow_events | on/off | On | on / off |
Week startsweek_start | choice | Monday | MondaySunday |
| Life | |||
Birth datebirth_date | text | 1990-01-01 | free text |
Life expectancy (years)life_years | whole number | 80 | 30 – 120 |
| Events | |||
Event 1 onevent1_on | on/off | Off | on / off |
Event 1 labelevent1_label | text | PROJECT | up to 12 characters |
Event 1 startevent1_start | text | 2026-07-01T00:00:00 | free text |
Event 1 endevent1_end | text | 2026-12-31T18:00:00 | free text |
Event 2 onevent2_on | on/off | Off | on / off |
Event 2 labelevent2_label | text | TRIP | up to 12 characters |
Event 2 startevent2_start | text | 2026-09-01T00:00:00 | free text |
Event 2 endevent2_end | text | 2026-10-15T00:00:00 | free text |
Try it
render a frame to PNG (no panel needed)
$ uv run deskdot preview progress --settings '{"layout":"ring"}' --out progress.pngshow it on your panel (engine running)
$ curl -X POST http://127.0.0.1:8765/api/apps/progress/activateOr ask your agent: “Show Progress on my panel”. It calls show_app with "progress". New here? Set up DeskDot first.
More time apps
Time
Sun & Moon
Sunrise, sunset and the sun's path today, golden and blue hour, and the moon's phase.
5 settings
Time
Clock
Hero, stacked, minimal and analog faces with a seconds ring.
6 settings
Time
Countdown
Counts down to any moment — days, then hours, then a live seconds clock.
4 settings
Time
Day & Night
World map with the live day/night terminator, twinkling city lights, you, the sun and the moon.
12 settings