Wiz Lights
homebridge-wiz-lan · v3.4.2
Adds Wiz bulbs, light strips and plugs controlled over the local network.
What it says it supports
Brands
- Wiz
- Philips
Devices it names
- Wiz RGB bulbs
- tunable white bulbs
- light strips
- ESP10_SOCKET_06
- ESP25_SOCKET_01
Shows up in Apple Home as from its README
What people report
WiZ bulbs work broadly; Philips WiZ Wi-Fi bulbs reported on/off only, and newer smart plugs were misidentified as bulbs. Color translation has known issues.
- Works4
- Partly works3
- Not working1
| Device | Status | What they said | Source |
|---|---|---|---|
| Philips Wiz bulbs | Works | Work very well and fast; need good WiFiSaved copyAfter the only HomeKit compatible bulb available in my country got taken off the market, I'd been been searching for an alternative. Just got a Philips Wiz bulb a few days ago and it is working so well, I want to replace all my Yeelight Bulbs with these. A few great things about it. Wiz app allows you to configure it without any creating an account. Can be configured to remember last state in the app Can be configured for fade-in and out on power on and off, with configurable duration. This is actually a nice effect. The Wiz Lan plugin needs no configuration and just discovers all Wiz bulbs … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-05 |
| Philips Wiz RGB bulbs | Works | Works like a charm; colour temp has pitfalls; one user got plugin load errorSaved copyThank you! I was looking for something like this. Works like a charm! Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-01 |
| WiZ filament bulb ESP06_SHTW1_01 | Works | Same color-wheel bug as above, fixed in v3.0.1Saved copyI have the same problem with my filament bulbs ESP06_SHTW1_01, but I had this straight from the beginning Excerpt saved from GitHub on 2026-10-22. | Issue #35 · 2021-02 |
| WiZ tunable white bulb ESP56_SHTW3_01 | Works | Showed RGB color wheel wrongly; fixed in v3.0.1Saved copyI have a very curious one @kpsuperplane, originally these TW lights (model ESP56_SHTW3_01) showed only white selections and only the temperature wheel; once selecting from the temperature wheel the menu selection now displays colours and both a colour and temperature wheel. It seems to be stuck as an RGBW light now. This has not broken anything, but definitely a bug. Excerpt saved from GitHub on 2026-10-22. | Issue #35 · 2021-02 |
| Philips Smart Wi-Fi bulbs (WiZ) | Partly works | Only on/off works; dimming and color do not. Matter is suggested insteadSaved copy… shows the setting changed, however the physical light bulb will not change at all. This is true for both RGB and Tuneable White. `[2/27/2024, 2:24:07 PM] [WizSmarthome] Initializing WizSmarthome platform... [2/27/2024, 2:24:07 PM] [WizSmarthome] [Refresh] Pings are off [2/27/2024, 2:24:07 PM] [WizSmarthome] Loading accessory from cache: Wiz Tunable White Bulb d8a011e4c70f [2/27/2024, 2:24:07 PM] [WizSmarthome] Loading accessory from cache: Wiz Tunable White Bulb d8a011e449e3 [2/27/2024, 2:24:07 PM] [WizSmarthome] Loading accessory from cache: Wiz Tunable White Bulb d8a011e8060b [2/27/2024, … Excerpt saved from GitHub on 2026-10-22. | Issue #150 · 2024-02 |
| Philips WiZ Wi-Fi LED bulb 9290023833a | Partly works | Showed as light plus speaker; fixed by disabling Scene support in plugin settingsSaved copyTurn off Scene support on the Wiz plugin’s settings within Homebridge. ☻ Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-09 |
| WiZ RGB bulbs | Partly works | HomeKit color temperature mis-translated to RGB saturation instead of white LEDsSaved copy@kpsuperplane I found out why the plugin color translation is wrong. (Not that I know how to fix it - yet.) Both the WiZ App and the Home App use separate pickers for RGB saturation settings vs. Temperature Kelvin settings. The plugin is incorrectly using Temperature in HomeKit-to-WiZ bulb translation to saturate the bulb's RGB settings instead of using the W (White) LED. For the bulb's internals, I found that maximum RGB saturation using the WiZ App color picker yields R:255, G:255, B:255, W:140. Note that no Temperature is set in RGB mode. Conversely, no RGB settings are used in Temperature … Excerpt saved from GitHub on 2026-10-22. | Issue #115 · 2022-08 |
| WiZ smart plug ESP25_SOCKET_01 | Not working | Identified as an Unknown Bulb since v3.2.6, can't switch as socket; user patched model checkSaved copyHello everyone, I have the following problem with a WIZ socket that is integrated in Home Bridge. This socket has worked perfectly for a long time and was correctly integrated into Home Bridge. Due to a new installation of Home Bridge, this socket now appears both as a socket and as a bulb in the Home Bridge device overview. It no longer functions as a socket and can therefore no longer be controlled. [27.11.2024, 08:41:25] [WizSmarthome] Updating accessory: Wiz Unknown Bulb cc40854d0b22 [formerly Wiz Wiz Socket cc40854d0b22] How can I solve the problem? How can I remove the incorrect entry … Excerpt saved from GitHub on 2026-10-22. | Issue #156 · 2024-11 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Wiz local UDP over LAN
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.6.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^18.20.4 || ^20.15.1 || ^22 || ^23 || ^24 || ^25 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | WizSmarthome |
| License | Apache-2.0 |
Community signals
| Downloads a week | 117 |
|---|---|
| Downloads a month | 871 |
| GitHub stars | 136 |
| Open issues | 45 |
| Closed issues | 89 |
| Last code push | 2026-08-25 |
| Latest version | 3.4.2 (2026-08-25) |
| First published | 2020-01-29 |
| Releases | 32 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- InputSource
- Lightbulb
- Outlet
- Television
Sources
- npm: https://www.npmjs.com/package/homebridge-wiz-lan
- Source code: https://github.com/kpsuperplane/homebridge-wiz-lan
- Issues: https://github.com/kpsuperplane/homebridge-wiz-lan/issues
- Verified plugins list: https://github.com/homebridge/verified





