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. 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.