Smart Ventilation

Adaptive Lüftungsempfehlung für Home Assistant – pro Raum. Die Integration vergleicht absolute Feuchte innen und außen, berücksichtigt Wind, Windrichtung zum Fenster, Regen, Temperatur und Sonnenstand und lernt aus jeder echten Lüftung, wie schnell dein Raum tatsächlich Feuchte abgibt.

Funktionen

Kern-Empfehlung

• Adaptive Lüftungsempfehlung pro Raum: vergleicht absolute Feuchte innen/außen, berücksichtigt Wind, Windrichtung zum Fenster, Regen, Temperatur und Sonnenstand
• Lernender Luftwechsel (getrennt nach Wind, Windwinkel und Temperaturdifferenz) – lernt aus jeder echten Lüftung, wie schnell der Raum tatsächlich Feuchte abgibt
• Live-Fortschritt während des Lüftens, Meldung sobald das Ziel erreicht ist
• Empfehlung mit Dauer und Modus (Komplett öffnen / Kippfenster / Querlüften bei mehreren Fenstern)
• Tagesziel absolute Feuchte – mit Raumtyp-Vorschlag beim Einrichten (Schlafzimmer, Bad, Wohnzimmer/Büro, Küche, Sonstige), jederzeit manuell überschreibbar
• Feuchte-Hysterese gegen Flackern der Empfehlung, mit änderbarem Vorgabewert

Sommer, Winter & Vorheizen

• Sommer-/Wintermodus manuell oder automatisch: Automatik legt Dezember–Februar/Juni–August fest, entscheidet in den Übergangsmonaten per Außentemperatur – und wechselt erst nach mehreren Stunden anhaltendem Trend, damit sie nicht flackert
• Wärme-Sperre: kein Lüften, wenn es draußen deutlich wärmer ist als drinnen (ganzjährig)
• Sommer: Kühlen per Lüften (Komforttemperatur einstellbar) inkl. Kühl-Zeitfenster aus der Wettervorhersage
• Vorheizen: nach einer Nacht unter der Heizgrenze darf tagsüber trotz wärmerer Außenluft gelüftet werden, um Heizkosten zu sparen – inkl. Regen-Vorschau und Vorschau, ab wann es warm genug wird

Gesundheit & Luftqualität

• Relative Feuchte, Taupunkt und Schimmelrisiko-Einschätzung an der kältesten Wandstelle (DIN 4108-2, mehrere Dämmstandards wählbar)
• Schimmel-Frühwarnung bei mehreren kritischen Tagen in Folge
• Optional CO₂-Sensor: Luftqualität gut/mäßig/schlecht, eigene CO₂-Lüftungsempfehlung

Automatisierung & Komfort

• Bester Lüftungszeitpunkt aus der stündlichen Wettervorhersage (nächste 24 h)
• Gekoppelte Heizung wird bei offenem Fenster automatisch abgesenkt und danach wiederhergestellt
• Auskühl-Warnung, wenn der Raum bei offenem Fenster zu kalt wird
• Bad-Modus nach dem Duschen (Sensor oder automatische Erkennung über Feuchtesprung) mit Nachfass-Erinnerung
• Urlaubsmodus: normale Erinnerungen aus, Schimmelrisiko bleibt überwacht
• Luftentfeuchter-Steuerung nach relativer Feuchte
• Rollo/Jalousie-Empfehlung (Karte + Push) bei direkter Sommersonne am Fenster, optional automatisch gesteuert
• Warnung bei offenem Fenster, wenn niemand zu Hause ist

Statistik & Kosten

• Lüftungsstatistik heute/Woche/Monat/gesamt, ganz ohne eigene Helfer oder Automationen
• Geschätzter Wärmeverlust (kWh) und Kosten (€) je Lüftung und Monat
• Monats-/Jahresvergleich des Lüftungsbedarfs mit Vormonats-/Vorjahreswerten
• Wochenbericht per Push

Bedienung

• Push-Benachrichtigungen mit Cooldown, Ruhezeiten und Snooze-/Überspringen-Aktionen direkt in der Nachricht
• Übersicht aller Räume mit Sammel-Benachrichtigung statt einer pro Raum
• Eigene Dashboard-Karte (wird automatisch mitinstalliert) mit Verlaufskurve, Status-Kacheln und Fortschrittsanzeige
• Sprachsteuerung über Assist („Muss ich lüften?“, „Wo soll ich lüften?“) sowie ein Dienst für eigene Automationen
• Reparatur-Hinweise bei ausgefallenen Sensoren
• Alle Einstellungen nachträglich änderbar, ohne Lerndaten zu verlieren
• Deutsch und Englisch

Sprachsteuerung

Nach der Installation einmal Home Assistant neu starten. Dann versteht Assist u. a.:

• „Muss ich lüften?“
• „Wo soll ich lüften?“
• „Wie ist die Lüftungsempfehlung?“

Die Sätze liegen in /config/custom_sentences/de/smart_ventilation.yaml und können dort ergänzt werden (die Datei wird nie überschrieben). Für Automationen gibt es den Dienst smart_ventilation.status, der den gleichen Text zurückgibt.

Entitäten (Beispiel Raum „Wohnzimmer“)

Entität	Bedeutung
binary_sensor.wohnzimmer_luften_empfohlen	Jetzt lüften? Attribute: modus, dauer_min
binary_sensor.wohnzimmer_heute_geluftet	Tagesziel erreicht
sensor.wohnzimmer_luftungen_heute / _woche / _monat / _gesamt	Anzahl; Attribute erfolgreich, ohne_ziel, dauer_gesamt_min, dauer_durchschnitt_min
sensor.wohnzimmer_aktuelle_luftungsdauer	Sekunden seit Öffnen
sensor.wohnzimmer_langste_luftung	Rekord in Minuten
sensor.wohnzimmer_empfehlung	Klartext-Empfehlung
sensor.wohnzimmer_bester_luftungszeitpunkt	Zeitstempel der besten Stunde (nächste 24 h); Attribut text z. B. „Heute 14:00 Uhr“
sensor.wohnzimmer_jahreszeit_modus	Sommer / Winter
binary_sensor.wohnzimmer_raum_kuhlt_aus	Fenster offen und Raum unter der Auskühl-Grenze
binary_sensor.wohnzimmer_ruhezeit	Ruhezeit aktiv (keine Erinnerungen)
button.wohnzimmer_lernen_zurucksetzen	Gelernten Luftwechsel verwerfen (Statistik bleibt)
sensor.wohnzimmer_wandtemperatur_geschatzt	Temperatur an der kältesten Wandstelle
sensor.wohnzimmer_feuchte_an_der_wand	Relative Feuchte dort – ab 80 % Schimmelgefahr
sensor.wohnzimmer_luftqualitat	gut / mäßig / schlecht (nur mit CO₂-Sensor)
sensor.wohnzimmer_warmeverlust_luften_heute	Geschätzter Wärmeverlust durchs Lüften (kWh)
sensor.wohnzimmer_luftungskosten_monat	Geschätzte Kosten im Monat (€)
sensor.wohnzimmer_kritische_schimmeltage_in_folge	Tage in Folge mit ≥ 6 h Wandfeuchte über 80 %
binary_sensor.wohnzimmer_schimmelgefahr	An ab 3 kritischen Tagen in Folge
sensor.wohnzimmer_luftungsbedarf_diesen_monat	Stunden mit Lüftungsbedarf; Attribut letzter_monat mit Vormonats-/Vorjahresvergleich
sensor.luften_ubersicht_dringendster_raum	Übersicht: Raum mit dem größten Bedarf, Attribut raeume

Eine Lüftung zählt ab 30 Sekunden. Erfolgreich ist sie, wenn sie mindestens 2 Minuten dauerte und das Ziel erreicht wurde (Feuchteunterschied ≤ 0,5 g/m³ oder innen ≤ Tagesziel, Standard 11,5 g/m³).

Installation über HACS

1. HACS öffnen → oben rechts ⋮ → Benutzerdefinierte Repositories
2. URL https://github.com/patrickbrundiers-dev/smart_ventilation eintragen, Typ Integration, hinzufügen
3. Smart Ventilation suchen → Herunterladen
4. Home Assistant neu starten
5. Einstellungen → Geräte & Dienste → Integration hinzufügen → Smart Ventilation
6. Raum hinzufügen wählen und die ersten drei Bereiche ausfüllen (Raum & Fenster, Sensoren im Raum, Außen & Wetter). Die übrigen Bereiche sind zugeklappt und haben sinnvolle Standardwerte.

Für jeden Raum einen eigenen Eintrag anlegen. Optional zusätzlich einmal Übersicht aller Räume – dann gibt es eine gemeinsame Nachricht statt einer pro Raum.

Einstellungen später ändern: Gerät öffnen → Konfigurieren → Bereich aufklappen → einmal speichern. Gelernte Werte bleiben erhalten.

Dashboard-Karte

Die Karte wird mit der Integration installiert und automatisch nach /config/www/smart_ventilation/ kopiert und unter Einstellungen → Dashboards → Ressourcen eingetragen (ggf. einmal App/Browser neu laden).

type: custom:smart-ventilation-card
device: <Raum oder Übersicht im Editor auswählen>
show_details: true   # Kacheln Innen / Außen / Wand / CO₂
show_chart: true     # Verlauf der letzten Lüftung

Ein Tipp auf eine Kachel öffnet den Verlauf des jeweiligen Sensors, ein Tipp auf den Kopf die Empfehlung. Die Karte übernimmt Farben, Rundungen und Schrift deines Themes.

Im Dashboard-Editor unter Karte hinzufügen → Smart Ventilation findest du sie auch direkt. Sie zeigt Status, Fortschritt beim Lüften, Innen-/Außen-/Wandwerte, CO₂, besten Zeitpunkt, heutige Statistik und Warnungen. Mit dem Gerät der Übersicht zeigt sie alle Räume.

Manuelle Installation

Ordner custom_components/smart_ventilation nach /config/custom_components/ kopieren und neu starten.

Voraussetzungen

Pro Raum:

• Sensor absolute Feuchte innen und außen (g/m³)
• Optional: Sensor relative Feuchte innen und außen (%) – wird sonst aus absoluter Feuchte + Temperatur berechnet
• Temperatur innen und außen
• Windgeschwindigkeit (km/h oder m/s) und Windrichtung (°)
• Regensensor (Binärsensor oder mm/h)
• Fensterkontakt

Home Assistant 2024.11 oder neuer.

Tipps

• Sommer/Winter-Modus auf „Automatisch“ lassen – im Winter wird dann kurz stoßgelüftet statt blockiert.
• Sommer-Grenze (Standard 3 °C): Ist es draußen um mehr als diesen Wert wärmer, wird nicht gelüftet.
• Fensterausrichtung: Richtung, in die das Fenster zeigt (0 = Nord, 90 = Ost, 180 = Süd, 270 = West).

Die Schimmelrisiko-Einschätzung basiert nur auf der Raumluft und ersetzt keine bauphysikalische Bewertung von Wandoberflächen.

Changelog

Version 2.14.0

Übersichtskarte (alle Räume) erweitert, damit sich mehr auf einen Blick erkennen lässt, ohne erst jede Raumkarte einzeln zu öffnen:

• Sammel-Warnung direkt unter dem Titel, sobald irgendwo Aufmerksamkeit nötig ist, z. B. "2 Schimmelrisiko · 1× CO₂ hoch · 1× Rollo schließen".
• Symbole pro Raumzeile neben dem Namen: laufender Luftentfeuchter, empfohlenes (noch nicht geschlossenes) Rollo, und – neu – schlechte Luft (CO₂), zusätzlich zum bisherigen Schimmelrisiko-Symbol.

Keine Konfiguration nötig – die Übersicht nutzt vorhandene Werte, die bisher nur auf der jeweiligen Einzelraum-Karte sichtbar waren.

Version 2.13.2

Zwei weitere Fehlerbehebungen:

• Luftentfeuchter blieb dauerhaft hängen, wenn der Einschalt-Befehl das Gerät nie erreichte (oder jemand es von Hand wieder ausschaltete): Home Assistant ging dann fälschlich davon aus, das Gerät liefe noch, und hat es nie erneut versucht – ohne echten Betrieb sinkt ja weder die Feuchte noch verschwindet der Bedarf, wodurch auch die normale Ausschalt-Logik nie griff. Die Automatik erkennt diesen Widerspruch jetzt (Gerät meldet "aus", obwohl wir "an" annehmen) und versucht es beim nächsten Durchlauf erneut, statt für immer stumm zu bleiben.
• Die Sensoren „Lüftungskosten Monat" und „Vorheiz-Ersparnis Monat" verursachten auf aktuellen Home-Assistant-Versionen eine Fehlermeldung im Protokoll (unzulässige Kombination aus Geräteklasse „Währung" und einer state_class, die sich monatlich zurücksetzt). Behoben, ohne die Werte selbst zu verändern – nur die Langzeitstatistik dieser beiden Sensoren läuft dadurch nicht mehr mit (dafür gibt es ohnehin den Gesamt-Energiesensor fürs Energie-Dashboard).

Version 2.13.1

Fehlerbehebung: Version 2.13.0 brach auf aktuellen Home-Assistant-Versionen (ab 2026.9.4).

• Neuere Home Assistant Versionen werfen einen Fehler, wenn interne Sensor-Abfragen mit einer leeren Entität aufgerufen werden, statt einfach "kein Wert" zurückzugeben – betraf alle vier neuen optionalen Wettersensoren aus 2.13.0, sobald sie NICHT konfiguriert waren (also praktisch jede bestehende Installation) und führte dazu, dass die komplette Empfehlungsberechnung abstürzte.
• Unabhängig davon lehnen neuere Home-Assistant-Versionen die Kategorie des Party-Modus-Sensors ab, da er rein lesbar ist – auf die passende Kategorie umgestellt.

Version 2.13.0

Vier neue optionale Wettersensoren (z. B. von KachelmannWetter oder ähnlichen Integrationen), alle im Bereich "Außen":

• Globalstrahlung: Verfeinert die "Direkte Sonne am Fenster"-Erkennung (Rollo-Empfehlung, Lüftungsdauer-Kappung). Bisher rein geometrisch (Sonnenwinkel/-höhe) berechnet, ignorierte also bedeckten Himmel – ab jetzt zählt ein hinterlegter Globalstrahlungssensor unter ca. 120 W/m² trotz passender Geometrie nicht mehr als direkte Sonne.
• Gewitter erwartet: Blockiert das Lüften genau wie der bestehende Regensensor. Versteht sowohl Binär-Sensoren (an/aus) als auch Text-Enum-Sensoren (z. B. "Sicher"/"Möglich"/"Unwahrscheinlich") – alles außer eindeutig unbedenklichen Werten gilt vorsichtshalber als Risiko.
• Windböen-Vorhersage: Einmalige Warnung pro Lüftungsvorgang, wenn bei offenem Fenster Böen ab 50 km/h vorhergesagt werden – Kippfenster können dabei beschädigt werden oder aufschlagen.
• Frost erwartet: Einmalige Erinnerung pro Lüftungsvorgang, das Fenster nicht offen zu vergessen, wenn für die Nacht Frost angesagt ist.

Alle vier Felder sind optional und ändern ohne Konfiguration nichts am bisherigen Verhalten.

Version 2.12.1

• Neu: Sobald keine direkte Sonne mehr am Fenster anliegt, kommt jetzt auch beim Öffnen eine Push-Benachrichtigung – ohne hinterlegtes Rollo-Entity sofort als Bitte ("kann wieder geöffnet werden"), mit hinterlegter Entity erst als Bestätigung, sobald die Automatik es (nach der Mindestlaufzeit) tatsächlich wieder geöffnet hat.

Version 2.12.0

• Neu: Zur Rollo-Empfehlung aus 2.11.0 gibt es jetzt zusätzlich eine Push-Benachrichtigung (Kategorie "Warnung", wie die bestehende Auskühl-Warnung) – einmalig pro zusammenhängendem Sonnen-Expositionsfenster, nicht bei jedem Tick. Ohne hinterlegtes Rollo-Entity ist es eine Bitte, es zu schließen; mit hinterlegter Entity eine Bestätigung, dass es automatisch geschlossen wurde. Verschwindet die direkte Sonne und kommt später wieder (z. B. am nächsten Tag), wird erneut einmalig benachrichtigt.

Version 2.11.0

Neue optionale Rollo/Jalousie-Empfehlung bei direkter Sommersonne:

• Neu: Ein neuer Sensor-Wert "Rollo schließen empfohlen" (Karten-Chip) meldet sich im Sommer, sobald die Sonne laut Fensterausrichtung und Sonnenstand direkt aufs Fenster trifft – reiner Hitzeschutz. Im Winter erscheint die Empfehlung bewusst nie, da dort die Sonnenwärme durchs Fenster erwünscht ist (siehe Vorheizen).
• Neu: Optional lässt sich pro Raum eine Rollo/Jalousie-Entity (cover) hinterlegen. Ist eine gesetzt, wird sie bei direkter Sonne automatisch geschlossen und – frühestens nach 15 Minuten Mindestlaufzeit – wieder geöffnet, sobald keine direkte Sonne mehr anliegt. Ohne hinterlegte Entity bleibt es bei der reinen Kartenempfehlung.
• Wie beim Luftentfeuchter wird nur verwaltet, was die Integration selbst geschlossen hat – eine von Hand auf eine Zwischenposition gefahrene oder bereits geschlossene Jalousie wird nicht angefasst.

Version 2.10.1

• Bugfix: Der Luftentfeuchter sprang nicht an, wenn die Raumluft zwar zu feucht war (Zielwert/rel. Feuchte überschritten), die Außenluft aber gerade noch feuchter war als drinnen. Er war fälschlich an denselben Außenluft-Vergleich gekoppelt wie das Lüften – dabei braucht ein Entfeuchter keine trockenere Außenluft, er entzieht der Raumluft direkt Wasser. Genau in diesem Fall (Lüften blockiert, weil draußen nicht trockener) wird er jetzt am ehesten gebraucht und springt jetzt auch an.

Version 2.10.0

Optionale echte RH-Sensoren statt reiner Rückrechnung aus der absoluten Feuchte:

• Neu: In den Bereichen "Innen" und "Außen" kann jetzt zusätzlich ein optionaler %-Luftfeuchte-Sensor hinterlegt werden. Ist er gesetzt und liefert einen Wert, wird er direkt für die relative Feuchte verwendet – statt sie wie bisher ausschließlich aus absoluter Feuchte und Temperatur zurückzurechnen. Das vermeidet die doppelte Umrechnung (z. B. wenn der AH-Sensor selbst schon aus einem Temp+RH-Template berechnet wird) und nutzt den ohnehin vorhandenen, direkt gemessenen Wert.
• Ist kein RH-Sensor hinterlegt oder liefert er gerade keinen Wert (z. B. "nicht verfügbar"), wird wie bisher automatisch aus absoluter Feuchte + Temperatur gerechnet – kein Verhalten ändert sich, wenn das Feld leer bleibt.
• Betrifft nur die Raumluft-/Außenluft-Feuchte bei Lufttemperatur; das separate Schimmelrisiko an der kalten Wand wird weiterhin aus der absoluten Feuchte und der berechneten Wandtemperatur ermittelt, da das kein Sensor direkt messen kann.
• Die beiden Diagnose-Sensoren "Relative Raumfeuchte" / "Relative Außenfeuchte" (vorher "Berechnete …") liefern jetzt je nach Konfiguration entweder den direkt gemessenen oder weiterhin den rechnerischen Wert.

Version 2.9.0

Ehrlichere Statusmeldungen auf der Karte, wenn Lüften wegen der Außenluft gerade nichts bringt:

• Verbesserung: Liegt die Raumluft über dem Zielwert, der relativen Feuchte-Schwelle oder im erhöhten/hohen Schimmelrisiko, aber die Außenluft ist gerade nicht trockener als drinnen (Lüften würde also eher zusätzliche Feuchte reinbringen statt welche loszuwerden), zeigt die Karte jetzt "Raumluft feucht – Außenluft aktuell nicht trockener" statt pauschal "Raumklima in Ordnung". Vorher wirkte es so, als sei alles in Ordnung, obwohl es das eigentlich nicht war.
• Neu: Wird in genau dieser Situation trotzdem das Fenster geöffnet, kommt einmalig pro Lüftungsvorgang eine Erinnerung, es wegen der ungünstigen Außenluft wieder zu schließen.
• Die übrigen Blockier-Meldungen (Regen, zu warme Außenluft, direkte Sonne) wurden im Zuge dessen erneut geprüft – dort war die Meldung bereits stimmig und wurde nicht verändert.

Version 2.8.5

Finaler Prüfdurchgang, drei parallele Reviews über die gesamte Codebasis:

• Bugfix: Ging während des Absenkens der Heizung beim Lüftungsstart das Fenster schon wieder zu (oder erneut auf), bevor alle Thermostat-Befehle durch waren, konnte das zu einem internen Fehler oder dazu führen, dass eine abgesenkte Heizung nie wieder hochgefahren wurde.
• Bugfix: Der Übersichts-Wochenbericht wurde in einer seltenen Startreihenfolge (Übersicht schon aktiv, Räume noch nicht) als "diese Woche schon verschickt" vermerkt, obwohl er mangels Räumen gar nicht verschickt wurde – für den Rest der Woche kam dann keiner mehr.
• Bugfix: Der Vorjahresvergleich im Monatsbericht verschluckte wie zuvor schon der Vormonatsvergleich "0 % Änderung" komplett, statt "gegenüber dem Vorjahr unverändert" anzuzeigen.
• Bugfix: Eine beschädigte gespeicherte Schimmel-Warnung hätte die Schimmel-, Monats- und Anomalie-Prüfung eines Raums dauerhaft blockiert, statt nur diese eine Warnung zu überspringen.
• Bugfix: Wurden der letzte Raum entfernt und gleichzeitig ein neuer Eintrag hinzugefügt, konnte die Dashboard-Karte für den neuen Eintrag dauerhaft nicht registriert werden.

Version 2.8.4

Gezielte Überprüfung und Verbesserung der Lüft- und Lernlogik (Luftwechsel-Modell):

• Bugfix: Der Wind-/Winkel-Bonus auf den geschätzten Luftwechsel wurde doppelt verrechnet, sobald für die aktuelle Wind-/Winkel-/Temperatur-Kombination schon genug gelernt worden war – dadurch wurden gut gelernte, windgünstige Bedingungen mit der Zeit zunehmend zu kurz eingeschätzt. Der Bonus gilt jetzt nur noch als Schätzung, solange für diese Kombination noch nicht genug eigene Erfahrung vorliegt.
• Verbesserung: Ein neu gelernter Wind-/Winkel-/Temperatur-Bucket wird jetzt erst nach 5 (statt 2) Sitzungen als "gelernt" vertraut, und bis dahin gleichgewichtet statt exponentiell geglättet gemittelt – eine einzelne verrauschte erste Messung (z. B. eine Windböe) konnte sich bisher sofort mit hohem Gewicht festsetzen.
• Bugfix: Sitzungen direkt nach dem Duschen fließen nicht mehr ins Luftwechsel-Lernen ein – die nachträglich verdunstende Restfeuchte von Wänden/Spiegel hätte den gelernten Luftwechsel sonst systematisch zu niedrig erscheinen lassen.
• Bugfix: Hat es nur zeitweise während einer Lüftung geregnet (nicht mehr im Moment des Fensterschließens), wurde die Sitzung bisher trotzdem fürs Lernen verwendet.
• Bugfix: Kühlen und Vorheizen fragten für Räume mit zwei Fenstern immer das Nicht-Querlüften-Modell ab, obwohl dort tatsächlich (und beim Lernen genauso) quergelüftet wird – das gelernte Modell blieb für diese beiden Funktionen dadurch dauerhaft ungenutzt.

Version 2.8.3

• Bugfix: Bei der zusammengefassten Übersichts-Erinnerung konnte derselbe Doppel-Versand-Fehler wie bei den Einzelraum-Erinnerungen auftreten (Cooldown wird jetzt ebenfalls sofort reserviert statt erst nach dem Versand).
• Bugfix: "In 30 Min. erinnern" und "Heute nicht mehr" für die Übersichts-Erinnerung gingen bei einem Neustart von Home Assistant verloren – werden jetzt wie bei den Einzelräumen gespeichert.
• Bugfix: Der Übersichts-Monatsbericht zeigte bei exakt unverändertem Bedarf gegenüber dem Vormonat gar keinen Vergleich an, statt "Bedarf wie im Vormonat".
• Bugfix: Schimmel- und Anomalie-Warnungen wurden als "verschickt" vermerkt, selbst wenn kein Benachrichtigungsziel erreichbar war – dadurch blieb die nächste Warnung bis zu 7 Tage bzw. dauerhaft aus, obwohl nie eine ankam.
• Bugfix: Die Lüftungskosten- und Vorheiz-Ersparnis-Sensoren (laufender Monat) waren als "Total" markiert, wodurch der monatliche Rücksprung auf 0 die Langzeitstatistik von Home Assistant verfälschen konnte – jetzt korrekt als "Messwert" markiert.
• Bugfix: Ein neuer Raum aus einer Vorlage übernahm deren Feuchte-Zielwert unverändert, auch wenn sich der Raumtyp unterschied (z. B. Vorlage "Bad" → neuer Raum "Schlafzimmer") – der zum gewählten Raumtyp passende Richtwert wird jetzt wie bei einem Raum ohne Vorlage automatisch gesetzt.
• Bugfix: Wurden alle Räume und die Übersicht entfernt und danach ohne Neustart von Home Assistant ein neuer Raum hinzugefügt, blieb die Dashboard-Karte dauerhaft nicht verfügbar.

Version 2.8.2

• Bugfix: Bei fast gleichzeitig ausgelösten Erinnerungen (z. B. zwei schnell aufeinanderfolgende Aktualisierungen) konnte der Cooldown umgangen und die Erinnerung doppelt verschickt werden – das Zeitfenster wird jetzt sofort reserviert statt erst nach dem Versand.
• Bugfix: Wurde ein Fenster kurz nach dem Schließen wieder geöffnet, während die vorherige Lüftungs-Session noch im Hintergrund abgeschlossen wurde, konnte die neu gestartete Session dabei versehentlich gekappt werden.
• Bugfix: Die "In 30 Min. erinnern"-Auswahl aus der Push-Nachricht ging bei einem Neustart von Home Assistant innerhalb dieser 30 Minuten verloren, wodurch sofort wieder eine Erinnerung kam – wird jetzt wie "Heute nicht mehr" gespeichert.
• Bugfix: Die Übersichtskarte konnte eine veraltete Tagestrend-Sparklinie zeigen, wenn sich nur die Trenddaten änderten, aber keine der anderen Kartenwerte.
• Bugfix: Der Party-Modus-Chip auf der Karte zeigte gelegentlich einen "Antippen, um zu beenden"-Hinweis an, obwohl er (z. B. kurz nach einem Neustart) noch nicht antippbar war.
• Bugfix: Je-Benachrichtigungsart gespeicherte Zielauswahlen konnten nicht mehr existierende Ziele enthalten, wenn zwischenzeitlich weniger als zwei Benachrichtigungsziele konfiguriert waren – wird beim erneuten Öffnen der Einstellungen jetzt bereinigt.
• Bugfix: Ein Schreibfehler beim CSV-Export (z. B. voller Speicher) landete bisher nur unklar im Log statt als verständliche Fehlermeldung.

Version 2.8.1

• Bugfix: Eine bewusst auf „niemand“ geleerte Ziel-Auswahl bei den Benachrichtigungsarten (z. B. „Schimmelgefahr an kein Gerät“) wurde bislang wie „nicht konfiguriert“ behandelt und ging trotzdem an alle Ziele – jetzt korrekt respektiert.
• Bugfix: Eine Raum-Vorlage übernahm auch Thermostate und Entfeuchter des Quell-Raums, wodurch ein neuer Raum unbemerkt Geräte eines anderen Raums mitgesteuert hätte – jetzt ausgenommen.
• Bugfix: Im Kompaktmodus der Karte zeigten der „heute“- und der Netto-Kosten-Chip weiterhin einen Auf-/Zuklapp-Pfeil, obwohl das zugehörige Panel dort ausgeblendet ist.

Version 2.8.0

• Regen-Vorwarnung: Droht laut Wettervorhersage bald Regen, wird die normale Lüft-Erinnerung vorgezogen (kürzerer Erinnerungsabstand) und in der Übersicht höher priorisiert – Hinweis dazu auch direkt in der Empfehlung.
• Party-Modus: Neuer Button pro Raum (auch als Karten-Chip antippbar) schaltet für 3 Stunden aggressiveres Lüften ein (niedrigeres Tagesziel, kürzere Erinnerungsabstände) – ideal bei Besuch. Schaltet sich von selbst wieder ab, erneutes Antippen beendet ihn vorzeitig.
• Energie-Dashboard: Neuer Sensor „Lüftungsenergie gesamt" (kWh, wächst nie zurück) lässt sich manuell im Home-Assistant-Energie-Dashboard als Verbrauch eines Geräts hinzufügen.
• Statistik-Export: Neuer Dienst smart_ventilation.export_statistics schreibt Tag/Woche/Monat/Gesamt aller Räume als CSV-Datei und meldet den Download-Link.
• Anomalie-Erkennung: Warnung, wenn an einem Tag deutlich mehr gelüftet wurde als im Schnitt der Tage davor – möglicher Hinweis auf ein vergessenes offenes Fenster oder einen defekten Sensor.
• Jahresvergleich auf der Karte: Kleines Balkendiagramm mit dem Lüftungsbedarf der letzten bis zu 12 Monate, ergänzend zum bisherigen Text-Monatsvergleich.
• Kompaktmodus: Neue Karten-Editor-Option zeigt nur noch Status und die wichtigste Kennzahl – praktisch für kleine Dashboard-Bereiche oder Handy-Widgets.
• Fensterstatus einzeln sichtbar: Räume mit mehreren Fensterkontakten zeigen jetzt den Status jedes einzelnen Fensters statt nur der Gesamtzahl.
• Raum aus Vorlage einrichten: Beim Hinzufügen eines neuen Raums lässt sich jetzt ein bestehender Raum als Vorlage wählen – alle Einstellungen außer Name und raumeigenen Sensoren (Fenster, Innentemperatur/-feuchte, CO₂, Dusche) werden übernommen.

Version 2.7.0

• Eigene Ruhezeit am Wochenende: Optional lässt sich unter „Benachrichtigungen“ jetzt eine abweichende Ruhezeit für Samstag/Sonntag einstellen (z. B. um am Wochenende länger schlafen zu können), während unter der Woche die gewohnte Ruhezeit gilt. Ohne Aktivierung ändert sich nichts.
• Empfänger je Benachrichtigungsart wählbar: Sind mindestens zwei Ziele unter „Benachrichtigen über“ ausgewählt, lässt sich für jede der 7 Nachrichtenarten (Erinnerung ans Lüften, Lüftung beendet, Warnungen, nach dem Duschen, Schimmelgefahr, Willkommen zu Hause, Wochen-/Monatsbericht) frei festlegen, welches Ziel sie bekommt – z. B. das Handy alle Nachrichten, Alexa aber nur „Lüften“ und „fertig“. Ohne eigene Auswahl bekommen weiterhin alle Ziele jede Nachrichtenart wie bisher.

Version 2.6.0

• Statistik per Klick auf der Karte: Ein Klick auf den „heute“-Chip im Raum klappt jetzt eine Übersicht mit Woche, Monat und Gesamt auf (Anzahl, Dauer, Netto-Kosten bzw. -Ersparnis je Zeitraum) – bislang war das nur über die einzelnen Statistik-Sensoren im More-Info-Dialog einsehbar.

Version 2.5.0

• 7-Tage-Trend auf der Karte: Sowohl Raum- als auch Übersichtskarte zeigen jetzt eine kleine Sparkline mit der Lüftungshäufigkeit der letzten 7 Tage (Tooltip mit Kosten pro Tag). Neuer Umschalter „7-Tage-Trend anzeigen“ im Karten-Editor.
• Übersicht: Netto-Chip mit Aufschlüsselung: Ein Klick auf den Netto-Kosten-Chip der Übersichtskarte öffnet eine Liste, welcher Raum wie viel zu den heutigen Kosten oder Ersparnissen beiträgt.
• Schimmelrisiko in der Raumliste sichtbar: Die Übersichtskarte zeigt jetzt auch bei „erhöhtem“ Schimmelrisiko (nicht mehr nur bei „hoch“) ein Warn-Icon direkt neben dem Raumnamen.
• Umschaltbare Sortierung der Übersicht: Die Raumliste lässt sich jetzt nach Dringlichkeit (Standard), Kosten heute oder Schimmelrisiko sortieren.
• Einstellungen neu geordnet: Der Bereich „Feinabstimmung“ wurde aufgelöst – Windrichtung und Sonnenstand stehen jetzt bei „Außen & Wetter“, die Winterschwelle bei „Lüftungsverhalten“, der Erinnerungsabstand bei „Benachrichtigungen“ und der Dämmstandard direkt bei „Raum & Fenster“. Damit findet sich jede Einstellung dort, wo man ihretwegen ohnehin schon hinschaut – an den gespeicherten Werten ändert sich nichts.

Version 2.4.0

• Schnellaktionen direkt auf der Karte: Solange eine Lüftung ansteht, zeigt die Karte jetzt „In 30 Min. erinnern“ und „Heute nicht mehr“ als Buttons an – bislang ging das nur über die Aktionen in der Push-Nachricht. Dahinter stehen zwei neue Button-Entitäten (button.snooze, button.skip_today) pro Raum, die auch unabhängig von der Karte nutzbar sind.
• Zusammengefasste Kosten-Anzeige: Statt zweier getrennter Chips für Wärmeverlust und Vorheiz-Ersparnis zeigt die Karte jetzt einen einzigen Netto-Chip (Kosten oder Ersparnis, je nachdem was überwiegt) mit einer Tooltip-Aufschlüsselung der beiden Anteile.
• Gesamtübersicht mit Tages-Bilanz: Die Übersichtskarte (alle Räume) zeigt jetzt ebenfalls einen Netto-Kosten-Chip mit der aufsummierten Heizkosten-Bilanz des Tages über alle Räume.
• Temperaturverlauf im Diagramm: Das Lüftungsdiagramm zeigt neben der Feuchte jetzt zusätzlich den Temperaturverlauf als zweite, gestrichelte Linie mit eigener Skala – inklusive Legende und synchronisiertem Hover-Punkt.

Version 2.3.26

• Feuchte-Schutz beim Vorheizen: Ist die Luft draußen deutlich feuchter als drinnen, wird nicht mehr vorgeheizt, auch wenn Temperatur und Nacht-Tiefstwert dafür sprächen – sonst würde man sich mit der Wärme zugleich ein Feuchteproblem einhandeln (spiegelbildlich zum bestehenden Feuchte-Schutz beim Sommer-Kühlen).
• Windrichtung fließt jetzt auch in die Vorhersage ein: Liefert die Wetter-Integration eine Windrichtung pro Stunde, werden der beste Lüftungszeitpunkt sowie die Kühlen-/Vorheizen-Vorschau bevorzugt für Stunden mit günstigem Wind (zum Fenster hin statt vom Fenster weg) berechnet. Ohne Richtungsangabe in der Vorhersage ändert sich nichts.
• Kühlen und Vorheizen nutzen jetzt das gebuckete Luftwechsel-Modell (nach Wind, Windwinkel und Temperaturdifferenz gelernt) statt nur des groben globalen Durchschnitts – wie es die normale Lüftungsdauer-Schätzung schon immer tut. Das macht die geschätzte Dauer für die aktuellen Bedingungen genauer, sobald dafür genug gelernt wurde.
• Vorheizen zeigt jetzt eine Ersparnis in der Statistik: Lüftungen, die als Vorheizen erkannt wurden, tauchen nicht mehr nur als Wärmeverlust, sondern zusätzlich als eingesparte Heizenergie (kWh/€) auf – heute/Woche/Monat/gesamt, im Wochenbericht und in einem neuen Sensor „Vorheiz-Ersparnis Monat“.

Version 2.3.25

• Automatik-Modus nutzt jetzt zusätzlich die mehrtägige Wettervorhersage (nur wenn eine Wetter-Entität gewählt ist): Zeigt die Vorhersage für die nächsten Tage durchgehend eindeutig Hoch UND Tief auf einer Seite der Heizgrenze, wird der Sommer-/Wintermodus sofort übernommen – ohne erst mehrere Stunden auf die lokale Außentemperatur zu warten (SEASON_CONFIRM_HOURS aus 2.3.19). Ein mehrtägiger Vorhersage-Trend ist ein verlässlicheres, längerfristigeres Signal als ein paar Stunden lokale Messwerte. Ohne Wetter-Entität oder bei uneindeutiger Vorhersage bleibt es beim bisherigen Verhalten.

Version 2.3.24

• Korrektur zu 2.3.23: Der Versuch, die kurze GitHub-Repo-Beschreibung automatisch bei jedem Release zu aktualisieren, hat die Release-Pipeline lahmgelegt (der Standard-Workflow-Token kann keine Repo-Einstellungen ändern, egal welche Berechtigung man ihm gibt). Zurückgenommen – kein Verhaltensunterschied in der Integration selbst.

Version 2.3.23

• GitHub-Repo-Beschreibung wird jetzt automatisch mit aktualisiert (siehe 2.3.24 – ließ sich mit dem Standard-Workflow-Token nicht umsetzen).

Version 2.3.22

• Feldbeschreibungen in den Einstellungen aktualisiert: Die Beschreibungen zu „Sommer-/Wintermodus“ und „Vorheizen ab“ erklären jetzt direkt in der App, dass die Automatik erst nach mehreren Stunden Trend umschaltet und dass Vorheizen nur bei manuell eingestelltem Sommer-Modus blockiert wird (nicht bei „Automatisch“). Kein Verhaltensunterschied, nur Doku.

Version 2.3.21

• Präzisierung zu 2.3.20: Vorheizen soll gezielt nur in der Heizsaison passieren, nicht unnötig Wärme in den echten Sommer holen. Deshalb wird jetzt wieder ein Sommer-Modus berücksichtigt – aber nur, wenn er manuell eingestellt ist. Steht ein Raum auf „Automatisch“, zählt weiterhin nur die tatsächliche Nacht-Tiefsttemperatur, weil die automatische Sommer/Winter-Erkennung (seit 2.3.19 bewusst träge) in der Übergangszeit tagelang „Sommer“ zeigen kann, obwohl es nachts schon unter die Heizgrenze fällt – genau dann soll Vorheizen ja Heizkosten sparen.

Version 2.3.20

• Fix: Vorheizen funktionierte nicht mehr, solange der Modus noch „Sommer“ zeigte. Seit 2.3.19 reagiert die Sommer/Winter-Automatik erst nach mehreren Stunden anhaltendem Trend, damit sie nicht mehr flackert. Gerade in der Übergangszeit (Herbst/Frühling) gibt es aber schon einzelne kalte Nächte, obwohl der Modus wegen warmer Tage noch auf „Sommer“ steht – Vorheizen wäre dadurch blockiert gewesen, obwohl die eigentliche Voraussetzung (kalte Nacht) erfüllt war. Vorheizen prüft jetzt nur noch die Nacht-Tiefsttemperatur direkt und ist unabhängig von der Sommer/Winter-Einstufung.

Version 2.3.19

• Fix: Automatik-Modus konnte an einem Tag mehrfach zwischen Sommer und Winter hin- und herspringen. In den Übergangsmonaten (März–Mai, September–November) entschied bisher die aktuelle Außentemperatur sofort – bei Tagen mit großer Spanne (kalte Nacht, warmer Nachmittag) konnte das den Modus (und damit z. B. Vorheizen/Kühlen) mehrmals täglich umschalten, obwohl sich an der Jahreszeit nichts geändert hatte. Die Außentemperatur muss jetzt mindestens 6 Stunden ununterbrochen deutlich über bzw. unter der Heizgrenze liegen, bevor der Modus tatsächlich wechselt.

Version 2.3.18

• Vorheizen berücksichtigt jetzt die Wettervorhersage (nur wenn eine Wetter-Entität eingerichtet ist):
  • Regen-Vorschau: Droht laut Vorhersage in den nächsten ca. 2 Stunden Regen, wird nicht mehr zum Vorheizen geöffnet – auch wenn es gerade noch trocken ist.
  • Vorschau auf den nächsten Zeitpunkt: Ist es aktuell noch nicht warm genug, zeigt die Karte an, ab wann es laut Vorhersage voraussichtlich warm (und trocken) genug wird, um vorzuheizen.

Version 2.3.17

• Neu: Vorheizen per Lüften (Winter). Ist ein Raum unter der neuen Schwelle „Winter: vorheizen ab“ (Vorgabe 19 °C) und es war die letzte Nacht (22–9 Uhr) schon einmal kälter als die eingestellte Heizgrenze (Vorgabe 15 °C), darf tagsüber trotz wärmerer Außenluft gelüftet werden, um warme Luft statt Heizungswärme in den Raum zu holen und so das Heizen hinauszuzögern bzw. den Raum warm zu halten. Voraussetzung ist außerdem, dass es draußen mindestens 2 °C wärmer ist als drinnen – sonst bringt das Lüften keinen Vorteil.
  • Kein Widerspruch zur Wärme-Sperre aus 2.3.14: Die „draußen zu warm“-Sperre bleibt für alle anderen Gründe (Feuchte, CO₂) unverändert bestehen. Nur wenn tatsächlich zum Vorheizen gelüftet werden soll, gilt sie ausnahmsweise nicht – dort ist die wärmere Außenluft ja gerade der Grund fürs Lüften, nicht ein Störfaktor. Ebenso erscheint dabei nicht der Hinweis „Fenster schließen“, der sonst bei wärmer werdender Außenluft kommt.
  • Die Vorheiz-Schwelle ist ein eigener, unabhängiger Wert (nicht die Sommer-Wohlfühltemperatur) und lässt sich unter „Lüftungsverhalten“ einstellen.

Version 2.3.16

• Feuchte-Hysterese jetzt pro Raum einstellbar: Der Puffer gegen das Flackern der Feuchte-Empfehlung an der Schwelle (seit 2.3.12 fest im Code) lässt sich jetzt unter „Lüftungsverhalten“ als „Feuchte-Puffer gegen Flackern“ anpassen. Vorgabewert bleibt 0,1 g/m³, höher = ruhiger/träger, niedriger = reagiert schneller.

Version 2.3.15

• Fix: Statistik nach Neustart konnte verfälscht sein. Schloss sich ein Fenster während HA nicht lief (Neustart, Update) und kamen zwischen dem tatsächlichen Schließen und dem Wiederhochfahren mehrere Stunden zusammen, wurde beim Nachtragen der Lüftung fälschlich mit den dann aktuellen (aber längst nicht mehr aussagekräftigen) Sensorwerten geprüft, ob das Ziel erreicht wurde – eine zufällig trockene Raumluft Stunden später konnte so eine eigentlich wirkungslose Lüftung als „erfolgreich“ in die Statistik eintragen. Zählt jetzt nur noch, was schon vor dem Neustart als erreicht festgehalten war.
• Kleinere Doku-Korrektur bei der internen Benachrichtigungs-Filterung (kein Verhaltensunterschied).

Version 2.3.14

• Fix: Im Winter wurde trotz wärmerer Außenluft weiter „Lüften“ empfohlen. Die Wärme-Sperre („draußen zu warm“) galt bisher nur im Sommer – im Winter wurde sie komplett übersprungen, auch an milden Tagen, an denen es draußen tatsächlich wärmer war als drinnen. Jetzt gilt dieselbe Grenze (Standard 3 °C) unabhängig von der Jahreszeit; ebenso der Hinweis zum Fenster schließen, falls es während des Lüftens wärmer wird.
• Automatik-Modus berücksichtigt jetzt den Kalendermonat: Dezember–Februar gelten fest als Winter, Juni–August fest als Sommer – ein einzelner milder Wintertag oder kühler Sommertag schaltet den Modus nicht mehr um. Nur in den Übergangsmonaten (März–Mai, September–November) entscheidet weiter die Außentemperatur wie bisher.

Version 2.3.13

• Richtwert für das Tagesziel je Raumtyp: Beim Einrichten eines Raums lässt sich jetzt ein Raumtyp wählen (Schlafzimmer, Bad, Wohnzimmer/Büro, Küche, Sonstige). Danach wird das Tagesziel Luftfeuchte automatisch auf einen dazu passenden Richtwert vorbelegt (z. B. Schlafzimmer niedriger wegen Schimmelrisiko an Außenwänden, Bad höher wegen kurzfristiger Spitzen durchs Duschen) – lässt sich aber jederzeit manuell überschreiben, dann bleibt der eigene Wert erhalten.

Version 2.3.12

• Feuchte-Empfehlung flackert nicht mehr: Die Empfehlung „wegen Feuchte lüften“ konnte direkt an der Schwelle bei jeder kleinen Sensorschwankung an- und ausgehen (sichtbar als ständiger Wechsel zwischen „Kippfenster …“ und „Keine Lüftung erforderlich“ im Verlauf, teils im Minutentakt). Jetzt gilt eine Hysterese: Ist die Empfehlung erst aktiv, braucht es einen spürbar deutlicheren Rückgang (Feuchteunterschied, Zielwert, rel. Feuchte und Schimmelrisiko gemeinsam klar unter der Schwelle), bevor sie wieder ausgeht.

Version 2.3.11

• Pause nach dem Lüften nutzt die Wettervorhersage: Statt starr 60 Minuten zu warten, gilt bei eingerichteter Wetter-Entität der nächste günstige Zeitpunkt aus der Vorhersage – aber höchstens 4 Stunden voraus, sonst bleibt es bei 60 Minuten. So kommt keine Erinnerung, während draußen gerade Regen oder Hitze herrscht, aber auch keine unnötig lange Pause.
• Ausnahme bei Extremwerten: Ist das Schimmelrisiko hoch oder der CO₂-Wert hoch, gilt die Pause gar nicht – dann wird trotzdem sofort wieder zum Lüften geraten.

Version 2.3.10

• Kleiner Timing-Fix: Attribute (u. a. der neue Heizungsstatus) werden jetzt immer am Ende jeder Prüfrunde aktualisiert, nicht nur am Anfang – vorher konnte die Karte bis zu 30 Sekunden hinterherhinken.
• Heizung sichtbar auf der Karte: Solange gelüftet wird, zeigt die Karte jetzt, welche Heizung abgesenkt wird und wann sie wiederhergestellt wird. Regelt Better Thermostat oder der Climate Group Helper das Fenster selbst, steht das dort ebenfalls.

Version 2.3.9

• „Pausiert“ auf der Karte: Gelten gerade dieselben Sperren wie für Benachrichtigungen (Pause nach dem Lüften, Ruhezeit, „In 30 Min. erinnern“, „Heute nicht mehr“, Urlaub, niemand zu Hause), zeigt die Karte „Pausiert“ mit Grund statt „Lüften“. Die Empfehlung bleibt klein darunter sichtbar; die Übersicht zählt pausierte Räume nicht mehr mit.
• Karte lädt robuster: Frontend-Modul und Dashboard-Ressource nutzen getrennte Adressen – schlägt ein Weg fehl (z. B. beim Laden während eines Neustarts), lädt der andere trotzdem.

Version 2.3.8

• Better Thermostat + Climate Group Helper: Die Heizungs-Hierarchie wird erkannt (Thermostate → Climate Group Helper → Better Thermostat). Geschaltet wird immer die oberste Ebene – egal ob im Raum das BT, die Gruppe oder ein einzelnes Thermostat gewählt ist. So regelt Better Thermostat nicht dagegen.
• Hat Better Thermostat einen Fenstersensor oder der Climate Group Helper eine Fenstersteuerung, überlässt Smart Ventilation das Abschalten diesen Integrationen.

Version 2.3.7

• Kein Widerspruch mehr zwischen „Lüften“ und „Fenster schließen“: Die Warnung „draußen zu warm“ nutzt jetzt dieselbe Sommer-Grenze wie die Empfehlung. Nur wenn zum Kühlen gelüftet wird, kommt sie schon, sobald es draußen wärmer als drinnen ist.

Version 2.3.6

• Better Thermostat: Hat ein Better Thermostat einen eigenen Fenstersensor, schaltet es beim Lüften selbst ab – Smart Ventilation greift dann nicht mehr zusätzlich ein (kein doppeltes Schalten). Ohne Fenstersensor übernimmt Smart Ventilation wie bisher.
• Klima-Gruppen: Eine ausgewählte Gruppe wird in ihre Thermostate aufgelöst; ist ein Thermostat zusätzlich einzeln gewählt, wird es trotzdem nur einmal geschaltet.
• Neues Attribut heizung_selbst_geregelt am Sensor „Lüftung läuft“.
• Releases werden automatisch angelegt, sobald alle Tests grün sind.

Version 2.3.5

• Keine Dauer-Aufforderung mehr: „Lüften wegen Feuchte“ nur noch, wenn es sich lohnt (draußen mindestens 1 g/m³ trockener) und der Raum zu feucht ist (über dem Tagesziel, ab 65 % rel. Feuchte oder bei erhöhtem Schimmelrisiko). Vorher reichten 0,5 g/m³ Unterschied – das Tagesziel wurde dabei nicht beachtet.

Version 2.3.4

• Alexa sagt den Raum an: Alexa Media Player liest nur den Nachrichtentext vor, nicht den Titel. Alexa-Empfänger (notify.alexa_media_…) bekommen jetzt einen eigenen, vorlesbaren Text: Raum zuerst, Einheiten ausgeschrieben („Grad“, „Prozent“, „Gramm pro Kubikmeter“), Kommazahlen auf Deutsch. Handys bekommen weiterhin Titel und Aktions-Buttons.

Version 2.3.3

• Karte lädt auch direkt nach einem Neustart: Sie liegt jetzt unter /config/www/smart_ventilation/ und wird über /local/ ausgeliefert – das stellt Home Assistant schon zu Beginn des Starts bereit, das Handy speichert die Datei zwischen. Alte oder doppelte Ressourcen-Einträge werden automatisch bereinigt.

Version 2.3.2

• Karte wird zusätzlich als Dashboard-Ressource eingetragen (wie HACS es für Karten macht) und damit bei jedem Dashboard-Aufruf zuverlässig geladen. Beim Entfernen der Integration wird der Eintrag wieder gelöscht.

Version 2.3.1

• Karte fehlertolerant: kann nicht mehr „leer hängen bleiben“; bei einem Problem zeigt sie die Fehlermeldung direkt an
• Karte ohne Auswahl zeigt einen Hinweis statt eines Fehlers (Vorschau in der Kartenauswahl funktioniert immer)

Version 2.3.0

• Neue Dashboard-Karte: klare Statusanzeige mit Badge, verständliche Überschrift („Stoßlüften“, „Lüftung läuft“, „Raumklima in Ordnung“), Kacheln mit Füllstandsbalken für Wandfeuchte und CO₂, Hinweis-Banner, Verlauf nur der Feuchte (eine Achse) mit Tooltip beim Antippen, Kacheln öffnen den jeweiligen Sensor. Passt sich schmalen Spalten an, unterstützt Tastatur und „Bewegung reduzieren“.
• Übersichtskarte mit Status je Raum, Antippen öffnet den Raum.
• Einstellungen: Symbole für jeden Bereich, kurze Beschreibung je Bereich, neuer Bereich „Feinabstimmung“ für selten benötigte Werte; Übersicht in zwei Bereiche gegliedert; Erklärungen im Auswahlmenü.
• Symbole aller Entitäten wechseln mit dem Zustand (z. B. Fenster offen/zu, Schild/Warnung beim Schimmelrisiko).

Version 2.2.0

• Schimmel-Frühwarnung über mehrere Tage: Ein Tag gilt als kritisch, wenn die Wand mindestens 6 Stunden über 80 % Feuchte liegt. Ab 3 kritischen Tagen in Folge kommt eine Warnung mit Tipps (nicht in der Ruhezeit, bei anhaltender Lage erneut nach einer Woche). Neue Entitäten „Kritische Schimmeltage in Folge“ und „Schimmelgefahr“, Hinweis in der Karte.
• Monats- und Jahresvergleich: Stunden mit Lüftungsbedarf werden erfasst, jeder Monat wird archiviert (3 Jahre). Am 1. des Monats kommt ein Monatsbericht mit Vergleich zum Vormonat und – ab dem zweiten Jahr – zum Vorjahr. In der Übersicht mit Rangfolge der Räume.
• Fix: Einstellungen ließen sich nicht speichern, wenn ein optionales Feld (z. B. CO₂-Sensor) leer war.

Version 2.1.1

• Einstellungen als ein Formular mit aufklappbaren Bereichen – alles an einer Stelle ändern und einmal speichern
• Neue Reihenfolge: Raum & Fenster → Sensoren im Raum → Außen & Wetter → Lüftungsverhalten → Benachrichtigungen & Abwesenheit → Heizung, Entfeuchter & Kosten
• Zu jedem Feld eine kurze Erklärung, Zahlenfelder mit Einheit
• Entitätsnamen und Zustände (Schimmelrisiko, Luftqualität, Jahreszeit) übersetzt (Deutsch/Englisch)
• Technische Werte (Luftwechsel, Sonnenstand, Taupunkte …) unter „Diagnose“ einsortiert
• Karte: Werte brechen nicht mehr um

Version 2.1.0

• Bad-Modus: Nach dem Duschen (Dusch-Sensor oder erkannt am starken Feuchteanstieg) sofort Lüft-Hinweis – auch in der Ruhezeit. Ist nach 30 Minuten nicht gelüftet und noch feucht, kommt eine Erinnerung.
• Alle weg, Fenster offen: Push, sobald die letzte Person das Haus verlässt und noch ein Fenster offen ist.
• Urlaubsmodus über Kalender (optional mit Stichwort), Schalter oder Binärsensor: keine Erinnerungen, aber täglich höchstens eine Warnung bei hohem Schimmelrisiko.
• Sommer: Kühlen per Lüften: Empfehlung, wenn es drinnen wärmer als die Wohlfühltemperatur (Standard 23 °C) und draußen mind. 2 °C kühler ist. Nachtplan aus der Vorhersage („Heute ab 22:00 bis 07:00 Uhr“). Hinweis zum Schließen, sobald es draußen wärmer wird.
• Luftentfeuchter: Wird eingeschaltet, wenn es feucht ist (ab 60 %) und gerade nicht gelüftet werden kann (Regen, Hitze, Ruhezeit, Urlaub, niemand da); aus bei 55 %, offenem Fenster oder wenn kein Bedarf mehr – frühestens nach 15 Minuten.
• Wochenbericht sonntags um 19 Uhr – pro Raum oder gesammelt über die Übersicht.
• Verlaufskurve der laufenden bzw. letzten Lüftung in der Dashboard-Karte.
• Sprachsteuerung über Assist und Dienst smart_ventilation.status.

Version 2.0.0

• Einrichtung als Assistent in vier Schritten, Einstellungen als Menü (nur der gewählte Bereich wird geändert)
• Übersicht aller Räume (eigener Eintrag): dringendster Raum, Anzahl Räume mit Bedarf, optional eine Sammel-Nachricht statt einer pro Raum
• Anwesenheit: Personen auswählen – Erinnerungen nur an Anwesende, keine Erinnerung wenn alle weg sind, Hinweis beim Heimkommen
• Schimmelrisiko an der Wand: Temperatur an der kältesten Stelle aus Außentemperatur und Dämmstandard (DIN 4108-2, Kriterium 80 %)
• CO₂-Sensor (optional): Empfehlung auch bei schlechter Luft, bei sehr schlechter Luft kurz lüften trotz Sommerhitze
• Wärmeverlust und Kosten pro Lüftung, Tag und Monat
• Reparatur-Hinweise, wenn ein Sensor länger als 10 Minuten ausfällt
• Eigene Dashboard-Karte für Räume und Übersicht
• Automatische Tests gegen echtes Home Assistant (stabil, Beta und Entwicklungsversion)
• Kompatibel mit Home Assistant 2026.10 (Umstellung von voluptuous auf probatio)

Version 1.9.0

• Mehrere Fenster pro Raum: Lüftung läuft, solange mindestens ein Fenster offen ist. Querlüften (2+ Fenster gleichzeitig) wird erkannt und getrennt gelernt.
• Auskühl-Warnung: Push, wenn der Raum bei offenem Fenster unter die Grenze fällt (Standard 18 °C, 0 = aus). Im Winter zusätzlich Hinweis, wenn deutlich länger als nötig gelüftet wird.
• Ruhezeiten (Standard 22–7 Uhr) für Lüft-Erinnerungen. Warnungen kommen trotzdem.
• Buttons in der Push-Nachricht: „In 30 Min. erinnern“ und „Heute nicht mehr“.
• Nach einer Lüftung 1 Stunde keine neue Erinnerung.
• Heizung koppeln (optional): Thermostate nach 1 Min. offenem Fenster aus bzw. auf Minimum, beim Schließen zurück auf den vorherigen Wert.
• Neustart-fest: laufende Lüftung, abgesenkte Heizung und „Heute nicht mehr“ überstehen einen Neustart.
• Button „Lernen zurücksetzen“
• Fix: „Ziel erreicht“ wurde sofort gemeldet, wenn der Raum schon vor dem Öffnen unter dem Tagesziel lag. Neu zählt auch: 70 % des Feuchteunterschieds abgebaut.

Version 1.8.0

• Bester Lüftungszeitpunkt aus der stündlichen Wettervorhersage (optional, Wetter-Entität in den Einstellungen wählen)
  • bewertet die nächsten 24 h zwischen 7 und 22 Uhr
  • rechnet die absolute Außenfeuchte aus Taupunkt oder Temperatur + Luftfeuchte
  • schließt Regenstunden und im Sommer zu heiße Stunden aus, bevorzugt im Winter mildere Stunden, Wind gibt einen Bonus
  • aktualisiert sich alle 30 Minuten
• Voraussetzung: Der Wetterdienst muss eine stündliche Vorhersage mit Luftfeuchte oder Taupunkt liefern (z. B. Met.no, OpenWeatherMap, DWD)

Version 1.7.0

• Sommer/Winter-Modus (Automatisch, Sommer, Winter)
  • Winter: keine Temperatursperre mehr, stattdessen Stoßlüften mit Höchstdauer je nach Außentemperatur (unter 5 °C: 5 Min., unter 10 °C: 10 Min., sonst 15 Min.), nie Kippfenster
  • Sommer: nicht lüften, wenn es draußen deutlich wärmer ist als drinnen (Standard 3 °C)
  • Automatik schaltet nach Außentemperatur um (Standard 15 °C, mit 1 °C Hysterese)
  • Neuer Sensor „Jahreszeit-Modus“
• Empfänger per Auswahlliste: alle Handys mit Home-Assistant-App ankreuzen, mehrere möglich. Ein offline Handy blockiert die anderen nicht.
• Bestehende Einträge übernehmen den bisher eingetragenen notify-Dienst automatisch

Version 1.6.1

• Fix: Integration startete nicht (async_track_time_interval mit vertauschten Argumenten, Fehler aus dem Original-Code)

Version 1.6.0

• Statistik-Sensoren für heute, Woche, Monat, gesamt, aktuelle und längste Lüftung
• Binärsensoren „Heute gelüftet“ und „Lüften empfohlen“ (für Automationen)
• Tagesziel (absolute Feuchte innen) einstellbar
• Fix: Attribut-Änderungen am Fensterkontakt (z. B. Batterie) starten die Lüftung nicht mehr neu
• Jede Öffnung wird gezählt, auch wenn innen nicht feuchter war als außen
• Zeitberechnung nutzt die Home-Assistant-Zeitzone

Version 1.5.0

• Optionen-Seite: Einstellungen jederzeit ändern über Geräte & Dienste -> Smart Ventilation -> Konfigurieren. Gelernte Werte bleiben erhalten.
• Deutsche (und englische) Feldbezeichnungen im Einrichtungsdialog
• Ein Raum kann nicht mehr versehentlich doppelt angelegt werden

Version 1.4.1 (Bugfix)

• Syntaxfehler in sensor.py behoben (Integration lud nicht)
• manifest.json: config_flow: true – Integration erscheint jetzt unter „Integration hinzufügen“
• Lernformel korrigiert: Luftwechsel wurde um Faktor 60 zu niedrig berechnet
• Notify-Dienst und Cooldown (Minuten) sind jetzt im Einrichtungsdialog einstellbar
• Keine Erinnerung, während das Fenster schon offen ist; Cooldown gilt global
• Regen: numerische Sensoren (mm/h > 0) werden erkannt
• Lüften bis unter Außenniveau wird nicht mehr verworfen
• Sensoren aktualisieren sich per Push, haben Geräteklassen (Statistik/Verlauf) und Raumnamen als Präfix

Version 1.4

Feedback-Regelkreis

Während ein Fenster geöffnet ist, prüft die Integration alle 30 Sekunden den tatsächlichen Fortschritt.

Beispiel:

1. Jetzt wäre ein guter Zeitpunkt zum Lüften – ca. 6 Minuten.
2. Fenster wird geöffnet.
3. Lüftung läuft wird aktiv.
4. Feuchteabbau wird laufend verfolgt.
5. Sobald der Zielwert erreicht ist: Das Lüftungsziel ist erreicht – Feuchteunterschied nur noch 0,4 g/m³.
6. Beim Schließen: Lüftung abgeschlossen – 7,1 Minuten, Feuchteunterschied 4,7 → 0,4 g/m³.
7. Der reale Vorgang fließt anschließend in das Lernmodell ein.

Neue Sensoren:

• Lüftung läuft
• Lüftungsfortschritt

Damit entsteht ein geschlossener Feedback-Regelkreis aus Empfehlung -> tatsächlichem Lüften -> Ergebnis -> Lernen.

Version 1.3

Intelligente Benachrichtigungen

Optional kann ein Home-Assistant-Notify-Dienst hinterlegt werden.

Beispiel: notify.mobile_app_patrick

Wenn die Bedingungen zum Lüften erfüllt sind, wird eine Nachricht erzeugt:

Jetzt wäre ein guter Zeitpunkt zum Lüften – Komplett öffnen, voraussichtlich 6 Minuten.

Die Benachrichtigung besitzt einen Cooldown, damit bei häufigen Sensoränderungen keine Meldungsschleife entsteht.

Version 1.2

Kontextabhängiges Lernen

Das System lernt nicht mehr nur einen einzigen Luftwechselwert. Es legt Modelle nach folgenden Bedingungen an:

• Windgeschwindigkeit
• Windrichtung relativ zum Fenster
• Temperaturdifferenz innen/außen

Nach mindestens zwei passenden Lernvorgängen wird das passende Kontextmodell bevorzugt. Zusätzlich bleibt ein allgemeines Modell als Fallback.

Taupunkt und Raumfeuchte

Aus absoluter Feuchte und Temperatur werden näherungsweise berechnet:

• relative Luftfeuchte innen/außen
• Taupunkt innen/außen

Schimmelrisiko

Es gibt eine einfache Luftfeuchte-/Taupunkt-Warnung:

• niedrig
• erhöht
• hoch

Das ist ausdrücklich keine Aussage über die tatsächliche Oberflächentemperatur einer Wand und ersetzt keine bauphysikalische Bewertung.

Sonnenstand

• Sonnenhöhe
• Sonnenazimut
• Fenster-Ausrichtung
• direkte Sonneneinstrahlung

Bei direkter Sonne wird die Lüftungsdauer begrenzt.

Persistenz

Das gelernte Modell wird ohne Home-Assistant-Helper dauerhaft im Storage der Integration gespeichert. Die erzeugten Sensoren werden zusätzlich ganz normal vom Home-Assistant-Recorder aufgezeichnet.