Getting started

Introduction

To help you getting started with your first diyHue deployment, have a look at this shopping list. This introduction is very short and abbreviated. You can find all details and much more at the documentation of diyHue.

In a Nutshell:

  • diyHue controls and manages your diyLights build by yourself (ESP8266 + LEDs)
  • implements existing 3rd party Lights (Yeelight, Ikea Bulb, Hue Bulb)
  • implements 3rd party Sensors and Switches (Xiaomi, Ikea, Hue Dimmer)
  • works on your own Network (no cloud connection)

Hardware

Host Machine

You need a System to run the Pyhton Script.
This needs to be running 24 /7. A Raspberry Pi is common.
You can also use a Docker image or install on OpenWrt systems like a Router.

Smart Light

Build your own smart Light with a ESP8266 based Microcontroller and some LEDs like the WS2812b.
Very cheap and easy to assamble.
Flash the firmware provided in the GitHub repo and follow instructions on how to set up a diyLight.

Commercial Lights

Feel free to add ready made smart Light bulbs.
WiFi enabled Bulbs can be reflashed.
Devices using Zigbee can be added via Zigbee Gateway Stick or using the original Gateway (basic functionality)

Note: since diyHue operates on your local Network, you need additional Hardware
like the Raspbee or Conbee Module to talk to Devices that use the Zigbee Protocol e.g. Ikea Tradfri Series
and original Hue Products

Software

Hue Emulator Script

Download and install the Hue Emulator Pyhton Script.
Very easy done with one simple installation Script
You can also use a Docker image or install on OpenWrt systems like a Router.

Optional

Sensors and Switch

Enhance your diyHue experience by adding Sensors and Switches to control your Rooms with Scenes
and predefined Settings.
Note: since diyHue operates on your local Network, you need additional Hardware
like the Raspbee or Conbee Module to talk to Devices that use the Zigbee Protocol e.g. Ikea Tradfri Series
and original Hue Products
Users of diyHue have created their own diyHue compatible Sensors and Switches.
Schematics and Instructions can be found in the GitHub repo

diyHue Map