Universal Light Controller for Home Assistant (Marketplace integration)

Installs: 324 sharing analytics
GitHub stars: 143
Connection: Works locally
Upkeep: No update in over 18 months
Version: 2.2.6, January 6, 2025
Category: Lighting
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: uniled
Source: github.com/monty68/uniled
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Universal Light Controller (UniLED) controls Bluetooth LED controllers locally from Home Assistant. It covers controllers from the LED Chord, LED Hue and BanlanX apps, plus basic support for Hao Deng and Zengge BLE Mesh devices. Entities include lights, scenes, effect speed and length settings, audio input selection, effect type and signal strength sensors, and switches for effect direction and looping. Options cover light type, LED IC type, on/off effects, power on state, retry counter and polling interval. Home Assistant can discover devices on the network, and setup is done in the UI. Each device accepts one Bluetooth connection at a time, so the manufacturer app and Home Assistant cannot be connected together.

Automatic summary of the README and code of monty68/uniled. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.

Provides

Lights
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

Device

Cloud Credentials

Username (email)
Password
Country

After setup

Choose a channel to configure:
Light configuration typeThe light configuration and wiring (refer to the products manual for more details).
LED IC typeThe IC type of the LED's connected to the device.
LED ordering
Light on/off effect typeThe effect to use when the light is turned on or off.
Light on/off effect speedThe speed of the effect when the light is turned on or off.
Light on/off effect, pixels countThe number of pixels used by the effect when the light is turned on or off.
Coexistence of colored and white LED'sIn static modes only, determines if both colored and white LED's coexist or if they are controlled independently.
Power on stateDetermines the state of the light when power is applied/restored to the device.
Retry CounterThe number of retrys when attempting to communicate with a device.
Polling intervalThe interval in seconds between polling a device for status updates.
Username (email)
Password
Country

Texts from the code of monty68/uniled.

Entities

channelMaster, Channel 1, Channel 2, Channel 3, Channel 4, Channel 5, Channel 6, Channel 7, Channel 8
LightsBulb, Lamp, Light, Strip
NumbersEffect Speed, Effect Length, Audio Input Sensitivity
ScenesScene #1, Scene #2, Scene #3, Scene #4, Scene #5, Scene #6, Scene #7, Scene #8, Scene #9
SelectsAudio Input, Light Mode
SensorsEffect Type, Signal strength
SwitchesEffect Direction, Loop Effects, Effect Play/Pause, Loop Scenes