Setup¶

Software configuration, once the hardware is wired.

Raspberry Pi setup

OS, dependencies, the setup script, and what it configures.
Rolling buffer setup

The one-time flash-persist step. Hardware triggers do not work without it.
Auto-start & kiosk mode

Run as a systemd service on boot; fullscreen, manual, and SSH variants.
Hardware diagnostic

Seven checks over the whole signal path. Run this first when something breaks.

Order¶

Run the diagnostic before anything else

uv run python scripts/hardware-test/diagnose.py

It tells you which link in the chain is broken instead of leaving you to infer it from a UI that shows nothing.