Wer Home Assistant über Jahre betreibt, kennt das schleichende Chaos: Eine ausgemusterte Steckdose taucht noch in drei Automationen auf, ein umbenanntes Gerät hinterlässt verwaiste Entitäten, und niemand weiss mehr, welche Skripte auf etwas verweisen, das es längst nicht mehr gibt. Genau hier setzt Spook an – eine inoffizielle, aber enorm mächtige Erweiterung des HA-Kernentwicklers Franck Nijhof (Frenck). Spook bringt Dutzende zusätzliche Dienste und Diagnosen, die das System aufräumen und Dinge ermöglichen, die Home Assistant ab Werk nicht kann.
Das Problem: Karteileichen im Setup
Mit jedem neuen Sensor, jeder Integration und jedem Experiment wächst die Zahl der Verweise. Löscht man ein Gerät, bleiben oft Referenzen in Automationen, Skripten und Dashboards zurück. Home Assistant warnt darüber nur sehr begrenzt. Das Ergebnis sind Automationen, die still scheitern, weil sie eine Entität ansprechen, die «unavailable» oder ganz verschwunden ist. Solche Fehler sind ärgerlich, weil sie selten laut krachen – sie funktionieren einfach nicht mehr, ohne dass man es merkt.
Spook macht diese blinden Flecken sichtbar. Die Integration durchsucht Automationen, Skripte und Szenen nach Verweisen auf nicht mehr existierende Entitäten, unbekannte Bereiche (Areas), Labels oder Etagen (Floors) und meldet sie gesammelt im Reparaturen-Dashboard unter Einstellungen. Statt mühsam jede Automation einzeln zu prüfen, bekommt man eine saubere Liste der Problemstellen.
Installation über HACS
Spook wird als Custom Repository über den Home Assistant Community Store installiert. Der Ablauf ist kurz:
1. HACS öffnen → nach "Spook" suchen
2. Spook herunterladen
3. Home Assistant neu starten
4. Einstellungen → Geräte & Dienste → Integration hinzufügen
5. "Spook" auswählen und einrichten
Nach dem Neustart erscheinen die zusätzlichen Dienste automatisch in den Entwicklerwerkzeugen unter «Aktionen»; sie tragen alle das Präfix spook. und sind damit leicht zu finden. Ein Blick ins Reparaturen-Dashboard zeigt sofort, ob Spook erste tote Verweise gefunden hat. Spook installiert übrigens keine eigene Hardware-Integration – es legt sich wie eine Diagnose- und Werkzeugschicht über das bestehende System und lässt sich jederzeit wieder entfernen.
Aufräumen per Service
Der eigentliche Mehrwert sind die neuen Aktionen. Spook erlaubt es zum Beispiel, Bereiche, Labels und Etagen programmatisch zu verwalten – also direkt aus einer Automation heraus zu erstellen, umzubenennen oder zuzuweisen. Das folgende Beispiel legt beim Start automatisch ein Label an und ordnet es einer Entität zu:
automation:
- alias: "Spook - Wartungs-Label setzen"
trigger:
- platform: homeassistant
event: start
action:
- action: spook.label_create
data:
name: "Wartung"
icon: "mdi:wrench"
- action: homeassistant.update_entity
target:
entity_id: sensor.shelly_plus_1pm_verbrauch
Besonders praktisch ist der gezielte Aufräum-Service für verwaiste Einträge. Wer eine ausgemusterte Integration entfernt hat, kann die zurückgebliebenen Entitäten gebündelt loswerden, statt jede einzeln aus der Registry zu klicken:
script:
alte_entitaeten_entfernen:
sequence:
- action: spook.entity_remove
target:
entity_id:
- sensor.alter_temperatursensor
- switch.ausrangierte_steckdose
Daneben bietet Spook Möglichkeiten wie das Importieren von Werten in die Historie oder Test-Entitäten zum Ausprobieren von Automationen – nützlich, wenn man eine Logik bauen will, bevor die echte Hardware da ist. Eine vollständige Übersicht aller Aktionen liefert die Spook-Dokumentation; es lohnt sich, dort gezielt nach den Diensten für Areas, Labels und Floors zu schauen.
Vorsicht ist angebracht
Spook ist mächtig – und genau deshalb mit Bedacht einzusetzen. Es greift in System-Registries ein und kann bei falscher Anwendung Dinge unwiderruflich verändern. Ein aktuelles Backup vor dem ersten ernsthaften Aufräumen ist Pflicht; wie eine solide Sicherung aussieht, beschreibt der Beitrag Update-Center in HA: alle Firmware-Updates an einem Ort im Kontext der laufenden Wartung. Wer die Entfern-Dienste nutzt, prüft die Entitätsliste zweimal, bevor er sie ausführt – einmal gelöschte Verweise sind weg.
Fazit
Spook ist kein Spielzeug, sondern ein Werkzeugkasten für alle, deren Home-Assistant-Installation über die Jahre gewachsen und unübersichtlich geworden ist. Das Reparaturen-Dashboard deckt tote Verweise auf, die Dienste räumen sie weg, und die Verwaltung von Areas, Labels und Floors per Automation eröffnet Möglichkeiten, die der Kern nicht bietet. Wer das System sauber halten will, installiert Spook, lässt einmal die Reparaturen durchlaufen – und staunt meist, wie viele Karteileichen sich angesammelt haben. Mit einem frischen Backup im Rücken wird daraus ein entspanntes Frühlingsputz-Ritual für die Smart-Home-Zentrale.