Lightener
fredck/lightener · vv2.4.0
Magically control the state and brightness of lights in Home Assistant.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light |
What people report
Virtual light that maps one dimmer across several lights; users ask for range tweaks, owner declined a main-light follow feature.
- Requested2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Yeelight Ceiling Light (main + moon mode) | Requested | Wants one Lightener combining main and moon lights by brightness rangeSaved copyI second this, for a different use case. I have a lamp which exposes two different lights in Home Assistant (Yeelight Ceiling Light with a main mode and a moon mode). Now I'd like to create one lightener light which combines those two, from 1-30 the moon light should be used, from 31-100 the main one. With the current implementation changing the brightness will turn off the lamp, as a brightness = 0 command is being sent to the second light - which unfortunately turns off both modes. Excerpt saved from GitHub on 2026-10-23. | Issue #132 · 2024-02 | |
| Zigbee2MQTT bulb groups | Requested Local | Wants lights to stay off below a brightness thresholdSaved copyhi, great addon. My use case is that I have 6 lights from Zigbee2MQTT, sending individual commands to each lightbulb is network expensive, so I additionally have these 6 in a group so there's only 1x command being sent. The bulbs don't get very dim, so I want to turn these on one-by-one between brightness levels 1-6, after that, I want to start using the group as normal. Group is 0 up till brightness level 7, after which it scales to 100. Individual light 1 turns on at 1% brightness, should stay at 1% until lightner goes past 6% Individual light 2 turns on at 2% brightness, should stay on at … Excerpt saved from GitHub on 2026-10-23. | Issue #132 · 2024-02 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Details
| Installs (analytics) | 593 (0.08%) |
|---|---|
| GitHub stars | 186 |
| Latest version | v2.4.0 (2025-10-21) |
| Set up in the UI | Yes |
| Maintainers | @fredck |
| License | MIT |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| florianhorner/lightener-studio Newer code | ★ 8 | 2026-10-23 | Lightener Studio, a visual brightness-curve editor for Home Assistant. Shape how each light in a room responds to brightness, by hand, previewed live. Built on the Lightener integration by @fredck, extended for the visual editor. Upstream MIT license intact. |
| daniel1v/lightener Newer code | ★ 1 | 2026-07-27 | Magically control the state and brightness of lights in Home Assistant. |
| jftkcs/lightener Newer code | ★ 0 | 2026-04-05 | (HACK: Deal with mix of lights that do and do not support colors.) Magically control the state and brightness of lights in Home Assistant. |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/fredck/lightener#readme
- Source code: https://github.com/fredck/lightener
- Issues: https://github.com/fredck/lightener/issues
- HACS: https://hacs.xyz
