A Python library to control and monitor LIFX bulbs. Also provides a workaround for users having issues with controlling LIFX bulbs on their network.
Originally written to allow the LIFX bulb to work in non-standard networks, but it is growing to be much more.
Contributors: Deryck Arnold, Michael Farrell (micolous).
Huge thanks to Kevin Bowman (magicmonkey) and others for the lifxjs project on GitHub.
Without their work on the lifxjs project, this one would not have been possible.
- Allows the LIFX bulb smartphone app to work by "faking" a bulb and relaying commands to the real one (see examples/bridge.py).
- Gives the ability to display the contents of LIFX messages coming through.
- Huge thanks to magicmonkey and the lifxjs project for their hard work on working out the LIFX protocol.
- The ability to run "scenes" - provide a dictionary of times and colours and the library will do the rest (see examples/sunrise.py).
- Using multiple bulbs behind a single PAN gateway.
- Auto-discovery of bulbs (yes, should have been there already).
- Get Python (tested with 2.7, others may work). I use the Python(x, y) distribution.
- Ensure you have the Python setuptools.
- Run
easy_install pylifx
from a command prompt or terminal. - You're done.
- Linux users - ensure you have python-dev installed (for the netifaces package).
- Windows users - install the pre-built binaries for your python distribution using the links in the following URL: http://alastairs-place.net/projects/netifaces/ (The section is just above the start of the Changelog section).
If you don't want to build the documentation yourself, you can view it online.
Documentation may be built if you have Sphinx. You'll need to have pylifx built and in your PYTHON_PATH
(or run Sphinx from inside of a virtualenv
that has it installed). You can then build the HTML documentation with:
$ cd doc
$ make html
The documentation will then be available in doc/build/html/
.
There are other formats available, please see the Sphinx documentation for more information.