Hi everyone,
I am excited to introduce a brand-new, ultra-fast local integration for Legrand and Bticino systems on Homey Pro: Legrand with HomeKit Local!
The Story: Why Local instead of Cloud?
I have a Legrand/Bticino smart home setup at my home. While the official cloud-based APIs get the job done, they often introduce annoying delays and latency because every command has to travel to Legrand’s remote cloud servers and back. When you toggle a light, you want it to react instantly, not a few seconds later!
To solve this, we took a completely local approach. By leveraging the official Apple HomeKit Accessory Protocol (HAP) directly over the local network, we can control all devices bridged under the Legrand Gateway (and standalone devices) using nothing but their official 8-digit HomeKit PIN code.
The result? Zero cloud dependence, absolute privacy, and 0ms latency! 
Key Features
-
Fire-and-Forget Architecture (0ms Response): When you toggle a switch, light, or blind on your Homey dashboard, the interface updates instantly with zero lag. The actual HomeKit commands execute in the background with a graceful rollback if a device is offline.
-
Bi-directional Real-Time Sync: Any physical state change (pressing a wall switch, adjusting the official Home + Control app) is synced back to Homey instantly via real-time push event notifications.
-
Standalone Bticino Smarther Thermostat Support: In addition to bridged accessories under the Legrand Gateway, the app fully supports standalone HAP network accessories like the Bticino Smarther 2 Thermostat—complete with heating/cooling controls, target temperature adjustments, and live Relative Humidity readings!
-
No Accounts Needed: No developer portal, no cloud accounts, and no API keys. Setup takes less than 30 seconds.
Supported Devices & Capabilities
-
Lights: On/Off, Dim levels, Hue & Saturation color control, and Color Temperature adjustments.
-
Smart Power Outlets: Direct power state control (On/Off).
-
Rolling Shutters / Blind Controls: Setting position percentage (0-100%) and real-time movement tracking (Opening, Closing, Idle).
-
Smarther Thermostats: Real-time current temperature, target temperature controls, mode selectors (Off / Heat / Cool), and relative humidity monitoring.
-
Scene & Wireless Switch Buttons: Instantly relays physical button presses to Homey, featuring custom Flow triggers for Single Press, Double Press, and Long Press actions!
How to Get Started & Install
-
Make sure your Legrand Gateway and/or Bticino Smarther Thermostats are already set up on your local Wi-Fi, and have your 8-digit Apple HomeKit PIN code ready. (Note: If the device is currently paired directly to your iPhone’s Apple Home app, please remove it from Apple Home first, as HomeKit devices can only pair with one controller at a time).
-
Install the test version of the app here: 
Legrand with HomeKit Code - Test Version
-
Go to Add Device in Homey, select Legrand with HomeKit Code, type your Gateway IP (or leave empty for auto-discovery), enter the 8-digit PIN, and click Sign In!
I would love to hear your feedback, bug reports, and experience with different Legrand/Bticino child accessories. Let’s make our smart homes fast again!
Happy testing! 
Hello @Guray_Kircuvaloglu thanks for this app. I’ve been hoping for it, really appreciated.
Two questions: do you support blinds with “tilt” function and not only “level”? And do you think to support the Netatmo Weather Station with rain gauge?
Thank you very much for your kind words. I’m glad to hear that this app is useful for you.
Regarding blinds with a tilt function: unfortunately, the blinds I have at home only support percentage-based up/down control, so I was only able to test the level functionality. I do not have a blind with tilt support available for testing.
If your blinds support tilt, I would really appreciate it if you could test this and let me know what happens. If you run into any issues, please share the details with me and I will try to help or improve the app if possible.
Regarding the Netatmo Weather Station with rain gauge and wind sensor: unfortunately, these sensors are not supported through HomeKit itself, so it is not possible to bring them into Homey using the HomeKit code through this app.
Also, the existing Netatmo app for Homey works well for this purpose, so I would recommend using that app for the Netatmo Weather Station and its accessories.
The main purpose of my app is to support devices connected to the Legrand or Bticino gateway, such as wall switches, shutter switches, sockets, and fixed wall thermostats. In my experience, controlling these devices through the cloud API can sometimes cause delays of up to around 10 seconds, which makes daily use less comfortable. This app was created to provide a faster and more local way to control those devices.
I will test the blinds with tilt option.
For the weather station, I know some of the values are not even supported by HomeKit.
Thank you
Hi everyone,
I have just released a new update (v1.0.3) for testing! This update focuses on system optimizations and visual improvements to comply with the official Homey App Store guidelines.
What’s New in v1.0.3:
- System Optimization: Resolved a memory leak in the diagnostics logging system to keep the app’s RAM footprint stable and lightweight over long-term usage.
- Driver Icon Update: Updated the driver icons with a clean, minimalist design on a pure white background in accordance with Homey App Store guidelines.
- General bug fixes and stability improvements.
You can install the test version using this link:
Please let me know if you experience any issues. Thank you for your support!
hello, thanks a lot for you work. You’re amazing. I have a question: i’m currently using the other app for the bticino/legrand, the one on the cloud (extremely slow). What do I have to do to install this one? Uninstall the old versione and install yours? And then add again all the accessories?
thank you again
Thank you so much for your kind words, I’m really glad you like the idea of local control!
To switch from the cloud-based application to this local HomeKit-based version, here is the exact process you should follow:
-
Do you need to uninstall the old app? No, you don’t have to uninstall the official cloud app immediately. Both apps can technically run on your Homey at the same time. However, to keep your Homey clean and avoid confusion, it is recommended to remove it once you’re fully transitioned.
-
Do you need to add the accessories again? Yes. Since this app connects to your devices locally using the HomeKit protocol (instead of the Legrand cloud API), Homey needs to recognize them as new local devices.
Here is the recommended step-by-step strategy for a smooth transition:
-
Step 1: Go to your existing cloud-connected devices in Homey and check if they are used in any Flows. Make a quick note or screenshot of those flows, as you will need to update them later.
-
Step 2: Install this local app (Legrand with HomeKit Code).
-
Step 3: Start adding your devices through this new app. Follow the pairing instructions (using your HomeKit setup codes).
-
Step 4: Replace the old cloud-based device cards with your new local device cards in your Flows.
-
Step 5: Once everything works perfectly and instantly, you can safely delete the old cloud devices and uninstall the old app.
Hi Guray, thanks for your reply. I have another question: currently I have both Homekit and Homey running automation with my Bticino Accessories. Can I do that with your app?
Hi Nicola,
Wait, I need to correct myself quickly because I missed a very important detail about how HomeKit protocols work!
Since a HomeKit setup code can only be paired with one master controller at a time, you cannot connect the Legrand Bridge to my Homey app while it is still actively paired with your Apple Home app.
If you want to keep running automations on both platforms together, you should follow this exact strategy:
-
Remove/Unpair the Legrand Bridge from your Apple Home app first. This will release the HomeKit setup code.
-
Add the Legrand Bridge to Homey locally using my app (Legrand with HomeKit Code).
-
To bring those devices back into your Apple Home app, you can use the HomeKit Device Bridge app on Homey (you can find it here: https://homey.app/app/com.homekit.devicebridge/HomeKit-Device-Bridge/). It will bridge your new local Homey devices right back into your Apple Home ecosystem.
This way, Homey acts as the main local driver, and you still get full automation support on both Homey and HomeKit!
If you run into any issues or have extra requests during this setup, I’ll do my absolute best to help you out!
Got it. So if I Remove the Legrand Bridge from homekit I lose all my current automation with homekit ?
Yes, unfortunately you will lose your current HomeKit automations.
However, you don’t need to re-pair your accessories to the gateway. My app works locally and fast because of this HomeKit code, so you just need to reset the pairing lock.
Here is the trick to do it without losing your devices:
-
Press and hold the reset button on your gateway.
-
After about 10 seconds, you will see a fast flashing green light.
-
As soon as you see it, release the button immediately.
This will reset the HomeKit code for Homey, but it will not delete your connected accessories. They will stay paired to the gateway.
Just take screenshots of your current automations first, use this 10-second reset trick, and then you can add it to Homey.
Hi Guray, done. It works. Thank you. You’re great. Just for helping in making it perfect, sometimes I got errors like:
HAP write failed with status -70402
hope it helps.
best regards 
Thank you so much for your kind words and for letting me know! I’m really glad to hear that it is working for you.
I also appreciate you sharing that HAP write error (-70402). I want to make sure everything runs perfectly, so I will take a closer look at this issue over the weekend and try to fix it.
I will keep you updated. Thanks again for your support!
Hi everyone,
I have just uploaded a major update (v2.0.1) to the Homey Apps Store for testing! This version brings critical bug fixes, protocol alignment, and stability improvements.
Here is the detailed list of what has been resolved and improved in this release:
Pairing & Discovery
- Pairing a Second Device (H1): Fixed an issue where adding a second independent accessory (like a Bticino Smarther Thermostat) while a gateway was already paired would fail. The HomeKit PIN setup code is now always parsed correctly.
- Smart Auto-Discovery (O8): If multiple candidate devices are found on the network, the app no longer blindly picks the first one; it now lists them and allows manual IP entry if needed.
Connection & Networking
- DHCP / IP Change Survival (H2): Connections are now tracked using the persistent HAP Accessory ID instead of the IP address. If your gateway or thermostat gets a new IP from your router’s DHCP, the app will automatically detect it and reconnect within ~1 minute without breaking paired devices.
- Socket Race Guard (H3): Eliminated phantom disconnections and “Socket is not initialized” errors caused by late socket events during reconnection.
- Smart Reconnection & Availability: Reconnection now uses exponential backoff + jitter. If the gateway goes offline, devices are marked unavailable in Homey and automatically restore as soon as the connection is back.
Thermostat & Device Behavior
- Thermostat Mode Flapping (O1): Fixed the bug where the thermostat mode would randomly flap or drop to “Off” and return.
- Heater/Cooler Auto Mode (O2): Corrected the payload for the
auto mode in HeaterCooler accessories.
- Multi-Button Switches (O7): Fixed physical key mapping (
ServiceLabelIndex) so that button numbers in Homey align perfectly with your physical switch labels.
Performance & Protocol Optimizations
- Subscription Filtering (O3): The app now strictly subscribes only to characteristics that have the
ev (event notification) permission. This resolves duplicate subscribe calls and common protocol status errors (like -70406 or -70402 write failures).
- Null-Guards (O4): Added safeguards during event dispatching to ensure a single malfunctioning device cannot lock the event queue for other working devices.
- Clean Shutdown (O6): Added proper uninitialization routines. All active HAP connections and sockets are clean-closed when the app restarts, avoiding socket leaks.
- No Native Bluetooth/Noble Dependency (H5): The app now loads via the IP-only HAP path. Native BLE bindings (
@abandonware/noble) are never loaded, preventing startup crashes.
Diagnostics
- Verbose Logging Toggle: Added a “Enable verbose HAP debug logging” toggle to the app settings page. By default, heavy diagnostic logs are muted to optimize CPU usage and keep the Homey Pro log stream clean.
Note: Existing devices will continue to work normally without re-pairing. To benefit from button label updates (O7) or event-filtered subscriptions (O3), simply remove and re-add the specific device.
Please let me know how it runs for you!
https://homey.app/en-gr/app/com.legrand.homekit.local/Legrand-with-HomeKit-Code/test/
