Eine Home-Assistant-Installation sammelt Erweiterungen, und irgendwann weiß man nicht mehr, welche noch weiterentwickelt werden, welche man nicht mehr benutzt und welche leise kaputt ist. IntegrationGuard prüft alles, was über HACS installiert wurde, und auf Home Assistant OS und Supervised auch die Apps.
Was geprüft wird
- Verwaist: seit Jahren kein Commit, auf GitHub archiviert, Repository gelöscht, aus dem HACS-Store entfernt oder auf der HACS-Sicherheitsliste
- Ungenutzt: eine Karte, die auf keinem Dashboard steht, eine Integration ohne Config-Eintrag, ein Theme, das niemand ausgewählt hat, ein python_script, das niemand aufruft
- Altlasten: Lovelace-Ressourcen, die auf nicht mehr vorhandene Dateien zeigen, und Ordner, die HACS nicht kennt
- Defekte Einrichtung: fehlgeschlagene Config-Einträge, Integrationen, die eine erneute Anmeldung verlangen, und Reparaturmeldungen von Home Assistant
Ein Urteil „verwaist“ oder „ungenutzt“ ist ein Hinweis und keine Tatsache. Wo sich bei einer Karte nicht feststellen lässt, ob sie genutzt wird, lautet die Antwort „nicht feststellbar“ und nie „ungenutzt“.
Datenquellen
HACS im laufenden Prozess, der öffentliche HACS-Store-Index, optional GitHub für Archivierung und neueste Releases sowie die eigene Installation. Ein GitHub-Token ist optional und braucht keine Berechtigungen; ohne Token erlaubt GitHub 60 Anfragen pro Stunde, was für eine tägliche Prüfung reicht, der erste Lauf dauert dann länger. Außer zwei lesenden Anfragen verlässt nichts den Rechner.
Umfang
- 19 Regeln beim Start, jede abschaltbar, umgewichtbar und mit eigenem Schwellwert
- ein Panel mit acht Ansichten und eine Lovelace-Karte, die sich selbst registriert
- neun Sensoren, ein Binärsensor und ein Schalter, der den Zeitplan pausiert
- Benachrichtigungen über SMTP, Telegram, Pushover, ntfy oder jeden Home-Assistant-Dienst, mit Schweregraden und Ruhezeiten
- elf Sprachen
Installation
Voraussetzung ist Home Assistant 2026.1.0 oder neuer. In HACS https://github.com/sphings79/integrationguard-home-assistant als benutzerdefiniertes Repository vom Typ „Integration“ hinzufügen, herunterladen, neu starten und unter Geräte & Dienste einrichten. Apps werden nur unter Home Assistant OS oder Supervised bewertet.
Was es absichtlich nicht tut
IntegrationGuard aktualisiert nichts, deinstalliert nichts und bewertet keine Core-Integrationen; ob eine laufen, wird aber beobachtet. Ob ein Gerät antwortet, ist die Aufgabe von StateGuard. Das Projekt ist inoffiziell und steht nicht in Verbindung mit dem Home-Assistant-Projekt, Nabu Casa, HACS oder GitHub. Die Credits für HACS (Joakim Sørensen und Mitwirkende) stehen im README.