The Philips Hue integration allows you to control and monitor the lights and motion sensors connected to your Hue bridge.
There is currently support for the following device types within Home Assistant:
- Motion sensors (including temperature and light level sensors)
- Hue switches (as device triggers for automations and also exposed as battery sensors when they are battery-powered)
- Hue Dimmer Switch
- Hue Tap Switch
- Hue Smart Button
- Friends of Hue Switch
Adding Philips Hue to your Home Assistant instance can be done via the user interface, by taking the following steps:
- Browse to your Home Assistant instance.
- In the sidebar click on Configuration.
- From the configuration menu select: Integrations.
Philips Hue can be auto-discovered by Home Assistant. If an instance was found, it will be shown in the top of the list of integrations as “Discovered”. If that is the case click on the Configure button to start setting up the discovered instance.
If there wasn’t any discovered automatically, don’t worry! You can set up a manual integration entry:
- In the bottom right, click on the Add Integration button.
- From the list, search and select “Philips Hue”.
- Follow the instruction on screen to complete the set up.
After completing, the Philips Hue integration will be immediately available for use.
Options for the Hue integration can be set going to Configuration -> Integrations -> Hue -> Options.
Enabling this option, will create entities for each Hue group, so you can control your Hue light groups from Home Assistant.
The Hue platform has its own concept of scenes for setting the colors of a group of lights simultaneously. A Hue bridge could potentially have dozens of scenes stored on it, and many scenes across different rooms might share the same name (the default scenes, for example). To avoid user interface overload, we don’t expose scenes directly. Instead there is a
hue.hue_activate_scene service which can be used in an automation or script. This will have all the bulbs transitioned at once, instead of one at a time like when using standard scenes in Home Assistant.
service: hue.hue_activate_scene data: group_name: "Porch" scene_name: "Porch Orange"
|Service data attribute||Optional||Description|
||no||The group/room name of the lights. Find this in the official Hue app.|
||no||The name of the scene. Find this in the official Hue app.|
|‘transition’||yes||The time in 100s of milliseconds to transition to the scene. For example, a value of 4 means 400 milliseconds.|
group_name is not a reference to a Home Assistant group name. It can only be the name of a group/room in the Hue app.
The easiest way to find Hue scene names is to only use the scenes from the 2nd generation Hue app, which are organized by room (group) and scene name. Use the room name and scene name that you see in the app. You can test that these work at Developer Tools > Services in your Home Assistant instance.
Alternatively, a more advanced method can be used to dump all rooms and scene names using this gist. This does not tell you which groups and scenes work together, but it is sufficient to get values that you can test at Developer Tools > Services.
The Hue API doesn’t activate scenes directly; rather, they must be associated with a Hue group (typically rooms). But Hue scenes don’t actually reference their group, so heuristic matching is used.
Neither group names nor scene names are guaranteed unique in Hue. If you are observing unexpected behavior from calling Hue scenes in Home Assistant, make the names of your Hue scenes more specific in the Hue app.
The Hue hub has limited space for scenes and will delete scenes if new ones get created that would overflow that space. The API documentation says this is based on the scenes that are “least recently used.”
Suggest an edit to this page, or provide/view feedback for this page.