Jinja2 Templates in Home Assistant

Grundstruktur

Ein Template-Sensor benötigt mindestens zwei Attribute: den state-Wert (das Jinja2-Template, das den Sensorwert berechnet) und optional unit_of_measurementfür die Einheit. Das Template wird in geschweiften Klammern mit Prozentzeichen geschrieben: {{ }}. Du kannst auf jeden Zustand im System zugreifen, indem dustates('sensor.aussentemperatur') verwendest.

Praktisches Beispiel: Taupunkt berechnen

Der Taupunkt ist die Temperatur, bei der Luftfeuchtigkeit kondensiert — wichtig für Schimmelprävention. Du hast einen Temperatur- und einen Feuchtigkeitssensor, aber keinen Taupunkt-Sensor. Mit einem Template-Sensor berechnest du den Taupunkt nach der Magnus-Formel: Du liest Temperatur und Luftfeuchte, wendest die Formel im Template an und erhältst einen neuen Sensor sensor.taupunkt_badezimmer, den du wie jeden anderen Sensor verwenden kannst — in Dashboards, Automatisierungen und Benachrichtigungen.

Praktisches Beispiel: Stromkosten berechnen

Wenn du einen Stromzähler-Sensor hast, der den Verbrauch in kWh anzeigt, und deinen Strompreis kennst (z.B. 0,32 Euro/kWh), erstellst du einen Template-Sensor, der die laufenden Kosten in Euro berechnet. Das Template multipliziert den Zählerwert mit dem Preis und rundet auf zwei Nachkommastellen. So siehst du im Dashboard direkt, was dein Smart Home an Strom kostet — nicht nur, wie viel es verbraucht.

float und int — Sichere Typumwandlung

Home Assistant speichert alle Zustände als Strings. Wenn du mit einem Sensorwert rechnest, musst du ihn zuerst in eine Zahl umwandeln.| floatwandelt in eine Kommazahl um, | intin eine Ganzzahl. Der Clou: Du kannst einen Fallback-Wert übergeben — | float(0)liefert 0, wenn der Sensorwert nicht umgewandelt werden kann (z.B. weil der Sensor "unavailable" meldet). Ohne Fallback würde das Template fehlschlagen und die gesamte Automatisierung stoppen.

round — Dezimalstellen kontrollieren

Sensoren liefern oft mehr Nachkommastellen als nötig.| round(1)rundet auf eine Nachkommastelle, | round(0)auf eine ganze Zahl. Das ist sinnvoll, wenn der Wert im Dashboard angezeigt wird oder als Trigger-Schwelle dient — niemand braucht 21.437291 Grad als Sollwert.

Weitere nützliche Filter

• default('Wert'): Liefert einen Standardwert, wenn der Ausdruck undefined oder none ist. Ideal als Sicherheitsnetz.
• string: Wandelt einen Zahlenwert explizit in einen String um.
• trim: Entfernt führende und abschließende Leerzeichen.
• replace('alt', 'neu'): Ersetzt Zeichenfolgen innerhalb eines Strings.
• regex_replace: Ersetzt mit regulären Ausdrücken — mächtig, aber komplexer.
• multiply(X): Multipliziert den Wert mit X — praktisch für Einheitenumrechnungen.

Beispiel: Schimmelgefahr erkannt

Schimmel entsteht, wenn die relative Luftfeuchtigkeit lange Zeit über 65 % liegt UND die Raumtemperatur unter dem Taupunkt liegt. Du definierst einen Template Binary Sensor, der "on" wird, wenn beide Bedingungen gleichzeitig erfüllt sind. Dieser Sensor kann dann eine Benachrichtigung auslösen ("Lüften!") oder automatisch die Lüftungsanlage aktivieren. Die Logik wäre: Wenn Luftfeuchtigkeit größer als 65 % UND Taupunkt größer als Raumtemperatur minus 3 Grad, dann Schimmelgefahr.

Beispiel: Jemand ist nachts unterwegs

Du kombinierst einen Bewegungsmelder, die Uhrzeit und den Anwesenheitsstatus: Wenn der Bewegungsmelder aktiv ist UND es zwischen 23:00 und 06:00 Uhr ist UND jemand zu Hause ist, dann ist jemand nachts unterwegs. Das kann genutzt werden, um automatisch ein Nachtlicht mit Dimmstufe zu aktivieren oder eine Benachrichtigung zu senden, wenn niemand zu Hause sein sollte (mögliche Einbruch-Situation).

Beispiel: Energiepreis unter Schwellenwert

Du hast einen dynamischen Energiepreis-Sensor und willst die Waschmaschine starten, wenn der Preis unter 0,25 Euro/kWh fällt. Ein Template-Trigger prüft den Preis und löst die Automatisierung aus, wenn der Schwellenwert unterschritten wird. So nutzt du günstige Strompreisspitzen automatisch — ohne manuell den Preis zu beobachten.

Beispiel: Komfort-Schwelle überschritten

Du berechnest einen Komfort-Index aus Temperatur, Luftfeuchtigkeit und CO2-Gehalt. Wenn der Index einen bestimmten Wert unterschreitet, wird ein Template-Trigger aktiv und startet automatisch die Lüftung. Der Clou: Die Automatisierung reagiert auf einen berechneten Wert, nicht auf einzelne Sensoren — die Logik steckt im Template, nicht in der Automation.

Sonnenstand-basierte Beschattung

Verwende den Sun-Sensor, um zu berechnen, ob die Sonne durch ein bestimmtes Fenster scheint. Du kombinierst die Elevation (Höhenwinkel) mit dem Azimuth (Seitwinkel) und den Fensterorientierung deines Hauses. Wenn die Elevation über 20 Grad und der Azimut im Bereich des Südfensters liegt, wird die Jalousie automatisch heruntergefahren. So vermeidest du unnötige Aufheizung im Sommer.

Batterieladezustand überwachen

Ein Template-Sensor, der alle Batteriesensoren durchläuft und die Anzahl der Geräte mit unter 20 % Ladung zählt. Das nutzt die states-Funktion, um alle Entitäten eines bestimmten Musters zu durchsuchen, und selectattr, um nur diejenigen zu filtern, deren Wert unter dem Schwellenwert liegt. Das Ergebnis ist eine einzelne Zahl, die im Dashboard angezeigt oder als Trigger für eine Benachrichtigung genutzt werden kann.

Zeitdifferenz berechnen

Wie lange ist das Fenster schon offen? Mit state_attr und dem Attribut "last_changed" berechnest du die Zeitdifferenz zum aktuellen Zeitpunkt. Das Template liefert die Dauer in Minuten, die du in einer Automatisierung verwendest: "Wenn Fenster länger als 30 Minuten offen, sende Erinnerung."