Magic Home
flux_led
The Magic Home integration supports several brands of switches, bulbs, and controllers that use the same protocol. Chances are high that your bulb or controller (eg. WiFi LED CONTROLLER) will work with this integration if you can control the device with the Magic Home app or the Surp Life app.
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 | |
switch | Switch or outlet | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
1 report below say how a device from this integration behaves in the Home app.
What people report
Magic Home and similar LED controllers work locally with broad model-code support. Some unusual models and newer firmware fail, and the maintainer has since moved to ESPHome.
- Works2
- Partly works2
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Magic Home controllers | Works Local | Docs list many model codes such as 0x33, 0x35, 0x44, 0xA1 to 0xA7Saved copySupported devices: 0x01; 0x03; 0x04; 0x06; 0x07; 0x08; 0x09; 0x0E; 0x10; 0x16; 0x17; 0x1A; 0x1C; 0x1E; 0x21; 0x25; 0x33; 0x35; 0x41; 0x44; 0x52; 0x54; 0x62; 0x93; 0x97; 0xA1; 0xA2; 0xA3; 0xA4; 0xA6; 0xA7; 0xE1; 0xE2; 0x02. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| Magic Home sockets AK001-ZJ21410 | Works Local | Newer socket revision with remote sensor supportedSaved copyProposed change Hardware: AK001-ZJ21410 has a remote sensor. The rest of the remote configuration already works with no changes. No docs changes since this is just a newer revision of an existing device with 2.4ghz remote support. Some of the newer devices already have hardware support for it but shipped with older firmware and can be upgraded from firmware 3.12 to 3.22. ## Type of change <!-- What type of change does yo Excerpt saved from GitHub on 2026-10-23. | PR #79074 · 2022-09 | |
| Flux LED / Magic Light bulb | Partly works | Partly in Home Brightness bounces between random levels after releasing slider in Home app | On/off and colour work but state updates are slowSaved copy… environment (Hass.io/Docker/Windows/etc.): Ubuntu 14.04 / Python 3.5 Component/platform: Homekit Description of problem: When setting the brightness of a light through the Home app, the lights will bounce between random light levels within a one second interval once your finger is removed from the light level control in the apple home app. No issues when used through Homebridge, or setting light level through the Homeassistant GUI. Problem-relevant `configuration.yaml` entries and (fill out even if it seems unimportant): [code] Traceback (if applicable): [code] Additional information: Excerpt saved from GitHub on 2026-10-23. | Issue #13493 · 2018-03 |
| Magic Home CCT ceiling light 0x09 | Partly works Local | Could not switch on/off or dim; support was a guess, mask fix suggestedSaved copyThe problem I bought a CCT bulb and this is my first time to config a Magic House device in HA. I followed the tips to connect it to my router and HA discovered it autometically. It works fine with the Magic Home App, but I failed to change the power status or brightness in HA. When I click the switch button on the dashboard it slides to the other side, with nothing happen to the bulb, holding on for a while and slides back again. This corresponds to the log. However, when I turn it on/off in Magic Home App, the on/off status changes exactly on the HA dashboard(but cannot see the change of … Excerpt saved from GitHub on 2026-10-23. | Issue #75832 · 2022-07 | |
| Surplife LED controller | Not working | Stopped responding to colour and brightness after firmware updateSaved copyThe problem I recently received a led controller. It worked ok for a few hours, and now became completely unresponsive to any commands except on/off and sometimes some of the effects. Color change doesn't work anymore, so is brightness. The firmware update on the controller seem to have added a lot of new features... That this integration also were sadly missing. It seems like most updates are not integrated yet, sadly there is no way to go back to previous firmware in Surplife. (the device is on 192.168.1.131 IP, ignore the 192.168.1.168 which is another device, also by Magic Home, that … Excerpt saved from GitHub on 2026-10-23. | Issue #116725 · 2024-05 |
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.
Found automatically over
- DHCP
Details
| Installs (analytics) | 8,994 (1.27%) |
|---|---|
| Added in | Home Assistant 0.25 |
| Set up in the UI | Yes |
| Maintainers | @icemanch |
Devices listed in its documentation
- 0x01
- 0x03
- 0x04
- 0x06
- 0x07
- 0x08
- 0x09
- 0x0E
- 0x10
- 0x16
- 0x17
- 0x1A
- 0x1C
- 0x1E
- 0x21
- 0x25
- 0x33
- 0x35
- 0x41
- 0x44
- 0x52
- 0x54
- 0x62
- 0x93
- 0x97
- 0xA1
- 0xA2
- 0xA3
- 0xA4
- 0xA6
- 0xA7
- 0xE1
- 0xE2
- 0x02
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.