Chapter 08
Settings reference
Preferences use dotted keys grouped by namespace prefix (display.*, wifi.*, net.time.*,scene.timing.*, a11y.*, and others below). The same names work on SoftAP and USB. Change a value, thensave so it survives reboot. SoftAP Display / Network screens save after you confirm; USB uses an explicit save step.
Display
| Key | Meaning | Range | Default |
|---|---|---|---|
display.base_mode | Primary scene preference | idle_clock · launch_countdown | launch_countdown |
display.brightness | Overall intensity ceiling (what 100% means for layers) | 0–255 | 255 |
display.orientation | Viewport rotation before the HUB75 panel is driven — match how the sign is mounted on the wall. Applies to the composed 64×64 frame (clock, countdown, notifications). SeeMount orientation. | 0 upright · 90_cw · 90_ccw ·180 inverted | 180 |
display.rotate_180 | Legacy alias — writes display.orientation0 (false) or 180 (true). Preferdisplay.orientation for sideways mounts. | true / false | true |
display.layer.underlay | Background / FX layer as % of overall | 0–100 | 12 |
display.layer.base | Clock / countdown chrome as % of overall | 0–100 | 100 |
display.layer.notify | Notification overlay as % of overall | 0–100 | 100 |
display.night_dim_enabled | Lower brightness between local hours | true / false | false |
display.night_dim_start_hour | Local hour night dim begins | 0–23 | 22 |
display.night_dim_end_hour | Local hour night dim ends | 0–23 | 6 |
display.night_dim_brightness | Brightness ceiling while night dim is active | 0–255 | 64 |
display.eco_sleep_enabled | Blank the panel after inactivity and/or a nightly window | true / false | false |
display.eco_sleep_inactivity_min | Minutes idle before eco sleep (0 = inactivity path off) | 0–240 | 30 |
display.eco_sleep_night_enabled | Optional nightly blank window (local hours) | true / false | false |
display.eco_sleep_night_start_hour | Local hour eco sleep night begins | 0–23 | 22 |
display.eco_sleep_night_end_hour | Local hour eco sleep night ends | 0–23 | 6 |
Network and time
| Key | Meaning | Range | Default |
|---|---|---|---|
wifi.ssid | Home / lab network name | text | (empty) |
wifi.password | Network password (secret; redacted on normal get/export) | text | (empty) |
wifi.configured | Whether station credentials are present | read-only | false |
device.name | Friendly name; also shapes SoftAP suffix when set | text | (empty → MAC suffix) |
net.time.tz_offset_min | Fixed offset east of UTC (minutes) | integer minutes | −240 |
net.time.tz_label | Timezone label (e.g. ET / region name for DST) | text | ET |
Accessibility and SoftAP appearance
| Key | Meaning | Range | Default |
|---|---|---|---|
a11y.preset | Panel readability preset | standard · high_contrast · colorblind_safe | standard |
a11y.reduce_motion | Freeze decorative underlay motion | true / false | false |
appearance.theme | SoftAP portal chrome theme | system · light · dark | system |
Scene timing (playlist)
These keys drive how the sign shares time between idle clock and countdown when countdown is the base preference. SoftAP exposes the common knobs; advanced siblings are USB / export. Full behavior:Playlist and scene timing.
| Key | Meaning | Range | Default |
|---|---|---|---|
scene.timing.include_idle_clock | Allow idle clock in the rotation (off = sticky countdown) | true / false | true |
scene.timing.rotation_paused | Hold the local presentation while the shared epoch timeline continues | true / false | false |
scene.timing.clock_leads | Idle clock phase before countdown in each shared cycle | true / false | true |
scene.timing.shared_cycle_ms | Deprecated alias: read Clock+Launch dwell; writes rescale both proportionally | 5 000–600 000 ms | 60 000 |
scene.timing.list_hold_ms | How long a launch list view holds before flipping | 1 000–120 000 ms | 10 000 |
scene.timing.page_interval_seconds | Detail / page flip interval | 1–60 s | 5 |
scene.timing.shared_attention_hours | Hours-to-NET window that prefers sharing with the clock (USB) | 1–336 | 168 |
scene.timing.force_detail_hours | Hours-to-NET that force countdown detail (USB) | 0–48 | 2 |
scene.timing.splash_window_hours | Hours-to-NET splash emphasis window (USB) | 1–168 | 24 |
scene.timing.launch_info_include_list | Include list card in launch info rotation (USB) | true / false | true |
scene.timing.crossfade_ms | Duration for scene A→B transitions (USB). Catalog: Scene transitions | 0–5 000 ms | 1 000 |
scene.timing.launch_surface_mode | Launch surface selection: every-other-visit list↔detail, legacy intra-dwell split, or sticky (USB) | visit \| intra \| detail \| list | visit |
Not settings
Launch cards, wall-clock set, notifications, and OTA check areactions — they are not preference keys. Health / status are read-only. See USB andUpdating.
Related: Display ·First boot ·Troubleshooting