---
id: led-ble
version: "1.1.12"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# led-ble — Control a wide range of LED BLE devices

License: permissive · Maintenance: active · Downloads: 75.3K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 75.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth LE LED controller, generic BLE light control, Triones LED control, wireless RGB LED driver, BLE light automation, bluetooth-iot, home-automation, led-control

[View on SkillFed](https://skillfed.io/packages/led-ble) · [View on PyPI](https://pypi.org/project/led-ble/)