lumalou (Python)

Fork notice. lumalou-gld09 is an independent fork of stramanu/lumalou by Emanuele Strazzullo, maintained at pavlikru/lumalou. It ships the changes proposed in stramanu/lumalou#2 (strict profile reads, typed schedule codecs and setters, authenticated device-key binding, injectable BLE client factory) until they are released upstream. The import package is still lumalou; do not install it alongside the upstream lumalou distribution. MIT licensed, original attribution preserved.

Local BLE control for the Fisher-Price Lumalou. Pure Python (async, bleak).

pip install lumalou-gld09

Library

import asyncio
from lumalou import LumalouClient, Color

async def main():
    devices = await LumalouClient.scan()
    async with LumalouClient(devices[0]["address"]) as luma:
        await luma.light_color(Color.RAINBOW)
        await luma.play(0)            # guided sleep playlist
        await luma.volume(5)
        print(await luma.request_state())

asyncio.run(main())

request_state() returns a fresh, strictly validated GLOBAL_STATE snapshot; it is not a complete device backup. For other blocks use request_named() or request_day_routine(), which return a ResponseEnvelope bound to the current session. The device pushes GLOBAL_STATE and other responses after commands and on physical changes; pass on_state / on_response to receive them. As in upstream, frames the client cannot use are ignored and never end the session. See the repository's client contract and schedule codec reference.

CLI

lumalou scan
lumalou light --color blue --brightness 7
lumalou sound --source ocean --volume 5
lumalou soother                 # --off to stop
lumalou time                    # sync clock
lumalou state                   # read a fresh GLOBAL_STATE snapshot
lumalou send 3c05               # raw app_data (opcode + args)

Add -a <address> to target a device; otherwise it auto-scans.

Requires Python 3.10+, a Bluetooth LE adapter, and radio range of the device.

Development

pip install -e ".[dev]"
pytest        # runs the shared golden vectors (spec/vectors.json)

MIT.