Skip to main content

Controller library for limitlessled/easybulb/milight Wi-Fi LEDs

Project description

https://travis-ci.org/ojarva/python-ledcontroller.svg?branch=master https://pypip.in/v/ledcontroller/badge.png

Controller for LimitlessLED RGBW lights (should be compatible with easybulb/milight as well).

Before using this, you need to use smartphone/tablet app to configure light groups to the gateway. Configuring remotes has nothing to do with configuring the gateway. You can not mix white lights and RGBW lights to same group.

See github repository for more information.

The code is based on the documentation available at limitlessled.com

Installation

pip install ledcontroller

Usage

import ledcontroller
led = ledcontroller.LedController("192.168.1.6")
led.off() # Switches all groups off
led.set_color("red", 1) # Switches group 1 on and changes color to red.
led.white(2) # Group 2 on and color to white.
led.set_brightness(50, 2) # Group 2 on and brightness to 50%.
led.disco(3) # Group 3 on and enable disco mode.
led.disco_faster(3) # Group 3 on and adjust disco mode speed.
led.on(4) # Switch group 4 on. Bulb automatically restores previous color and brightness.

Using both white and RGBW bulbs:

import ledcontroller
# By default, all groups are RGBW bulbs.
led = ledcontroller.LedController("192.168.1.6", group_1="white", group_4="white")
led.on()
led.white(2) # Switches RGBW group on and changes color to white.
led.white(1) # Turns white group on.
led.warmer() # Adjusts all white groups to warmer color. Switches all groups on.
led.cooler(1) # Adjusts group 1 white bulbs to cooler color.
led.brightness_up() # Adjusts white group brightness up. Does not affect RGBW lights.
led.brightness_up(2) # Does nothing to RGBW bulbs.
led.brightness_up(4) # Adjusts group 4 brightness.
led.set_brightness(50) # Adjusts all RGBW bulbs to 50%. Does not affect white lights.

Notes

  • There is automatic 100ms pause between each command. Almost every action requires sending more than one command, thus requiring several hundred milliseconds. You can change this with keyword argument “pause_between_commands”. However, decreasing the delay will cause some commands to fail.

  • As the gateway seems to be rather unreliable, all commands are sent multiple times (three by default). If you want to change this, use “LedController(ip, repeat_commands=n)” to create new lightcontroller object.

  • If for some reason you need to change gateway port, use keyword port= to change it.

  • Run testsuite with “python setup.py test”. Tests only run the code without checking whether proper commands were sent.

  • RGBW/white bulb commands differ a bit. Obviously, it is not possible to change color for white bulbs. For white bulbs, there is no absolute brightness settings. Similarly, only white bulbs allow adjusting color temperature (with .cooler and .warmer). There is 10 steps for white bulb brightness and color temperature.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ledcontroller-1.0.5.tar.gz (6.2 kB view hashes)

Uploaded Source

Built Distribution

ledcontroller-1.0.5-py2.py3-none-any.whl (8.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page