A Python client to control your smart bulbs through lightsd

lightsd is a daemon (background service) to control your LIFX WiFi "smart" bulbs. This package allows you to make RPC calls to lightsd to control your light bulbs from Python. It is built on top of the asyncio module and requires Python ≥ 3.5, here is a complete example:

import asyncio
import click

from lightsc import create_async_lightsd_connection
from lightsc.requests import (
    GetLightState,
    PowerOff,
    PowerOn,
    SetLightFromHSBK,
 )


async def example(url, targets):
    client = await create_async_lightsd_connection(url)
    try:
        click.echo("Connected to lightsd running at {}".format(client.url))

        lights_state = await client.apply(GetLightState(targets))
        click.echo("Discovered {} bulbs: {}".format(
            len(lights_state.bulbs), lights_state.bulbs
        ))

        transition_ms = 600
        red_hsbk = (0., 1., 1., 3500)
        click.echo("Turning all bulbs to red in {}ms...".format(transition_ms))
        async with client.batch() as batch:
            batch.append(PowerOn(targets))
            batch.append(SetLightFromHSBK(targets, *red_hsbk, transition_ms=transition_ms))

        await asyncio.sleep(transition_ms / 1000)
        click.echo("{}ms transition done".format(transition_ms))

        click.echo("Restoring original state")
        async with client.batch() as batch:
            for b in lights_state.bulbs:
                PowerState = PowerOn if b.power else PowerOff
                hsbk = (b.h, b.s, b.b, b.k)

                batch.append(PowerState([b.label]))
                batch.append(SetLightFromHSBK([b.label], *hsbk, transition_ms=transition_ms))
    finally:
        await client.close()


@click.command()
@click.option("--lightsd-url", help="supported schemes: tcp+jsonrpc://, unix+jsonrpc://")
@click.argument("bulb_targets", nargs=-1, required=True)
def main(lightsd_url, bulb_targets):
    """This example will turn the targeted bulbs to red before restoring their
    original state.

    Read the `protocol docs`_ to learn how to format targets.

    If an URL is not provided this script will attempt to connect to lightsd's
    UNIX socket.

    .. _protocol docs: protocol.html#targeting-bulbs
    """

    evl = asyncio.get_event_loop()
    evl.run_until_complete(evl.create_task(example(lightsd_url, bulb_targets)))

if __name__ == "__main__":
    main()