Home

Awesome

diyHue - A Hue Bridge Emulator

Discourse JoinSlack Build Status

<!--[![Build Status](https://travis-ci.com/diyhue/diyHue.svg?branch=master)](https://travis-ci.com/diyhue/diyHue)-->

<br></br> diyHueLogo

<br></br>

diyHue provides a Ecosystem for several Smart Home Solutions, eliminating the need for vendor specific Bridges and Hardware. Written in Python and Open Source, you are now able to import and control all your Lights and Sensors into one System.

Lightweight and resource friendly, to run on small devices like the RPi .... 24/7

The Best part? No Cloud connection by Design!

Enjoy your diyHue enlighted Home.

<!-- 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. -->

diyHue ecosystem

Stats

DockerPulls CommitActivity arm version badge arm-size-batch amd version badge amd size badge

Getting Started

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

Requirements

or

Recommendation - minimal setup

You need a System that can run the python script or Docker Image 24/7!

EmulatorLightsApp
RaspberryPi 3BWS2812 Strip + Wemos D1 mini BoardHue Essentials (iOS & Android)

Working diyHue features

FunctionsDevicesAppsLightsSmarthome
Control lights (all functions)Amazon Alexa (control only the lights)Hue EssentialsWS2812B and SK6812 smart led stripsHome Assistant
Control groups (all functions)Deconz (Conbee 1 & 2)Hue AppPhillips HueOpenhab
Scenes (all functions)Trådfri GatewayhueManicIkea TrådfriJeedom
RoutinesHue Bridge (original + other emulators)Kodi Hue AmbilightYeelightDomoticz
Wake upLogitech HarmonyOnSwitchMiLightHome Assistant Add-on
Go to sleepPhilips Ambilight TV'sLampShadeHyperion.ng
Switches (custom esp8266 switches)Hue Sync for PCMQTT lights see mqtt
Autodiscover lightsHueSwitcherany PWM(CCT, RGB, RGBW) incl. Dimming
Hue entertainmentOn/Off 433Mhz devices (multiple devices for every esp8266)
LYT8266
WLED
<!-- - 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](https://diyhue.readthedocs.io/en/latest/lights/mqtt.html) <!-- ## Working smartphone applications --> <!-- - Hue (official application) - [Hue Essentials](https://play.google.com/store/apps/details?id=com.superthomaslab.hueessentials) - 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--> <!-- - 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](https://diyhue.readthedocs.io/en/latest/lights/mqtt.html) - [Hyperion.ng](https://github.com/hyperion-project/hyperion.ng) - [WLED](https://github.com/aircoookie/wled) --> <!-- ## To Do--> <!-- - esp8266 alarm horn (+schematic)--> <!-- - Alarm (~~email notification~~ + eps8266 horn) -->

Support

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

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

Please use GitHub, Slack or Discourse, other platforms are not checked by the maintainers.

Slack JoinSlack SlackStatus

Use Slack for a general chat or fast live support.

However: 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.

Discourse Discourse

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

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

Stability

Starting in Dec. 2020 we will introduce one Master and one Dev Branch. The Master will have the most stable code.

If you want to tinker and experiment you can try the dev Branch. Active development will take place here.

You want to get the latest features? Try the experimental Branch. Use at own Risk!

<!-- 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.

<!-- [![Youtube Demo](https://img.youtube.com/vi/c6MsG3oIehY/0.jpg)](https://www.youtube.com/watch?v=c6MsG3oIehY) <!-- ## qtHue <!-- You also may want to see my new project [qtHue](https://github.com/mariusmotea/qtHue) that provides a simple user interface for controlling the lights. ![qtHue](https://github.com/mariusmotea/qtHue/blob/master/Screenshot.png?raw=true) -->

Contribute

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. Feel free to add PR and Commits to our Dev Branch. If you are experienced in

We highly appreciate your support, making diyHue even better!

Support

diyHue is and will be Free to use. However it does take a lot of time to maintain the code etc etc.

Long story short.... you can support us at Ko-Fi

ko-fi

Thank you very much!

Credits

Additional Projects and Ideas

Hue living color light project for 3D printing: Thingiverse 2773413

License

license