Skip to content

MagicHome v1.0.0

Choose a tag to compare

View all tags
@Highsteads Highsteads released this 20 Aug 22:07
· 7 commits to main since this release
v1.0.0
908e397

First release.

Direct local control of Zengge / Magic Home WiFi LED controllers from Indigo — the ones sold as Magic Home, Magic Hue, FVTLED, LEDENET and various other names. No cloud account, no app running in the background, nothing to store.

What you get

  • A native Indigo dimmer, so the standard brightness slider and colour picker work, along with everything that already understands a dimmer — control pages, triggers, schedules, HomeKit bridges.
  • Discovery by MAC address, so a controller keeps working when your router hands it a different IP.
  • The controller's own 20 built-in patterns, and custom patterns of up to 16 colours that it stores and cycles itself.
  • Plugin-driven effects the controller cannot do alone: smooth fades, slow colour drift around a palette, a sunrise on a perceptual ramp, and a flash that puts the previous colour back.

Installing

  1. Download MagicHome.indigoPlugin.zip below
  2. Unzip it — you will get MagicHome.indigoPlugin
  3. Double-click it, and Indigo will install it

Then Plugins → MagicHome → Discover Controllers, and add a device.

Worth knowing before you start

An RGBW controller has one white channel and it is the warm one. What the app offers as "cool white" is red, green and blue driven together — there is no second white channel to address, and the two are mutually exclusive. Both are available as separate actions.

Bluetooth-only controllers are not supported. Some recent Zengge hardware has dropped the network protocol entirely.

Documentation

The protocol reference records what these controllers actually do, measured and read back rather than taken on trust — including several places where the widely published account and the hardware disagree. There is also an architecture note, a scripting guide and troubleshooting.

Developed against an FVTLED / Zengge RGBW controller and verified end to end on real hardware. 187 tests.

Assets 3
Loading