Skip to main content

Overkiz integration for Gladys Assistant

Overkiz integration for Gladys Assistant

Control your Overkiz devices (Somfy TaHoma, Connexoon, Cozytouch...).

View on GitHubAll external integrations

Control your Overkiz-based devices from Gladys Assistant: Somfy TaHoma, TaHoma Switch, Connexoon, Atlantic Cozytouch, Rexel Energeasy Connect, Hitachi Hi Kumo and Bouygues Flexom hubs are supported through the Overkiz cloud API.

What it does​

  • Covers: roller shutters, awnings, screens, venetian blinds, curtains, pergolas, garage doors, gates and windows — open, close, stop and set the position.
  • Lights: on/off and brightness.
  • Switches and plugs: on/off.
  • Sensors: temperature, humidity, luminance, contact (opening), occupancy (motion), smoke, water leak, CO2, electric power/energy and battery level.

Device states are refreshed in near real time through the Overkiz event API, so a shutter moved from a physical remote is reflected in Gladys within seconds.

Not supported yet​

  • Heating and domestic hot water: radiators, underfloor heating, water heaters and heat pumps (HeatingSystem, WaterHeatingSystem) are not mapped to Gladys devices yet. Atlantic Cozytouch, Thermor, Sauter and Hitachi Hi Kumo hubs do connect, but most of their devices will not show up in discovery yet.
  • Locks, alarms and ventilation (DoorLock, Alarm, AirFlow).
  • On metering plugs and modules, Overkiz often publishes the power reading on a separate sub-device: it then appears as its own device in discovery, carrying the same name as its parent.

Prerequisites​

  • An Overkiz-based hub (Somfy TaHoma, TaHoma Switch, Connexoon, Cozytouch...) already set up with the vendor's app.
  • The email and password of your vendor account (the same credentials you use in the TaHoma / Cozytouch app).

Configuration​

  1. Install the integration from the Gladys store.
  2. Open the Configuration tab.
  3. Pick the Server matching your hub (Somfy Europe for TaHoma / TaHoma Switch / Connexoon in Europe).
  4. Enter your account email and password, then save.
  5. Use the Test the connection button to verify the credentials.
  6. Open the Discovery tab, run a scan, and create the devices you want in Gladys.

Troubleshooting​

  • Connection failed: double-check the server selection and your credentials by logging into the vendor's app. Somfy may temporarily lock the account after too many failed attempts.
  • A device is missing: only device types listed above are supported. Run a new scan from the Discovery tab after adding a device to your hub.
  • States seem stale: the event polling period can be lowered in the Configuration tab (10 s minimum). Keep in mind the Overkiz cloud rate-limits aggressive polling.

Configuration settings​

These are the settings Overkiz asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Overkiz accountsectionNoConnect with the credentials of your Overkiz-based hub. Pick the server matching your hub, then enter the email and password of your provider account. Covers, lights, switches and sensors are supported; heating and hot water devices are not mapped yet.
Server (hub type)selectYes
Email / usernamestringYes
PasswordsecretYes
Event polling period (s)numberNoHow often events are fetched from the Overkiz cloud, in seconds.

How to install Overkiz in Gladys​

  1. In Gladys, open Integrations: Overkiz appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/cicoub13/gladys-overkiz:1.1.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/cicoub13/gladys-overkiz.

Overkiz requires Gladys >=4.84.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Overkiz is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by cicoub13, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on