Add Celebright holiday-lights integration

Home Assistant custom integration for Celebright (CLC-03) holiday-lights
controllers, plus a standalone reference client. Local-only, reverse-engineered
from the device's WebSocket protocol — talks directly to the controller on the
LAN with no vendor cloud.

- select entity exposes the device's saved scenes plus an off option
- firmware-v2 protocol (savedScenes); getSystemState drives availability and
  the active scene, scene library fetched best-effort and cached
- WS connect/recv/send wrapped in asyncio timeouts so a silent device can't
  blow past HA's setup deadline
- config flow prompts for the controller IP; no credentials involved
- docs/PROTOCOL.md: full v2 WebSocket protocol and device behaviors

Migrated from the private dfritz/celebright with history dropped and internal
site references removed. MIT-licensed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01F6B8b3iYNv6QUftK2FDfYb

This commit is contained in:

Hank Mueller

2026-09-01 15:37:23 +00:00

co-authored by

Claude Opus 5

commit cb99d9f941

16 changed files with 1678 additions and 0 deletions

									
										hacs.json
									
		+6
		
												View File
												
				@@ -0,0 +1,6 @@

				{

				  "name": "Celebright",

				  "content_in_root": false,

				  "render_readme": true,

				  "homeassistant": "2024.6.0"

				}