# Keebdisplay

Keebdisplay is an experimental native keyboard-light display engine. It drives supported RGB keyboards as sparse, irregular, low-resolution displays using stock firmware protocols.

The public-read snapshot supports Keychron Q6 Ultra 8K ANSI over its Launcher-compatible RGB HID interface. Real HID output is implemented for macOS; other platforms can run tests and dashboard validation.

## Safety model

- Stock firmware only.
- Volatile streaming by default.
- No firmware flashing.
- No persistent writes unless explicitly requested by a device-specific command.
- Local control only by default: the daemon binds to 127.0.0.1 unless configured otherwise.
- Protocol support is based on observed behavior for the listed keyboard model and firmware path; verify before targeting other devices.

## Quick validation

~~~bash
npm ci
make validate
~~~

Equivalent commands:

~~~bash
go test ./...
npm run typecheck
npm run build:web
~~~