A Python library for controlling YeeLight RGB bulbs.
Project description
yeelight is a simple Python library that allows you to control YeeLight WiFi RGB LED bulbs through your LAN.
For a command-line utility that uses this library, see yeecli.
Installation
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.
Usage
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.
The library also contains a (currently undocumented) asyncio interface.
Contributing
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!
License
yeelight is distributed under the BSD license.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file yeelight-0.7.0.tar.gz.
File metadata
- Download URL: yeelight-0.7.0.tar.gz
- Upload date:
- Size: 47.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.8.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 808f1959dea2284fad11b27f364e1d1d61884904e715c37e451ddc8970f84c26 |
|
| MD5 | e295a4db653e6674895ef03343a42046 |
|
| BLAKE2b-256 | bc2e9c5c6a0869bc6a04276f00d92b98211dab159eae2a95914a7bc7dabc2c7b |
File details
Details for the file yeelight-0.7.0-py3-none-any.whl.
File metadata
- Download URL: yeelight-0.7.0-py3-none-any.whl
- Upload date:
- Size: 33.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.8.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | dde49004bf523b86cbce0722898be9bd1247d80ff8682047c1b8510d3ce53cc0 |
|
| MD5 | 2daeb17cfc5fd05fe0b0230dd19aff16 |
|
| BLAKE2b-256 | 8b08111cbfb106584d58aa721c7708f5f62d5b4d7a7d664bfc15834309dd9771 |
