tado° smart home integration, free and open source
Unofficial connector: tado° thermostats, hot water, home presence, open windows, scenes and widgets.
Published by LM1LC3N7
- Devices
- Version 0.1.1
- Requires Gladys >=5.1.0
- ★ 0
Unofficial connector, not affiliated with tado. It brings your tado° heating into Gladys: the thermostats and radiator valves of the V3+, V3 and V2 generations, hot water, air conditioning, and the rooms of tado X. tado is a trademark of tado GmbH.
What you get
| Surface | Content |
|---|---|
| One device per home | at home (presence sensor), presence mode (automatic / home / away), outside temperature, solar intensity, weather |
| One device per heating zone | setpoint, mode (off / manual / schedule), heating state and heating power, temperature, humidity, open window detected, low battery |
| One device per hot water zone | on/off, mode, setpoint when the system supports it |
| One device per air conditioning zone | on/off, mode (auto, cool, heat, dry, fan), setpoint, temperature, humidity |
| Optional: one device per phone with geofencing | at home / away |
| Scene triggers | presence changed, open window detected, zone started / stopped heating, low battery |
| Scene actions | set a temperature (until the next block, for a duration, or until changed), back to the schedule, set the presence, read a zone |
| Dashboard widgets | tado° home (presence, outside, every zone, Home / Away / Auto buttons) and tado° zone (temperature, humidity, setpoint, heating gauge, mode, +/− 0.5 °C, schedule, off) |
Setup
- Install the integration and open its Configuration screen.
- Click Link my tado° account: a tado sign-in page opens in a new tab. Sign in and approve the access. No password is stored in Gladys: tado gives the integration a session that it renews by itself.
- Back in Gladys, the status turns green within a few seconds and the homes and zones appear in Discovery: add the devices you want.
- Put the widgets on a dashboard, pick the home or the zone.
The session stays valid as long as the integration runs at least once a month. After a long stop, the status asks you to link the account again.
Setpoints
A setpoint sent from Gladys (the thermostat widget, a scene, the zone widget) is a manual setting in tado, like one made on the device. The option A manual setpoint lasts decides when it ends: at the next block of the tado schedule (default), after a fixed duration, or when it is changed again. The scene action set a temperature can override it per scene.
Setting the mode to Schedule ends the manual setting (tado resumes its program); Off turns the zone off (frost protection stays on tado's side).
Scenes
- Presence changed: the home went Home → Away or Away → Home, by geofencing or by a manual change. Lower the lights, arm the alarm.
- Open window detected: tado paused the heating of a zone because a window is open. Send a notification.
- Zone started / stopped heating: the heating power went above zero or back to zero. Switch a pump, count the heating hours.
- Low battery: a thermostat or valve of the zone reports a low battery.
The actions set a temperature and back to the schedule return the
zone's values; read a zone gives them for a condition that follows
({{temperature}}, {{heating}}, {{open_window}}...).
Privacy
The integration talks only to tado's servers (login.tado.com,
my.tado.com, hops.tado.com). The phone presence sensors are off by
default: they expose where the household members are.
Troubleshooting
- "tado° refused the saved session": the session expired (30 days without use) or was revoked in the tado app. Click Link my tado° account again.
- The status says "waiting for your approval": finish the sign-in in the tab that opened; the link is valid 5 minutes.
- Values move slowly: tado is read every 2 minutes by default (option Refresh interval). A command refreshes its home right away.
- A hot water zone has no setpoint: your installation only supports on/off (tado reports it).
- tado X: built from the public documentation of the hops API without the hardware; please report what does not match in the forum thread.
Configuration settings
These are the settings tado° asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| tado° account | section | No | Unofficial connector, not affiliated with tado. Click "Link my tado° account": a tado sign-in page opens, approve the access, and the integration discovers your homes and zones (V3+, V3, V2 thermostats and valves, hot water, air conditioning, and tado X rooms). The link stays valid as long as the integration runs at least once a month; otherwise link the account again. tado is a trademark of tado GmbH. |
| Link my tado° account | account_link | No | Opens the tado sign-in page in a new tab. Come back here once approved: the status below turns green within a few seconds. |
| Options | section | No | How a manual setpoint sent from Gladys ends, and how often tado is read. tado answers every home from the cloud: reading faster than every minute brings nothing. |
| A manual setpoint lasts | select | No | |
| Fixed duration (minutes) | number | No | |
| Refresh interval (s) | number | No | |
| One presence sensor per phone with geofencing | boolean | No | Creates a device per phone whose tado geofencing is on, with an "at home" sensor. Off by default: it is personal location data. |
How to install tado° in Gladys
- In Gladys, open Integrations: tado° appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/lm1lc3n7/gladys-tado:0.1.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/LM1LC3N7/gladys-tado.
tado° requires Gladys >=5.1.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
tado° 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 LM1LC3N7, not by the Gladys core team.
- Browse all external integrations
- Discover the native integrations built into Gladys
- Build and publish your own external integration
- Source code on GitHub — source of this documentation