Zum Hauptinhalt springen

Maintenance reminders Smart-Home-Integration, kostenlos und Open Source

Maintenance reminders-Integration für Gladys Assistant

Wiederkehrende Wartung (Heizung, Filter, Kamin…): Resttage, Erinnerungen, Erledigt-Taste.

Auf GitHub ansehenAlle Integrationen

Die wiederkehrenden Arbeiten im Haus, direkt in Gladys gespeichert: die Heizungswartung jedes Jahr, die Lüftungsfilter alle sechs Monate, der Schornsteinfeger, die Hauptuntersuchung, das Entkalken, die Batterien der Rauchmelder… Jede Aufgabe zählt die verbleibenden Tage, warnt dich vor der Fälligkeit, meldet, wenn sie überfällig ist, und ein Tipp auf Erledigt startet die Zählung neu. Ohne Konto, ohne Cloud.

Feedback willkommen. Diese Integration wurde mit dem Test-Gladys des SDK und in ihrem Docker-Image getestet, noch nicht im Alltag mit einem echten Gladys. Wenn etwas nicht wie beschrieben funktioniert, sag es bitte im Gladys-Forum oder in den Issues.

Was du brauchst​

  • Gladys Assistant 5.2.0 oder neuer (das Formular der Widget-Schaltfläche).
  • Sonst nichts: Die Aufgaben speichert die Integration in ihrem eigenen Volume.

Einrichtung​

  1. Installiere die Integration und öffne ihren Tab Konfiguration.
  2. Aufgabe erstellen oder ändern:
    • wähle eine vorgeschlagene Aufgabe (Heizungswartung 1 Jahr, Schornsteinfeger 1 Jahr, Hauptuntersuchung 2 Jahre, Lüftungsfilter 6 Monate, Staubsaugerfilter 3 Monate, Entkalken 2 Monate, Rauchmelder-Batterien 1 Jahr, Klimaanlage, Dunstabzugsfilter, Wasserfilter, Dachrinne, Klärgrube, Feuerlöscher): Name, Zeitraum und Vorwarnzeit werden für dich ausgefüllt;
    • oder gib einen Namen und einen Zeitraum ein: Alle (eine Zahl) und eine Einheit (Tage, Wochen, Monate, Jahre), höchstens zehn Jahre;
    • Zuletzt erledigt: 2026-03-14, 14.03.2026 oder -30 für vor 30 Tagen; leer: heute;
    • Vorwarnzeit (Tage): wie viele Tage vor der Fälligkeit die Aufgabe „bald fällig“ ist (leer: die der vorgeschlagenen Aufgabe, sonst 7).
  3. Öffne den Tab Erkennung und füge die Aufgabe hinzu: So wird sie zu einem Gerät in Gladys, das du umbenennen und einem Raum zuordnen kannst.
  4. Füge das Widget Nächste Wartungen zu einem Dashboard hinzu.

Dieselbe Aktion ändert eine Aufgabe: Gib ihren Namen und nur das an, was sich ändert (den Zeitraum, die Vorwarnzeit oder ein korrigiertes letztes Datum). Aufgabe als erledigt markieren hält fest, dass sie erledigt wurde, heute oder am eingegebenen Datum. Aufgaben anzeigen zeigt jede Aufgabe und ihre nächste Fälligkeit. Aufgabe löschen löscht sie mit ihrem Verlauf endgültig: Gib zur Bestätigung ihren genauen Namen ein und lösche danach auch ihr Gerät in Gladys.

Sprache der Funktionsnamen: die Sprache der Namen, die die Funktionen beim Hinzufügen einer Aufgabe bekommen, der Daten, die sie zeigen, und der an Szenen gesendeten Texte (standardmäßig Französisch).

Die Fälligkeit einer monatlichen oder jährlichen Aufgabe behält den Tag des Monats oder nimmt den letzten Tag eines kürzeren Monats: Am 31. Januar erledigt, ist eine monatliche Aufgabe am 28. Februar fällig (am 29. in einem Schaltjahr). Die Tage wechseln um Mitternacht in der Zeitzone von Gladys.

Geräte​

Ein Gerät pro Aufgabe, mit sechs Funktionen:

FunktionWert
Verbleibende TageTage bis zur Fälligkeit, negativ, sobald überfällig
Verbleibender Zeitraumder verbleibende Teil des Zeitraums, 100 % am Tag der Erledigung, 0 bei Fälligkeit
Bald fällig1 in der Vorwarnzeit, bis zur Fälligkeit
Überfällig1 ab dem Tag nach der Fälligkeit, bis sie erledigt ist
Zuletzt erledigtdas letzte Datum der Erledigung
Nächste Fälligkeitdie Fälligkeit

Die Namen sind die der eingestellten Sprache (hier Deutsch). Gladys bietet einer Geräte-Integration keine Kalendereinträge an: Die Fälligkeiten sind Funktionen, das Widget und die Szenen, keine Einträge im Kalender von Gladys.

Dashboard​

Das Widget Nächste Wartungen zeigt, wie viele Aufgaben bald fällig oder überfällig sind, dann die nächsten Aufgaben nach Fälligkeit: überfällige in Rot („8 T. überfällig“), bald fällige in Orange („in 11 T.“), die anderen mit ihrem Datum. Erledigt öffnet ein Formular: Wähle die Aufgabe und das Datum der Erledigung (leer: heute).

Einstellungen: die angezeigten Aufgaben (alle oder nur bald fällige oder überfällige), die Anzahl der Zeilen (3 bis 10) und die auszublendenden Elemente (die Anzahl, die Erledigt-Taste).

Szenen​

Auslöser​

  • Wartung bald fällig: Eine Aufgabe ist in ihre Vorwarnzeit eingetreten (z. B. 30 Tage vor der Heizungswartung). Einmal pro Fälligkeit.
  • Wartung überfällig: Eine Aufgabe hat ihre Fälligkeit überschritten, ohne als erledigt markiert zu sein. Einmal pro Fälligkeit.

Beide lassen sich auf eine Aufgabe beschränken (leer: alle) und liefern den Namen der Aufgabe, ihre Fälligkeit (JJJJ-MM-TT) und ihre verbleibenden Tage.

Aktionen​

  • Wartung als erledigt markieren: Die Zählung der Aufgabe beginnt neu, ab heute oder ab einem Datum (2026-03-14, 14.03.2026, -2). Liefert das letzte Datum, die nächste Fälligkeit und die verbleibenden Tage.
  • Wartungsaufgaben lesen: was bald fällig oder überfällig ist als ein Text („Lüftungsfilter (8 T. überfällig), Heizungswartung (in 11 T.)“) oder alle Aufgaben, mit der Anzahl überfälliger und bald fälliger Aufgaben und der nächsten Aufgabe.

Szenen-Ideen​

  • „Wartung bald fällig“: eine Telegram-Nachricht „Heizungswartung vor dem {{due}} buchen“.
  • Jeden Montag um 8 Uhr: Wartungsaufgaben lesen, dann eine Nachricht mit dem Text, wenn etwas fällig ist.
  • Ein NFC-Tag am Staubsauger: Wartung als erledigt markieren für seinen Filter.

Deine Daten​

Alles steht in einer Datei, tasks.json, im Volume der Integration (/data), mit der vorherigen Version als tasks.json.bak. Jede Änderung wird in eine temporäre Datei geschrieben und dann umbenannt: Ein Stromausfall hinterlässt nie eine halbe Datei. Ist die Datei beim Start unlesbar, wird sie als tasks.json.corrupt aufbewahrt und stattdessen die Sicherung gelesen. Die letzten zwanzig Daten jeder Aufgabe bleiben erhalten. Das Deinstallieren der Integration löscht ihr Volume und damit die Aufgaben.

Fehlerbehebung​

  • Die Aufgabe fehlt in den Szenen oder in den Widget-Einstellungen: Füge zuerst ihr Gerät im Tab Erkennung hinzu.
  • „Datum nicht verstanden“: Verwende 2026-03-14, 14.03.2026 oder -7.
  • „Dieses Datum liegt in der Zukunft“: Gib den Tag der Erledigung an.
  • „Die Aufgaben konnten nicht gespeichert werden“: Das Volume der Integration ist voll oder schreibgeschützt; nichts wurde geändert. Sieh dir die Protokolle der Integration an.
  • Protokolle: in Gladys auf der Seite der Integration, Logs. Starte die Integration mit LOG_LEVEL=debug für mehr Details.

Grenzen​

  • 100 Aufgaben, 40 Zeichen pro Name, ein Zeitraum von höchstens zehn Jahren, eine Vorwarnzeit von höchstens 365 Tagen. Die angezeigten verbleibenden Tage sind auf ±3660 begrenzt.
  • Ein Datum pro Aufgabe: keine Uhrzeit, keine Unteraufgaben, keine täglich wiederholte Erinnerung (eine Szene auf „Überfällig“ kann das).
  • Keine Einträge im Kalender von Gladys (siehe Geräte), kein Import aus einem anderen Dienst.

Konfigurationseinstellungen​

Diese Einstellungen fragt Maintenance reminders in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine WartungsaufgabensectionNeinErstelle eine Aufgabe mit den Schaltflächen unten (eine vorgeschlagene oder deine eigene) und füge sie im Tab Erkennung hinzu: So wird sie zu einem Gerät mit ihren Resttagen, für das Dashboard (Widget Nächste Wartungen) und die Szenen. Alles bleibt in Gladys.
Sprache der FunktionsnamenselectNeinNamen der Funktionen beim Hinzufügen einer Aufgabe, Daten und an Szenen gesendete Texte.

So installierst du Maintenance reminders in Gladys​

  1. Öffne in Gladys Integrationen: Maintenance reminders erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-entretien:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-entretien.

Maintenance reminders benötigt Gladys >=5.2.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​

Maintenance reminders 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 guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am