
Hi everyone ![]()
I just published a new external integration to control your shutters/windows
io-homecontrol® (Velux, Somfy compatible io-homecontrol…) via a KLF200 gateway,
directly from Gladys.
100 % local: the integration talks directly to the KLF200 on your local network (proprietary TLS API of the gateway). No cloud, no account to create, no data leaving your home.
What it does
- Automatic discovery of all shutters already paired with your KLF200 (via the Velux app or
the gateway interface) — no need to re-enter everything manually. - Two features per shutter, both controllable from Gladys:
- Position: 0–100 % slider.
- State: open / stop / closed button.
- Polling every 60 seconds: a movement made outside of Gladys (physical remote
control, Velux app) automatically updates in Gladys in less than a minute. - Automatic reconnection (retry 30 s): the KLF200 only accepts one session at a time and
can be slow to release one — the integration handles this automatically, without intervention.
Important: the KLF200 only accepts one connection at a time
This is a hardware limitation of the Velux gateway, not a bug in the integration: the KLF200 only accepts one active API session at a given time, and can be slow to release one when it ends poorly (a few tens of seconds, sometimes more).
In practice, if another client is already using this session at the same time (Velux app open, another script, another home automation integration…), an attempt to connect from Gladys can be temporarily refused. No worries: the integration detects the failure and automatically retries every 30 seconds, without any action from you — it will always reconnect as soon as the gateway is available.
If you’re running another tool that continuously talks to the KLF200 (e.g. a homemade MQTT bridge), avoid leaving it permanently connected in parallel with Gladys: the two would fight over the same session.
Installation
In Gladys: Integrations → Install from GitHub, with the repo URL:
https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol
Or wait for the integration to arrive on the store ![]()
You just need to enter the IP and password of your KLF200 gateway in the Configuration tab, then start a discovery. ![]()
Repo & source code
100 % open-source integration, based on the official SDK @gladysassistant/integration-sdk and on
the lib klf-200-api. CI (lint + tests) and multi-arch build
(amd64/arm64) automated via GitHub Actions.
Feel free to share feedback, report bugs, or suggest improvements — issues and PRs are welcome! ![]()