Somfy TaHoma Local
homebridge-somfy-tahoma · v1.0.1
Adds Somfy TaHoma IO roller shutters and garage doors to HomeKit via the gateway's local API.
What it says it supports
Brands
- Somfy
Devices it names
- TaHoma gateway
- IO/HomeControl roller shutters
- IO/HomeControl garage doors
Shows up in Apple Home as from its README
What people report
Recent reports say shutters and garage doors via TaHoma have problems: no partial open/close, garage doors can't close, awnings excluded. All open.
- Not working3
- Requested1
| Device | Status | What they said | Source |
|---|---|---|---|
| Somfy garage door via TaHoma | Not working | Opens but cannot close; open status not reportedSaved copyDescribe The Bug: Commands and status are not being transmitted correctly To Reproduce: When I operate the garage doors, they open but I can’t close them. The status isn’t being transmitted when the door is open. For the roller shutters, it isn’t possible to set them to open partially. Expected behavior: Logs: Il n'y a rien dans les logs [code] Plugin Config: [code] { "platform": "SomfyTaHoma", "name": "Somfy TaHoma", "ip": "192.168.1.95", "token": "token of the box", "pollIntervalSeconds": 2, "ignoredDeviceUrls": [], "_bridge": { "username": "Mac adress", "port": 32631, "name": "Somfy … Excerpt saved from GitHub on 2026-10-22. | Issue #2 · 2026-04 |
| Somfy io roller shutter (io:RollerShutterGenericIOComponent) | Not working | Cannot open or close partially from HomeKitSaved copy@nikkow Describe The Bug: It is not possible to open / close the blinds / shutters partially. To Reproduce: Open / close exposed blinds / shutters partially within HomeKit, like 50%. Model1: io: RollerShutterVeluxIOComponent Model2: io:RollerShutterGenericIOComponent Both do not work. Expected behavior: Open / close exposed blinds / shutters partially within HomeKit. Logs: I do not have logs and do not know how to activate them for the child bridge. Plugin Config: { "platform": "SomfyTaHoma", "name": "Somfy TaHoma", "ip": "xxx", "token": "xxx", "pollIntervalSeconds": 1, "ignoredDeviceUrls": … Excerpt saved from GitHub on 2026-10-22. | Issue #4 · 2026-05 |
| Velux io roller shutter (io:RollerShutterVeluxIOComponent) | Not working | Cannot set partial position; TaHoma discrete mode not respectedSaved copy@nikkow Describe The Bug: It is not possible to open / close the blinds / shutters partially. To Reproduce: Open / close exposed blinds / shutters partially within HomeKit, like 50%. Model1: io: RollerShutterVeluxIOComponent Model2: io:RollerShutterGenericIOComponent Both do not work. Expected behavior: Open / close exposed blinds / shutters partially within HomeKit. Logs: I do not have logs and do not know how to activate them for the child bridge. Plugin Config: { "platform": "SomfyTaHoma", "name": "Somfy TaHoma", "ip": "xxx", "token": "xxx", "pollIntervalSeconds": 1, "ignoredDeviceUrls": … Excerpt saved from GitHub on 2026-10-22. | Issue #4 · 2026-05 |
| Somfy RTS awning | Requested | Awning is on the exclusion list; user wants it recognizedSaved copyMy Somfy RTS awning is on the exclusion list. It's the only Somfy device I want to control. Is there a way to get the plugin to recognize my awning? Excerpt saved from GitHub on 2026-10-22. | Issue #6 · 2026-08 |
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
TaHoma local API (Developer Mode)
You’ll need
- TaHoma gateway with Developer Mode
- TaHoma developer token
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20.18.0 || ^22.10.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | SomfyTaHoma |
| License | Apache-2.0 |
Community signals
| Downloads a week | 10 |
|---|---|
| Downloads a month | 65 |
| GitHub stars | 3 |
| Open issues | 4 |
| Closed issues | 0 |
| Last code push | 2026-05-08 |
| Latest version | 1.0.1 (2026-03-30) |
| First published | 2026-03-29 |
| Releases | 4 |
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.
Caveats from the README
- Other device families not supported yet
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- GarageDoorOpener
- WindowCovering
Sources
- npm: https://www.npmjs.com/package/homebridge-somfy-tahoma
- Source code: https://github.com/nikkow/homebridge-somfy-tahoma
- Issues: https://github.com/nikkow/homebridge-somfy-tahoma/issues
- Verified plugins list: https://github.com/homebridge/verified





