alexei.dolgolyov
5c8b3c259a
The server dropped the ?token=<key> query-param WS auth in favor of a
first-message {"type":"auth","token":...} handshake that must complete
within 3 s, so the old query-param connection silently timed out on the
server side and we reconnected every ~8 s in a tight loop.
Send the handshake right after ws_connect, wait up to 5 s for auth_ok,
and treat auth rejection as a connection error so the reconnect backoff
kicks in instead of hot-looping. Bumps manifest to 0.2.1.
LedGrab Home Assistant Integration
Custom Home Assistant integration for LedGrab — ambient lighting system that captures screen content and drives LED strips in real time.
Creates light, switch, sensor, number, and select entities for each configured device, allowing full control and automation from Home Assistant.
Installation
Option 1: HACS (recommended)
- Install HACS if you have not already.
- Open HACS in Home Assistant.
- Click the three-dot menu, then Custom repositories.
- Add URL:
https://git.dolgolyov-family.by/alexei.dolgolyov/ledgrab-haos-integration - Set category to Integration and click Add.
- Search for "LedGrab" in HACS and click Download.
- Restart Home Assistant.
- Go to Settings > Devices & Services > Add Integration and search for "LedGrab".
- Enter your server URL (e.g.,
http://192.168.1.100:8080) and API key.
Option 2: Manual
Copy the custom_components/ledgrab/ folder from this repository into your Home Assistant config/custom_components/ directory, then restart Home Assistant and add the integration as above.
Automation Example
automation:
- alias: "Start ambient lighting when TV turns on"
trigger:
- platform: state
entity_id: media_player.living_room_tv
to: "on"
action:
- service: switch.turn_on
target:
entity_id: switch.living_room_tv_processing
- alias: "Stop ambient lighting when TV turns off"
trigger:
- platform: state
entity_id: media_player.living_room_tv
to: "off"
action:
- service: switch.turn_off
target:
entity_id: switch.living_room_tv_processing
Requirements
- Home Assistant 2023.1.0 or later
- A running LedGrab server accessible on your network
Troubleshooting
- Verify the component exists: check that
config/custom_components/ledgrab/is present. - Clear the browser cache and hard-refresh the HA UI.
- Restart Home Assistant.
- Check logs at Settings > System > Logs and search for
ledgrab.
License
MIT