2024.11.0
Home ▸ Integrations ▸

Elgato Light

The Elgato Lights sets the bar for high-end studio lightning. The LED lights are created and designed specifically for streamers and content creators, many of whom operate on platforms like YouTube and Twitch.

The following light productions from Elgato have been tested with this integration:

Configuration

To add the Elgato Light device to your Home Assistant instance, use this My button:

Elgato Light can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Elgato Light.

  • Follow the instructions on screen to complete the setup.

Lights

This integration adds the Key Light device as a light in Home Assistant, and allows you to control the color temperature, brightness, and its on/off state.

When using the Elgato Light Strip, color support is automatically detected and enabled in Home Assistant.

Other entities

Besides the above mentioned light entity, this integration also provides other secondary entities that can be useful for monitoring and controlling your Elgato light.

Sensors

If you have a Key Light Mini, Home Assistant will provide an additional sensor that indicates the level of your battery in percent (%).

Switches

If you have a Key Light Mini, Home Assistant will provide an additional switch that allows the control of the “Studio mode” of your light. When studio mode is enabled, your battery will not be used and bypassed.

Actions

Action elgato.identify

The identify action shortly blinks the Elgato light. Originally meant as a way to identify which light you are talking to; it can also be used as an action to create a visual notification.

This action also works when the light is turned off and will turn off the light after the identification sequence has been completed.

Data attribute Optional Description
entity_id Yes String or list of Elgato light entity IDs.

Example automation, in YAML format, that triggers a visual notification when a binary sensor (a doorbell) is triggered:

- alias: "Visual doorbell notification example"
  triggers:
    - trigger: state
      entity_id: binary_sensor.doorbell
      to: "on"
  actions:
    - action: elgato.identify
      target:
        entity_id: light.elgato_key_light