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)

1. Install HACS if you have not already.
2. Open HACS in Home Assistant.
3. Click the three-dot menu, then Custom repositories.
4. Add URL: https://git.dolgolyov-family.by/alexei.dolgolyov/ledgrab-haos-integration
5. Set category to Integration and click Add.
6. Search for "LedGrab" in HACS and click Download.
7. Restart Home Assistant.
8. Go to Settings > Devices & Services > Add Integration and search for "LedGrab".
9. 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

1. Verify the component exists: check that config/custom_components/ledgrab/ is present.
2. Clear the browser cache and hard-refresh the HA UI.
3. Restart Home Assistant.
4. Check logs at Settings > System > Logs and search for ledgrab.

License

MIT