FAQ

In order to pair any App with Hue Emulator, you need to authorise the pairing request.

Go to your Hue Emulator Host Machine in your Browser.

http://[IpofEmulator]/hue/linkbutton

Login with default credentials “Hue:Hue” and press “Activate” Button.

Retry pairing while linkbutton is active.

Next step troubleshooting:

Try deleting cached app data. On android this can be done in Settings > Apps > Hue > Storage > Clear Storage. On iOS you must reinstall the app to clear data. 

Failing that delete the cert.pem file, restart diyHue, then delete the cached app data again.

After boot, the ESP8266 will broadcast a WiFi for the first 2 minutes with the SSID set in light_name variable (default Hue .....)

Connect to this network with you phone or computer and browse to http://192.168.4.1.

Modern computers/phones popup automatically the configuration window. From here you can choose the SSID of the network you would like the light to connect to and enter its password.

After the light is present on your network open the official Hue application and scan for new lights. In case no lights are found, check if the nmap package is installed. Note: The app will often say no lights found but the lights will then appear a few seconds after this notification. So be patient!

Disable your WiFi temporarly and restart ESP-8266. It will reopen the configuration Access Point.

The following devices are supported by default:

  • MiLight
  • Yeelight
  • LYT8266
  • Phillips Hue
  • Ikea Tradfri

The following can be controlled with an ESP8266 or ESP32:

  • WS2812B and SK6812 smart led strips
  • Pwm RGB-CCT LEDs
  • Pwm RGBW LEDs
  • Pwm RGB LEDs
  • Pwm CCT LEDs
  • 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)

More devices are always being added!

Currently these Devices are Supported:

  • Ikea Tradfri Dimmer
  • Ikea Tradfri Switch
  • Ikea Tradfri Motionsensor
  • Hue Dimmer Switch
  • Hue Motionsensor
  • Hue Tap
  • various Xiaomi Sensors
  • […]

Hue bulbs use the zigbee radios to communicate so you either need a genuine Phillips Hue Bridge or a raspbee module.

Follow the instructions for pairing. In addition it can help to disconnect your Internet for a short period to make sure the TV performs a local Network search instead of using remote API of Phillips.

IKEA Tradfri bulbs can be controlled when paired with an IKEA hub. If you wish to use IKEA switches then you must use the Raspbee module. This will enable you to control both the IKEA lights and switches without an IKEA hub.

Not all apps for Phillips Hue work out of the box with diyHue. If you are unable to pair the app with diyHue automatically, try looking for a manual pair option in the app. If that fails then open an issue here on GitHub. We will try our best to to get your app to work but due to the lack of support for the remote API with diyHue, some apps will never work.

Google Assistant uses the remote API to find your Hue bridge. The remote API is not supported by diyHue. At the moment it looks like it never will. However, don’t despair. There is an option to get it to work. Home Assistant is software used to provide a unified hub for all your smart devices. It has support for diyHue and Google Assistant, so you can import your diyHue lights into Home Assistant and use Google Assistant to control them via Home Assistant. There are plenty of instructions on the Home Assistant website however details on Phillips Hue can be found here and details on Google Assistant here. If you need more help, ask on our Slack chat or on the Home Assistant forums.

Hue asks to update your diyLight in order to use Entertainment Function.

Restart Hue Emulator service. Restart will update the configuration and software version of your own build Lights.

sudo systemctl restart hue-emulator.service

No! diyHue has its own ecosystem and does not work with other accounts. However you can import your Lights (no Sensors or Switches)  from your genuine Bridge and use it as a transceiver.

 

 

We work together with App developer of Hue Essentials App for android and Iphone.

It is disabled by default.

Once enabled, you can control and manage your Lights around the World.

https://www.hueessentials.com

If you forgot the changed Password, edit the linkbutton_auth Field in config.json to the default Hash SHVlOkh1ZQ==. This will reset the Password to Hue:Hue

Diyhue lights are auto discovered and should show up after a few minutes. If that does not help, try to ping the esp8266 from your pc while performing a search via app. Chances are that the esp8266 is in a low power state and does not respond while searching.

37 thoughts on “FAQ

  1. So if I need to also have a physical hue bridge to use Hue lights what is the point in having a diyhue? I’m just curious. Not being rude.

    1. You can use Original Bulbs in diyHue in combination with a Original Hue Bridge. However, you can simply connect any Zigbee Bulb (Ikea, Philips, etc.) with a additional Zigbee Dongle, skipping the Original Bridge. In addition the Dongle also makes it possible to connect Sensors and Switches to the diyHue ecosystem. diyHue Emulator can control diyLights AND Original Hue Bulb via Bridge or Zigbee Dongle. Hope that helped.

  2. I have porblems with the generic ON OFF device. I did everything tight. I can open the light with the ip in web Browser. BUT the hue app cnt find the light. what can i do now ? i tried it many times.

    1. It does happen that it sometimes takes a bit to discover. You can start the emulator manual with sudo service hue-emulator start --debug true with additional debug output. Join our Slack channel for live and in depth support. Join Slack
      Hope that helped.

  3. Next Question:
    I use “Müller Licht – Tint” lamps (7euro from supermarket). Raspbee module is hooked up. They work good with the hue app. the Problem is when i talk to alexa, the lamps only turn red or white. when i say “alexa lamps blue” they get red too. but the app(alexa) says they are blue. what can i do? and where is the problem? in the bridge? the lamp? the raspbee module? or in the alexa app? or communication error?

  4. Hello,
    I have diyhue installed on a Synology nas, with docker.
    I can connect to the diyhue interface with my browser to address : 192.168.168.42:1000
    Also http://192.168.168.42:1000/hue/linkbutton is working.
    Hue app on a Iphone, in help i put the address : 192.168.168.42:1000 and the app software detect the hub.
    Then i press connect and press the activate on the Hue LinkButton page but its not connecting.
    I have removed the app install it again but no luck, also i have other versions installed in docker but this problem is stil there, do you have some other options?
    Thanks in advance.

      1. Thank you for your answer, I already had the feeling that this would be it and was already working on free ports 80 and 443 on Synology NAS yesterday.
        It must be possible to modify 3 files, but despite that I keep getting the message that these ports are intended for the system, but I will try again today.

        1. Right now there are changes made to the code to specify a different port. But since the official hue api is using these ports it would be easier to comply to those standards. Maybe running a “mini” Linux vm on your Nas could be a solution for you, leaving the Nas alone. Or using a dedicated machine like a raspberry pi.

  5. Hi, i have an Orange Pi PC, it does not have wifi module/antenna. I don’t know/decide where i start the project. I read your wiki,i will buy “wemos d1 mini”, led stribe and wifi bulb. I am newbie for this device and just want to ask you for good start. 🙂 Could you give me device list, i want to buy at black friday at Aliexpress. Thank you.

    http://www.orangepi.org/orangepipc/

    1. Hello and welcome! Your orange pi will run the hue emulator python script, emulating the bridge. Connected via ethernet to your network. The wemos + led strip, flashed with DiyHue firmware, connects to your emulated bridge via wifi. That’s all you need. Zigbee devices like original hue bulbs need the hardware dongle conbee. Minimal setup: computer (orange pi, raspberry pi etc.), 1x wemos + ws2812 led strip, power supply.

  6. The Connection between the Hue App and the Bridge works finde, however If i Open the Hue Website to Connect the Bridge to my Hue account, ist won’t find th Bridge
    Amy ideas

    1. The emulated bridge will not work with a hue account. You can use hue essentials app if you would like remote access to your diyhue instance.

        1. I dont know exactly, as i dont have any Cloud Services running in my Setup. Some users have reported that they where able to pair.

  7. Is there a device limit like the probably hue Bridge? I am looking for a way to have 140-150 hue bulbs, motion sensors and dimmer switches on one bridge instead of the three hue bridges in using now.

    My setup is only working thanks to hue Essentials, but it is still very limiting to have multiple bridges that can’t communicate.

    1. There is no limit when it comes to bulbs etc. You can import all bulbs from original bridge Into diyhue and control them via original bridge, using it as a transceiver. Otherwise you can use a conbee dongle (zigbee gateway) to talk directly to the bulbs. With a conbee dongle you can also connect multiple sensors and switches to diyhue.

  8. Hi Team !
    I wonder if I could use a ATSAMR21B18 module with a RaspberryPi (https://fr.farnell.com/microchip/atsamr21b18-mz210pa/transceiver-2-4ghz-zigbee-802/dp/2522821).
    I want to make some experiments with my Phillips Hue lights, and i don’t have a Hue bridge (only LivingColors and remote).
    Bying either the ConBee or RasBee will cost me the price of the official Hue Bridge. That’s why I’d like to use a less expensive module.
    Thanks by advance.
    Thomas

    1. Welcome!

      The Hardware you mentioned is currently not supported, if it has some sort of API or Websocket endpoint where the data of connected devices is published it should be possible to implement.

      Kind regards

  9. Hello, I will try to use a raspberry pi B and a ws2812b led strip, and have 2 questions, does this pi will handle it? And is it possible to connect the led strip directly to the pi? Without the esp8266, on the I/O ports maybe?

    1. Hey! The raspberry pi B will handle it, no problem. Currently the Pi is only used for the python emulator. You need a controller like the esp8266 (wemos, nodemcu etc.) for the ws2812. Kind regards

  10. First of all awesome project! Currenly im thinking of buying a pi 3B+ But i was wondering what kind of SD card is recommended?

    1. Hey! Any size of 16GB or more is more than enough for your system. Diyhue won’t use much. Might have a look at the read and write speeds. But that is not essential for diyhue, more for general system speed etc. Class 10 is what I use in general.

  11. Hi there, sorry I’m a newbie to all this. I recently bought a Yeelight LED Lightstrip and was hoping to use it as Philips Hue lights. Can I run this on my PC instead of a Raspberry Pi? I only want to control it when I have my PC on. Sorry for the basic question and thanks for your help!

    1. You need to run the hue emulator python script whenever you want to control your light (or keep it running 24/7) yeelights are auto discovered and can be handled like hue bulbs. Steps to follow: setup Hue emulator on you PC (python or docker) bind hue app and link you yeelights. That’s it

  12. Not sure if I’m stupid, but how can I pair a ESP8266 DIYHue flashed Light to DIYHue Bridge?

    Both Webfrontends are up and running in the same network, Hue & Hue Essential apps are linked to the DIY Bridge.

    But DIYHue Bridge does not find the light. Ca I enter the IP somewhere or do I need to activate discovering on the light (if yes then How) ?

    I did not find that instructions in the manuals

    1. Hello Marius! Diyhue lights are auto discovered and should show up after a few minutes. If that does not help, try to ping the esp8266 from your pc while performing a search via app. Chances are that the esp8266 is in a low power state and does not respond while searching.

  13. Hello,

    I have runing diyhue on a raspberry pi 3B+ bit the philips hue app want to update. But everytime i try to update, it fails. Now i don’t have full access to the philips hue app.
    How can i fix this?

    Thanks

    1. Hey Mark!
      You need to update the swversion entry in config.json. This number is the emulated software version towards the app. You can also try and run the install script again to update diyhue. For now: use 1939070020 for swversion.

  14. I have setup diyHue on a RaspberryPi2 and it works with multiple Yeelights. Great. But now I am trying to connect a hue dimmer switch paired with a genuine Philips Hue Bridge. If I try to import the switch into diyHue using {emulatorip}/hue/{bridgeip} it only tells me that there are no new lights. So is it even possible to import the dimmer switch using the original hue bridge, and if so, how?
    I hope someone can help me, because I can’t really find anything on this topic on google or in the wiki.
    Thanks.

    1. Welcome Manuel! In short: Not possible with original Bridge. You can import the lights but no sensors or switches. If you want to use a zigbee switch like the original hue or Ikea you need a zigbee transceiver like the conbee 2 from Dresden Elektronik. You can find more on this in the documentation and getting started guide. Hope that helps

  15. Hi
    First thanks alot for everything you have make for this project
    Dose the diyhue light work with the original hue bridge?
    And if yes how, because I tried but when I search for light in Philips hue bridge I couldn’t find it but when I search with diyhue i found the light

    1. Hello and welcome! Diyhue lights (self build with esp8266) don’t work with original hue. Only with diyhue own Hue Bridge emulator. But you can import lights from your original bridge into diyhue and use the original bridge as a transceiver. This is limited to lights only and no sensor. If you want full access to original lights, sensors or other zigbee devices (Ikea sensors etc etc) you need a zigbee dongle like the conbee 2 from Dresden Elektronik.

  16. Hello,

    is it also possible to use the entertainment functionality with non-philipps-hue bulbs?

    E.g. have a Philipps Ambient TV, but connect it via DiyHue to Xiaomi Bulbs?

    1. Hello!
      Yes you can use milights with ambient TV. However delay and sync depend on multiple factors such as network delay, reception etc etc. For the best experience, as the name suggests, it does need some DIY.
      In general we suggest using esp8266 based bulbs with custom firmware.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.