Skip to content
Home Assistant TestFlight
Lighting

Magic Home

flux_led

Built inLocal push

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.

EntityShows up asNote
lightLight
switchSwitch or outlet
buttonButton (as a switch)
selectMode 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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Magic Home controllersWorks LocalDocs list many model codes such as 0x33, 0x35, 0x44, 0xA1 to 0xA7
Saved copy
Supported 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-ZJ21410Works LocalNewer socket revision with remote sensor supported
Saved copy
Proposed 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 bulbPartly worksPartly in Home
Brightness bounces between random levels after releasing slider in Home app
On/off and colour work but state updates are slow
Saved 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 0x09Partly works LocalCould not switch on/off or dim; support was a guess, mask fix suggested
Saved copy
The 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 controllerNot workingStopped responding to colour and brightness after firmware update
Saved copy
The 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 inHome Assistant 0.25
Set up in the UIYes
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.