Chapter 06

Playlist and scene timing

“Playlist” here means the sign’s automatic rotation between scenes — not a media queue you fill with arbitrary effects. Today the product ships ashared cycle between idle clock and launch countdown when countdown is the base preference and cards are far from NET.

What ships today

Base preference — choose idle clock or launch countdown (display.base_mode). That is the scene that owns the display when nothing else is active.
Shared cycle — with countdown as base andscene.timing.include_idle_clock on, the sign can dwell on the idle clock for part of each cycle, then return to countdown. Cycle length is scene.timing.shared_cycle_ms (default 60 s).
Pin one — SoftAP Playlist mode Pin idle clock orPin countdown (sticky countdown clears idle clock from rotation).
Pause / resume / manual advance —scene.timing.rotation_paused freezes the shared cycle. SoftAP Advance now (or USB display advance) jumps to the next slot — use with pause for button-only advance.
Reorder — ↑/↓ on SoftAP slots setsscene.timing.clock_leads (which scene phase comes first).
Near-NET behavior — when a launch is close, the product favors countdown detail over clock dwell (attention / force-detail windows on USB).
Empty list — with no launch cards, countdown mode stays on the launch scene so system messages (for example no data) remain visible; it does not silently flip to the clock.
Notifications — an active notify overlay pauses rotation until cleared or expired; then the previous base resumes.

Operator knobs (SoftAP)

On the SoftAP Display screen under Playlist:

Playlist mode — rotate, pin clock, pin countdown, or manual advance only.
Slot list — reorder (↑/↓), pin, or remove idle clock (confirm).
Pause / Resume / Advance now — freeze the cycle or jump slots.
Shared cycle (ms) — full clock↔countdown period.
List hold (ms) — how long a list view holds.
Page / detail flip (seconds) — detail page cadence.

Defaults and full ranges: Settings reference.

USB

settings get|set scene.timing.rotation_paused /scene.timing.clock_leads /scene.timing.include_idle_clock /scene.timing.shared_cycle_ms then settings save
display mode idle|countdown — pin preference alias
display advance — jump to the next playlist slot

What does not ship yet

Arbitrary scene stacks (weather, stocks, custom art as first-class slots).
Per-hour calendar scheduling of unrelated modes.
A separate “playlist” product name in the SoftAP bottom nav — controls live under Display.