yeelight is a simple library that allows you to control YeeLight WiFi RGB LED bulbs through your LAN.

There are many ways to install yeelight:

• With pip (preferred), do pip install yeelight.
• With setuptools, do easy_install yeelight.
• To install from source, download it from https://gitlab.com/stavros/python-yeelight and do python setup.py install.

To use yeelight, first enable "development mode" on your bulb through the YeeLight app. Then, just import the library into your project like so:

>>> from yeelight import Bulb

Afterwards, instantiate a bulb:

>>> bulb = Bulb("192.168.0.5")
>>> bulb.turn_on()

That's it!

Refer to the rest of the documentation for more details.

If you'd like to contribute to the code, thank you! To install the various libraries required, run (preferably in a virtualenv):

$ pip install -Ur requirements_dev.txt

In order for your MR to pass CI, it needs to be checked by various utilities, which are managed by pre-commit. pre-commit will be installed by the above command, but you also need to install the pre-commit hook:

$ pre-commit install

The hook will run on commit. To run it manually (e.g. if you've already committed but forgot to run it, just run):

$ pre-commit run -a

Thanks again!

yeelight is distributed under the BSD license.