tado° Smart-Home-Integration, kostenlos und Open Source

Unofficial connector: tado° thermostats, hot water, home presence, open windows, scenes and widgets.
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
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.
Konfigurationseinstellungen
Diese Einstellungen fragt tado° in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| tado° account | section | Nein | 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 | Nein | 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 | Nein | 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 | Nein | |
| Fixed duration (minutes) | number | Nein | |
| Refresh interval (s) | number | Nein | |
| One presence sensor per phone with geofencing | boolean | Nein | Creates a device per phone whose tado geofencing is on, with an "at home" sensor. Off by default: it is personal location data. |
So installierst du tado° in Gladys
- Öffne in Gladys Integrationen: tado° erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-tado:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-tado.
tado° benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
tado° ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation