Skip to content
Main diyHue software repo
Python C JavaScript Shell HTML Dockerfile
Branch: master
Clone or download
mariusmotea Merge pull request #168 from Zappelphilipp/lightdiscovery-fix
fix: light-discovery: checking if json is valid.
Latest commit 2e1109a Aug 22, 2019

license CommitActivity ZenHub

JoinSlack SlackStatus

Build Status 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

Getting Started

All documentation and instructions can be found over at


  • 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


  • Docker ;-)

To Do

  • Improve web interface
  • esp8266 alarm horn (+schematic)
  • esp8266 IR controller
  • 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 features:

  • 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 post on our slack team any other device/application that you find to work with this emulator.

Check the docs for more details

Youtube Demo

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

Contributions are more than 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.