Skip to content
Philips Hue emulator that is able to control multiple types of lights
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.build Fix working dir Nov 29, 2018
.github Improve stale bot options Nov 29, 2018
BridgeEmulator fix startup error with only tradfri lights Dec 18, 2018
Images Add files via upload Nov 6, 2018
Lights Blitzwolf BW-SHP6 Jan 18, 2019
Sensors New version of this sketch Nov 6, 2018
.gitignore Blitzwolf BW-SHP6 Jan 18, 2019
.gitmodules remove mbedtls repo link Jul 15, 2018
.travis.yml Use local built image for test docker run Dec 1, 2018 Add link to header Mar 1, 2019


Please only open new issues at diyhue/diyHue

This project has rapidly grown in size and has therefore moved to it's own organisation diyhue Don't worry though, this is not the end of the project, just the next step in its development. It has also grown enough that we have split the repo into four so each can focus on it's own subject, be that the main code, diy Lights or sensors and controllers. You can find the new diy organisation and its repos here!

To migrate your existing install to the new repo please run the following command from the diyHue install directory. This is /opt/hue-emultaor if you used the easy install script:

curl -s | sudo bash /dev/stdin

If your using docker, please just pull the latest image.

Thank you for your support. 😄

license CommitActivity ZenHub

JoinSlack SlackStatus

TravisCI DockerPulls

This project emulates a Philips Hue Bridge that is able to control ZigBee lights (using Raspbee module, original Hue Bridge or IKEA Tradfri Gateway), Mi-Light bulbs (using MiLight Hub), Neopixel strips (WS2812B and SK6812) and any cheap ESP8266 based bulb by replacing the firmware with a custom one. It is written in python and will run on all small devices such as the RaspberryPi. Arduino sketches are provided for the Hue Dimmer Switch, Hue Tap Switch and Hue Motion Sensor. Lights are two-way synchronized so any change made from original Philips/Tradfri sensors and switches will also be applied to the bridge emulator.

diyHue ecosystem


  • python 3
  • nmap package for esp8266 lights autodiscover sudo apt install nmap
  • python ws4py package only if zigbee module is used sudo pip install ws4py

To Do

  • Working directly with ZigBee lights, switches and sensors with RaspBee module
  • control IKEA Trådfri lights from HUE applications
  • Create ESP8266 bridge device to add MI Lights to Hue Bridge emulator.
  • On/Off control for other home devices using virtual lights
  • Alarm (email notification + eps8266 horn)
  • Hue Entertainment support

Working HUE futures:

  • Control lights (all functions)
  • Control groups (all functions)
  • Scenes (all functions)
  • Routines
  • Wake up
  • Go to sleep
  • Switches (custom esp8266 switches)
  • Autodiscover lights
  • Hue entertainment

Working devices and applications:

  • Amazon Alexa (control only the lights)
  • Logitech Harmony
  • Tradfri Gateway
  • Hue Bridge (original + other emulators)
  • Home Assistant
  • Domoticz
  • Openhab
  • Philips Ambilight TV's
  • Kodi Hue Ambilight
  • Jeedom
  • Hue Sync for PC

Working smartphone applications:

  • Hue (official application)
  • Hue Essentials - recommended
  • hueManic
  • OnSwitch
  • HueSwitcher
  • LampShade

Not working:

  • Home & Away future from Hue app (require remote api)
  • Google Home (require remote api)
  • Eneco Toon (very likely it use cloud service detection)

Supported lights:

  • WS2812B and SK6812 smart led strips
  • MiLight
  • Yeelight
  • LYT8266
  • Phillips Hue
  • Ikea Tradfri
  • Pwm RGB-CCT
  • Pwm RGBW
  • Pwm RGB
  • Pwm CCT
  • Pwm Dimming (up to 6 lights for every esp8266)
  • On/Off plugs/lights (up to 6 lights for every esp8266)
  • On/Off 433Mhz devices (multiple devices for every esp8266)


All the lights in my house are controlled by this solution so the stability is very important to me as there is no turning back to classic illumination (all switches were replaces with Ikea Tradfri Remotes and holes covered). However I don't use all the functions, so i'm unable to perform full tests on every change. What I do currently use is Deconz with all Tradfri devices (lights + sensors), Xiaomi Motion Sensor, native ESP8266 bulbs, ESP8266 + WS2812B strips and Xiaomi YeeLight color bulb.

Please submit in this issue or on our slack team any other device/application that is working with this emulator.

Check the Wiki page for more details

Youtube Demo

I push updates fast so if you want to be notified, just watch this repo

Contributions are welcome

Hue living color light project for 3D printing:


You may want to see also my new project qtHue that provide a simple user interface for controlling the lights. qtHue


You can’t perform that action at this time.