Use Homey to controll your Wiz light devices
in your local WiFi network
(No Wiz cloud needed)
ABOUT THE APP
WizLan (renamed from WizWiFi due to Homey standards) is a non compatible replacement for my old WizBulb app located in the old Homey Community Store.
The WizLan app is an app for controlling devices from Wiz Connected in the local WiFi network without using the cloud. The app differs from the old app WizBulbs (which no longer has support) in that it does not focus on the type of device, but primarily on groups of functionality. The way to register devices into the app has also changed. While WizBulbs used a "detect" function, WizLan has a manual device registration. After manual registration, the app will then check parameters and add the device to the app if all functionalities match the type of device you are trying to add. There are 3 types of light devices (dimmable, white adjustable/dimmable and full color) and 2 types of smart plug (with and without power measurement). Other devices such as motion detectors are per today not supported.
In the latest version of the app, it is tested with Wiz light bulbs sold under the Philips brand. These light bulbs have been difficult to use earlier because it seems that they have had a somewhat longer response time. In the latest version of the app, tests have shown that it now works. However, it cannot be guaranteed that they work in local networks with high loads.
Version 2.x.x
The new version 2.x.x version of the app is a total remake. The app has the same functionality, but the code is "modernized" and several errors are corrected. The app did not work in a normal way on older Homey's prior to versions PRO 2023, and has therefore got new devices that work on all versions of Homey's.
The old devices from version 1.x.x will still work, but with the same errors as before. It is therefore recommended to delete the old devices and add them again. The new devices have improved functionality and stability. To "move" the old devices to the new devices, you can do it as follows:
→ Go to settings on the "old" device and note the IP address before deleting.
→ Delete the "old" device.
→ Create a new device with the IP address and possibly the same name.
REMEMBER! Since the device has changed, you must go into all flows that use the device and change all places where the device is used with "replace" and the same functionality. This is unfortunately the downside of going for new devices, but it should lead to better functionality and fewer errors.
NOTE! Wiz Connected has changed the software in their light bulbs so that Tunable Lights do not have the same white color range on all light bulbs. This means that it is possible to set the white color outside the range on some light bulbs. Please consult the specification of your light bulb when setting the white color.
DEVICE TYPES
Dimmable Lights
Tunable Lights
Color Lights
Socket
Energy Socket
How to Pair a device ?
Add device to local network
First, the new Device must be entered into the local network. Unfortunately, this must be done with app from Wiz Connected app on Android or iPhone. This is done by pressing the plus sign in the app and following the instructions.
Check the device
After getting the device into the Wiz Connected app, it is perceived to test the various features of the Device to see if everything works properly. If it works here, it should also work in Homey.
Pair the device in Homey
Then it's time for Homey. The app has manual device registration. Here you will register the IP address and name you want on the device. After manual registration, the app will then check parameters and add the device to the app if all functionalities match the type of device you are trying to add.
Customize the device
When the device is installed in the Homey app, a standard icon is displayed. This icon can be changed to adapt it to the device in the Homey app to make it easier to recognize. It is also a good idea to set a fixed IP address on the Wiz device in the local network.
Source code / bugs etc..
Here you find it....
The WizLan app has been developed and distributed as a free open source app by the developer (Jan-Ivar Bøyum). If you download the app from the GitHub and make changes that others may also benefit from, it is expected that the changes are reported (eg in bugs) so that the changes can be implemented in future versions. Remember it's open source. If the code is used as a basis for developing a new app, it is expected that it will be shared with the community as Open Source.
Source code can be found freely on github and can be loaded from there:
Bugs can be reported on github and will be addressed there:
The app is based on an unofficial API that uses the local network to control the devices. This has been done out of consideration for the problems involved if the internet connection fails. With an API that is based on communication against an external server, losing the internet connection would mean that you could not control the devices. However, using an unofficial API could mean that the app does not work if the interface to the devices changes.
Device types and functionalty
All devices that have been tested with at least one type of bulb or other device from Wiz Connected. All other bulbs / devices of the same type should then in principle work. Below you will find an overview of devices, and other functionality in the devices.
Device functionality
| Device | On/Off | Dim. | Temp. | RGB Color | Scenery | Power mesr. | Tested |
|---|---|---|---|---|---|---|---|
| Dimmable devices (Dimmable Light) |
✓ |
✓ |
✓ |
||||
| Tunable white devices (Tunable Light) |
✓ |
✓ |
✓ |
✓ |
✓ |
||
| Full color devices (Color Light) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
|
| Wiz SmartPlug (Socket) |
✓ |
✓ |
|||||
| Wiz PowerPlug (Energy Socket) |
✓ |
✓ |
✓ |
Scenery overview
| Scenario | Tunable Light | Color Light. | Dimmable Light | Remarks |
|---|---|---|---|---|
| NORMAL | ✓ | ✓ | ✓ | 2700K |
| OCEAN | - | ✓ | - | |
| ROMANCE | - | ✓ | - | |
| SUNSET | - | ✓ | - | |
| PARTY | - | ✓ | - | |
| FIREPLACE | - | ✓ | - | |
| COZY | ✓ | ✓ | - | |
| FOREST | - | ✓ | - | |
| PASTEL COLORS | - | ✓ | - | |
| WAKE_UP | - | ✓ | - | |
| BEDTIME | - | ✓ | - | |
| WARM WHITE | ✓ | ✓ | - | |
| DAYLIGHT | ✓ | ✓ | - | |
| COOL WHITE | ✓ | ✓ | - | |
| NIGHT LIGHT | ✓ | ✓ | - | |
| FOCUS | ✓ | ✓ | - | |
| RELAX | ✓ | ✓ | - | |
| TRUE COLORS | - | ✓ | - | |
| TV-TIME | ✓ | ✓ | - | |
| PLANTGROWTH | - | ✓ | - | |
| SPRING | - | ✓ | - | |
| SUMMER | - | ✓ | - | |
| FALL | - | ✓ | - | |
| DEEPDIVE | - | ✓ | - | |
| JUNGLE | - | ✓ | - | |
| MOJITO | - | ✓ | - | |
| CLUB | - | ✓ | - | |
| CHRISTMAS | - | ✓ | - | |
| HALLOWEEN | - | ✓ | - | |
| CANDLELIGHT | ✓ | ✓ | - | |
| GOLDEN WHITE | ✓ | ✓ | - |
Device flows
| Flow | Dimmable Light | Tunable Light | Color Light | Socket | Energy Socket |
|---|---|---|---|---|---|
| Condition on/off | ✓ | ✓ | ✓ | ✓ | ✓ |
| Condition watt exeeded | - | - | - | - | ✓ |
| Action set color scene | - | - | ✓ | - | - |
| Action set white scene | - | ✓ | ✓ | - | - |
| Action set Kelvin | - | ✓ | - | - | - |
| Action dimming | ✓ | ✓ | ✓ | - | - |
Install WizLan
Here you can install it....
Installation of the WizLan app is done through the Homey PRO app store. On the app store you allways will find the latest official version of the app. The source for the app will be posted on GitHub, but it can never be guaranteed that the version posted on GitHub will be the same as the one on the Homey PRO app store (there may be delays in synchronization, or ongoing work on the app). Issues can be posted in GitHub, such as reporting errors or suggestions for improving the app.
The project can be downloaded from GitHub here:
Link to Homey APP store: