Chapter 08

Settings reference

Preferences use dotted keys. SoftAP and USB share the same names. Change a value, then save 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.layer.underlay`	Background / FX layer as % of overall	0–100	12
`display.layer.base`	Clock / countdown chrome as % of overall	0–100	80
`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`	Freeze shared-cycle advancement (manual advance still works)	true / false	false
`scene.timing.clock_leads`	Idle clock phase before countdown in each shared cycle	true / false	true
`scene.timing.shared_cycle_ms`	Length of one clock↔countdown share cycle	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`	Crossfade between scenes (USB)	0–5 000 ms	400
`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