Skip to content
Homebridge plugin for Yeelight white and colored bulbs.
Branch: master
Clone or download
vieira Merge pull request #39 from vieira/dependabot/npm_and_yarn/lodash-4.1…

Bump lodash from 4.17.4 to 4.17.13
Latest commit aa39eee Jul 11, 2019

Homebridge YeeLight Wi-Fi

YeeLight plugin for Homebridge supporting Wi-Fi lighting devices.

This allows you to control your YeeLight wi-fi devices, such as the YeeLight Bulb and the YeeLight Stripe with HomeKit and Siri. No apps required.


  • Node.js >= 7.6.0
  • Avahi


  1. Install homebridge, sudo npm install -g homebridge
  2. Install this plugin using, npm install -g homebridge-yeelight-wifi

Setting up devices

Devices that already have the API enabled should be autodiscovered without any other actions on your part.

However, out of the factory, the YeeLight devices do come with the API disabled and you will have to enable it for them to work with Homebridge. To do so, go to settings and enable Developer Mode.

Configuration (Optional)

The following parameters can be changed in case you need to change the defaults.

    "bridge": {
        "name": "Raspberry Pi",
    "accessories": [{
    "platforms": [{
        "platform": "yeelight",
        "name": "Yeelight",
        "transitions": {
            "power": 400,
            "brightness": 400,
            "color": 1500,
            "temperature": 1500
        "connection": {
            "retries": 5,
            "timeout": 100,
        "multicast": {
            "interface": ""
        "defaultValue": {
            "aed78s": {
                "name": "Kitchen",
                "blacklist": ["set_hsv"]


When I got my first YeeLight bulb, there was already a homebridge plugin supporting it, however, it did not deal with transient failures. Frequently I would turn on a lamp, it would report it as On but no sign of light could be seen. Manually turning the lamp off and on would solve the issue but was a nuisance.

This plugin was born to solve this issue and end up being a complete rewrite fixing a lot of other bugs and minor problems and also implementing a cleaner architecture.

This plugin keeps track of all your commands until a successful response is received from the lamp. It implements exponential backoff to retry commands to which no response was received or a failure was reported by the lamp.

It also keeps track of known lamps and will continue to ocasionally look for them if they suddenly disappear. This is useful when you accidentally power off a lamp and later turn it on.

Bugs and feature requests

Please report any issues you might find, on GitHub.

Feature requests and specially pull requests are very welcome.

You can’t perform that action at this time.