led-ble

What it is and what it does

led-ble is a Python library for controlling generic, unbranded Bluetooth LE LED controllers and bulbs that share a common protocol family. These devices are widely sold under various names like Triones, LEDBLE, LEDBlue, QHM, and Dream, and the library abstracts their protocol to provide a unified interface. It is explicitly not a universal driver for all Bluetooth LE lights—brand-specific ecosystems like Govee maintain their own protocols and should use dedicated libraries instead.

The library wraps bleak and bleak-retry-connector to handle the Bluetooth communication layer, async-timeout for connection management, and flux-led for protocol handling. It targets developers building home automation, IoT, or smart lighting applications that need to control these common, low-cost LED devices. The package is in pre-alpha status, actively maintained, and requires Python 3.10 or later.

Use it for:

• Home automation systems that control generic BLE LED strips and bulbs in multiple rooms.
• IoT projects integrating cheap, unbranded Bluetooth LED controllers into custom lighting setups.
• Automation scripts that synchronize color and brightness across multiple compatible LED devices.
• Smart home integrations where Govee and other brand-specific ecosystems are out of scope.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Controls generic unbranded Bluetooth LE LED devices sold under names like Triones, LEDBLE, LEDBlue, QHM, and Dream, using a shared protocol family.

Yes, if you control generic unbranded BLE LED devices matching the Triones/LEDBLE/LEDBlue/QHM/Dream family. Active maintenance, low install friction, permissive license, and no known vulnerabilities support adoption. Pre-alpha status means the API may shift, so pin the version in production. Not suitable for brand-specific ecosystems like Govee.

Install

led-ble on PyPI

pip install led-ble

uv add led-ble

poetry add led-ble

Installing led-ble

Before you install

Low friction installation as a pure Python wheel. Actively maintained with a release 19 days ago; requires Python 3.10 or later. Depends on bleak and bleak-retry-connector for Bluetooth communication, plus async-timeout and flux-led.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart

pip install led-ble

from led_ble import Device

# Discover and control a BLE LED device
device = Device(address='XX:XX:XX:XX:XX:XX')
await device.connect()
await device.turn_on()

Requires Python 3.10 or later; Bluetooth hardware and proximity to a compatible BLE LED device.

Verify before relying

• Which specific LED device models are confirmed compatible beyond the advertised name patterns.
• Whether the library supports all color modes and brightness control methods for the target device family.
• Performance characteristics when controlling multiple devices simultaneously.

Package facts

Evidence: led_ble-1.1.12-py3-none-any.whl

Tags

More Libraries packages