Skip to content
Homebridge TestFlight
Somfy

Somfy TaHoma Local

homebridge-somfy-tahoma · v1.0.1

VerifiedLocalHomebridge 2.0

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
DeviceStatusWhat they saidSource
Somfy garage door via TaHomaNot workingOpens but cannot close; open status not reported
Saved copy
Describe 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 workingCannot open or close partially from HomeKit
Saved 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 workingCannot set partial position; TaHoma discrete mode not respected
Saved 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 awningRequestedAwning is on the exclusion list; user wants it recognized
Saved copy
My 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 HomebridgeYes
Homebridge versions^1.8.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^20.18.0 || ^22.10.0 || ^24.0.0
Settings in Homebridge UIYes
MatterNo
Platform nameSomfyTaHoma
LicenseApache-2.0

Community signals

Downloads a week10
Downloads a month65
GitHub stars3
Open issues4
Closed issues0
Last code push2026-05-08
Latest version1.0.1 (2026-03-30)
First published2026-03-29
Releases4

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