Skip to content
Custom component for using Hue sensors & remotes with Home Assistant
Jupyter Notebook Python
Branch: master
Clone or download
robmarkcole Merge pull request #169 from inverse/patch-1
Clarify installation + configuration
Latest commit 319f9c7 Jan 13, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
archive Adds testing Oct 11, 2017
custom_components/huesensor Fixed my typo Dec 13, 2019
debugging_issues Make key unique Jan 30, 2018
docs Initial commit Dec 20, 2017
.gitignore Remove init Aug 14, 2018 Update Jan 12, 2020
Testing and usage 13-10-2017.ipynb Updates testing Oct 13, 2017
hacs.json Create hacs.json Nov 17, 2019
hue.png Updates icons Sep 17, 2017
requirements.txt use hue platform for fetching data Dec 30, 2018

Code style: black Sponsor




Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder). You need to set up your Hue bridge first.

Alternatively it can be installed via HACS.


Once installed you need to setup the huesensor integration in your configuration.

  - platform: huesensor
  - platform: huesensor
  - platform: huesensor

Hue dimmer remotes can be used for a click and long press (hold button for 2 sec and see LED blink twice).

As per this issue it is recommended to use the default naming options in the Hue app in order to ensure sensible sensor names in HA.

Front end display

To add the following group to your HA frontend, add the following to groups.yaml (obviously editing to use your sensors):

  view: yes
    - group.Hue

    - binary_sensor.bedroom_motion_sensor
    - binary_sensor.hall_motion_sensor
    - binary_sensor.living_room_motion_sensor
    - sensor.living_room_temperature
    - sensor.living_room_light_level
    - sensor.living_room_lux
    - sensor.living_room_remote
    - sensor.remote_bedroom
    - device_tracker.robins_iphone

Temperature, light level and other data in the sensor attributes can be broken out into their own sensor using a template sensor, for example:

- platform: template

      friendly_name: 'Living room temperature'
      value_template: '{{state_attr("binary_sensor.living_room_motion_sensor", "temperature")}}'
      unit_of_measurement: °C

      friendly_name: 'Living room light level'
      value_template: '{{state_attr("binary_sensor.living_room_motion_sensor", "lx")}}'
      unit_of_measurement: lux

Track Updates

This custom component can be tracked with the help of HACS.


If you get an error when using this component, the procedure for debugging is as follows.

  1. Open an issue here on Github. Include the error message, release number of the custom component.
  2. Download the Hue API response following the instructions here. Save into a .json file.
  3. Parse the json file using the hue_sensors package and report the device ID (e.g. RWL_06-02) that is causing your issue.

There are a couple of examples of this process in the debugging_issues folder.


A big thanks to @yottatsa for his many contributions to this work, check out his profile!

Support this work

If you or your business find this work useful please consider becoming a sponsor at the link above, this really helps justify the time I invest in maintaining this repo. As we say in England, 'every little helps' - thanks in advance!

You can’t perform that action at this time.