miakapp

Guide · Velux

Control your Velux without the official hub.

Your Velux roof windows driven directly by radio, from your phone and in your automations, with a €25 board instead of a hub. Real position and rain sensor included.

The problem

Motorised Velux INTEGRA roof windows come with a remote. To control them from a phone, Velux sells a box: today the VELUX App Control KIG 300, around €100 to €120 19, which goes through Velux and Netatmo’s cloud, except locally through Apple HomeKit 1, where users report it does not accept a “stop” command 23.

The older KLF 200 gateway, the only one with a local API, is no longer made 5; it resells for around €200 to €260 22. Its replacement, the KLF 150, only has dry contacts and no API 6.

The protocol has been opened

Velux INTEGRA products speak io-homecontrol: an 868 MHz, two-way radio, encrypted with a key unique to each installation 23. Recording the signal and replaying it does not work: the motor sends a challenge only devices holding the key can answer 3.

Enthusiasts documented the protocol 3, and a recent open project, home_io_control, implements it on an ESP32 board with an 868 MHz radio 8. The board talks to the windows directly: open, close, stop, position from 0 to 100% with real feedback, ventilation position and rain sensor 8913. Its device list marks the INTEGRA roof window as confirmed 9.

That leaves the key. The project does not break it: it poses as a new product, and your own Velux keypad (KLR 200 or KLR 300), or a KLF 200, hands it over through its “add a product” menu, the way Velux intends for its accessories 10.

Three ways to do it

An ESP32 on a Velux wall switch

If you only have one-way switches: simple, but no state feedback.

An installation with only KLI 31x switches cannot hand over its key, and the radio route is still experimental there 15. You then buy one more KLI switch, paired with your windows, and an ESP32 relay board “presses” its buttons 1718.

A button reports nothing: position is estimated from travel time, and one tinkerer driving five blinds this way sends every command twice because a blind sometimes misses it 18. You need to solder onto small pads.

HardwareTypical price
VELUX KLI 311 wall switch 20≈ €38
LilyGO T-Relay board (ESP32, 4 relays) 21≈ €15
Power supply, wires≈ €10
Total≈ €50 to €70

If you already own a KLF 200

Keep it: its local API is proven, and it can also hand its key to the radio.

Since firmware 2.0.0.71 the KLF 200 has a local network API; the agent drives it with an existing library, klf-200-api for Node.js or pyvlx for Python 57.

Known limits: two simultaneous connections at most, firmware that cannot be downgraded, rain state read every five minutes 14.

HardwareTypical price
VELUX KLF 200, already installed—
Total€0

Prices checked in November 2026 at European retailers; they vary by country and over time.

What you can ask next

Close every roof window if rain is forecast within the hour or the wind goes over 40 km/h, and tell me which ones were open.

Air the bedroom for ten minutes at 7 am if CO₂ went over 1,200 ppm during the night, unless it is below 5 °C outside.

When it is over 26 °C under the roof and cooler outside in the evening, put the windows in their ventilation position until midnight.

What the agent does

  • It looks at what you already have (KLR keypad, KLI switches, KLF 200) and picks the route with you.
  • Radio route: it writes the ESPHome configuration, flashes the board, walks you through the key handover on the keypad, stores the key as a secret rather than in the code, then tests each window one by one.
  • It connects the board to the coordinator locally, adds a control per window and an “everything closed” button to the app, and wires the automations to the weather, rain and your sensors.
  • It follows the project’s releases and updates the board when a fix concerns your models.

Before you start

  • This is a young community project, provided without warranty, confirmed by a handful of users for INTEGRA windows 81314.
  • Holding a motor’s PROG button too long can unpair it from your remote, and right after a power cut, reset it 11.
  • Your installation key shows in clear text in the board’s log: never publish it, for example in a GitHub issue 15.
  • Some boards with an amplifier exceed the legal 868 MHz radio power unless you keep the low-power setting provided 12.
  • Velux products from before io-homecontrol, with a WLR 100 infrared remote, are even simpler: a small ESP board and an infrared LED are enough 24.

Sources

  1. Home Assistant — Velux integration
  2. VELUX — KLI 310/311/312 wall switches (io-homecontrol, 868 MHz)
  3. iown-homecontrol — open documentation of the io-homecontrol protocol
  4. openHAB — Velux binding (KLF 200 limits)
  5. pyvlx — Python library for the KLF 200 (“discontinued by Velux”)
  6. VELUX — KLF 150 interface
  7. klf-200-api — Node.js library for the KLF 200
  8. home_io_control — ESPHome component speaking io-homecontrol
  9. home_io_control — supported devices
  10. home_io_control — recovering the installation key from a keypad
  11. home_io_control — pairing and the PROG button
  12. home_io_control — supported boards and radio power
  13. home_io_control — issue #98, INTEGRA windows working, rain sensor
  14. home_io_control — issue #87, per-model fixes
  15. home_io_control — FAQ (one-way installations, key in the log)
  16. Hexaspot — Heltec WiFi LoRa 32 V3 (price)
  17. velux_applehome_esp32 — ESP32 relays on KLI 311/312 switches
  18. Velux on HomeKit through a Zigbee relay soldered to a KLI switch
  19. Hornbach — VELUX App Control KIG 300 (price)
  20. Servistores — VELUX KLI 311 switch (price)
  21. TinyTronics — LilyGO T-Relay ESP32 board (price)
  22. baubay — VELUX KLF 200 (price)
  23. Home Assistant community — KIG 300 over HomeKit, no stop command
  24. Home Assistant community — older Velux with WLR 100 infrared remotes driven by ESPHome

Prices and projects checked in November 2026.

Hand it to your agent

Create the home, connect your agent and give it this guide as a starting point.