d332d447aa145f173c41e3166d4dfc5d6e60d472
The controller sent a GROUPS packet on every driver hello. For a driver in no zone that was an empty list, which replaced the groups stored on the driver. It is now sent at announce and resync only when the list is not empty; explicit zone and device edits still send every list. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
led-controller
LED controller web app for managing profiles, zones, presets, and colour palettes, and sending commands to LED devices. Outbound paths include:
- Serial → ESP-NOW bridge: JSON lines over UART to an ESP32 that forwards ESP-NOW frames (configure
serial_portand baud insettings.json/ Settings model). - Wi-Fi LED drivers: TCP JSON lines (default port 8765 on the Pi; drivers discover the controller via UDP 8766 broadcast).
Run
- One-time setup for port 80 without root:
sudo scripts/setup-port80.sh - Start app:
pipenv run run(override listen port with thePORTenvironment variable) - Dev watcher (auto-restart on
src/changes):pipenv run dev - Regenerate
docs/help.pdffromdocs/help.md:pipenv run help-pdf(requires pandoc and chromium on the host)
UI modes
- Run mode: focused control view. Select zones/presets and apply profiles. Editing actions are hidden.
- Edit mode: management view. Shows Zones, Presets, Patterns, Colour Palette, and Send Presets controls, plus per-tile preset edit/remove and drag-reorder.
Profiles
- Applying a profile updates session scope and refreshes the active zone content.
- In Run mode, Profiles supports apply-only behaviour (no create/clone/delete).
- In Edit mode, Profiles supports create/clone/delete.
- Creating a profile always creates a populated
defaultzone (starter presets). - Optional DJ zone seeding creates:
djzone bound to device namedj- starter DJ presets (rainbow, single colour, transition)
Preset colours and palette linking
- In preset editor, selecting a colour picker value auto-adds it when the picker closes.
- Use From Palette to add a palette-linked preset colour.
- Linked colours are stored as palette references and shown with a
Pbadge. - When profile palette colours change, linked preset colours update across that profile.
Brightness and search
- The header Brightness slider sets the server-wide
global_brightness(saved viaPUT /settings, broadcast to connected drivers, and re-sent when a Wi-Fi driver reconnects). - The Devices, Zones and Presets modals have a client-side search filter.
API docs
- Main API reference:
docs/API.md - User guide:
docs/help.md - Full specification:
docs/SPECIFICATION.md
Driver pattern modules
Pattern .py sources live under led-driver/src/patterns. The Pi app resolves that path via util.driver_patterns.driver_patterns_dir(). If you deploy without that tree next to the app, set LED_CONTROLLER_PATTERNS_DIR to the directory that contains those files.
Animation engine (Pi-side)
src/engine/ lets the Pi drive LEDs itself, in addition to the ESP32 drivers:
- Pixel generator: runs the unchanged
led-driver/src/patterns/*.pyunder CPython (autimeshim plus a NeoPixel-like buffer) with the same preset JSON the drivers get, and streams each frame to pixel outputs: DDP, Art-Net, sACN (E1.31), or USB-DMX (Enttec Pro / Open DMX). Configure outputs in Outputs (edit mode) and add an output's name to a zone's devices. - Preset sequencer: Sequences play timed chains of presets on a zone, switching both the pixel outputs and the zone's ESP32 drivers. Sequences resume after a restart.
- ESP32 firmware is unchanged; drivers still get presets +
select.
CLI (run from src/):
python -m engine.cli --output "ddp://192.168.1.60?pixels=300" --test
python -m engine.cli --output "artnet://192.168.1.61?universe=0&pixels=170" --preset 16
python -m engine.cli --pattern rainbow --n1 2 --leds 60 # terminal preview
Tests: pipenv run pytest tests/engine_tests.
Languages
Python
59.2%
JavaScript
29.6%
HTML
6.5%
CSS
3.6%
Shell
0.9%
Other
0.2%