diyHue - A Hue bridge emulator

This project emulates a Philips Hue Bridge that is able to control ZigBee lights (using Raspbee module, original Hue Bridge or IKEA Trådfri 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 Raspberry Pi. 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/Trådfri sensors and switches will also be applied to the bridge emulator.

Master-Refactor Details

This is the newest version of diyHue and has numerous changes compares to the old version. Understand that using this version can result in things breaking! As breaking changes are made here, they will be listed below. If something does break and it is not listed below, please make an issue with debug logs so we can look into it!

1. Config is incompatible with the master branch (can be migrated by comparing the old and new config manually)
2. Config is now stored under /config so please use that when mounting the config directory in Docker.
3. All other installation methods besides Docker are unsupported. Docker is available on most platforms including Raspberry Pi.

Getting Started

All documentation and instructions can be found over at diyhue.readthedocs.io

Requirements

• Python 3
• Python modules: ws4py, requests, astral, paho-mqtt see requirements.txt

or

• Docker ;-)

Recommendation

• Hue Essentials phone app for remote control and entertainment effects.
• WS2812 Strip + Wemos D1 mini board for cool entertainment affects.
• RaspberryPi 3B connected via ethernet port to your network for bridge emulation (avoid using 2 interfaces in the same time).

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
• Trådfri Gateway
• Hue Bridge (original + other emulators)
• Home Assistant
• Domoticz
• Openhab
• Philips Ambilight TV's
• Kodi Hue Ambilight
• Jeedom
• Hue Sync for PC
• Deconz
• Zigbee2mqtt see mqtt

Working smartphone applications

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

Not working

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

Supported lights and devices

• WS2812B and SK6812 smart led strips
• MiLight
• Yeelight
• LYT8266
• Phillips Hue
• Ikea Trådfri
• 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)
• MQTT lights see mqtt
• Hyperion.ng
• SONSOFF TX T3 US 1/2/3C (1 to 3 buttons)

To Do

• esp8266 alarm horn (+schematic)
• Alarm (email notification + eps8266 horn)

Support

If you need help with diyHue you can get support from other users, aswell as the maintainer.

For fast and live Support.

Our Board might already have your fix and answer ready. Have a look!

Since Slack is faster at providing live Support but not as good when it comes to save and show known Issues, we kindly ask you to open a Topic at our Discourse group. This will provide Help for others in the future.

Note: Please provide some Logs to make it easier for all of us. Enable Debug by manually starting diyHue with additional --debug true argument.

diyHue is Opensource and maintained by volunteers in their free time. You are welcome to contribute and become a recognised member of the diyHue community.

Stability

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 replaced with Ikea Trådfri 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 Trådfri devices (lights + sensors), Xiaomi Motion Sensor, native ESP8266 bulbs, ESP8266 + WS2812B strips, and Xiaomi YeeLight color bulbs.

Please post on our Slack team any other device/application that you find to work with this emulator.

Check the docs for more details.

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: Thingiverse 2773413

qtHue

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

Credits

• Ben (@cheesemarathon) All fancy github integrations
• Stephan van Rooij - zigbee2mqtt integration
• @avinashraja98 - Hue Entertainment server
• Federico Zivolo (@FezVrasta) Internal WebGUI
• @J3n50m4t - Yeelight integration
• Martin Černý (@mcer12) - Yeelight color bulb
• probonopd https://github.com/probonopd/ESP8266HueEmulator
• sidoh https://github.com/sidoh/esp8266_milight_hub
• StefanBruens https://github.com/StefanBruens/ESP8266_new_pwm
• Cédric @ticed35 for linkbutton implementation
• @cheesemarathon - Help with Docker images
• @Mevel - 433Mhz devices
• @Nikfinn99 - PCB designs
• @crankyoldgit - IR Remote library