Eine eigene, app-artige Oberfläche für Home Assistant, gedacht fürs iPhone: Sie fühlt sich an wie eine einfache Smart-Home-App eines Herstellers, läuft aber komplett lokal über dein Home Assistant und bringt mehrere Standorte (Hausnummern, Firma, Hallen) in einer App zusammen.
- Start: Begrüßung, Wetter, Hinweise (Tor offen, Waschmaschine fertig, Internet weg), Szenen, Favoriten, was gerade läuft, Solar jetzt
- Orte: Lagepläne mit Licht-Knöpfen, dann Standort → Etage → Raum mit Licht, Heizung, Rollläden, Geräten und Raumklima
- Energie: jeder Anschluss (Strom, Gas, Holz, Öl, Wasser, Brunnen, Internet) mit Werten, Tagesverlauf und welche Gebäude er versorgt, dazu alle Thermostate
- Sicherheit: Türen, Tore, Schlösser, Kameras und die Ereignisse von heute
Die Struktur kommt aus Home Assistant selbst (Etagen und Räume). Lichter, Thermostate, Rollläden usw. legt man im Panel nicht an: Sie erscheinen automatisch, sobald sie in Home Assistant einem Raum zugeordnet sind und die Etage des Raums zu einem Standort gehört.
Alles lässt sich als Entwurf vorbereiten: Standorte, Anschlüsse, Lagepläne, Geräte, Szenen, einzelne Zeilen und ganze Bereiche unten. Entwürfe sind in der App für alle ausgeblendet, bis man sie im Editor live schaltet.
Eingerichtet wird alles im Editor („Zuhause bearbeiten“ in der Seitenleiste, nur für Admins): links die Bereiche, in der Mitte die Formulare mit Suche nach Entitäten, rechts die echte App als Live-Vorschau. „Speichern“ schreibt direkt in Home Assistant, die App auf allen Geräten zeigt die Änderung sofort, ohne Neustart.
Für Home Assistant ab 2026.9, abgeglichen mit den Änderungen bis 2026.11 (Marketplace, Safe-Area bei eigenen Panels, neue Entitätsnamen).
Das Panel ist eine Integration (custom_components/multisite_panel). Sie meldet die App („Zuhause“, /zuhause) und den Editor („Zuhause bearbeiten“, /zuhause-editor) selbst an; YAML und Dashboard-Ressourcen braucht es nicht.
Über den Marketplace (ab HA 2026.11, früher HACS): Einstellungen → Marketplace → Aus Link hinzufügen → https://github.com/xAdler21/HomeAssistantMultiSitePanel. Dafür muss GitHub verbunden sein, und das Repository muss öffentlich sein; private Repositories kann der Marketplace nicht lesen.
Von Hand mit dem File-Editor- oder VS-Code-Add-on (Pfade wie dort, /homeassistant = /config): den Ordner custom_components/multisite_panel mit allen Dateien nach /homeassistant/custom_components/multisite_panel/ hochladen. Ist der Konfigurationsordner per Samba erreichbar, erledigt das werkzeuge/deploy.ps1.
Danach:
- Home Assistant neu starten.
- Einstellungen → Geräte & Dienste → Integration hinzufügen → „Multi-Site Panel“.
- In der Seitenleiste erscheinen „Zuhause“ und „Zuhause bearbeiten“.
Beim ersten Start übernimmt die Integration eine vorhandene /homeassistant/art_custom/multisite-panel.yaml (oder /homeassistant/multisite-panel.yaml). Danach liegt die Konfiguration in .storage/multisite_panel.config und ist in jedem HA-Backup enthalten.
- Integration wie oben installieren, noch nicht einrichten.
- In
/homeassistant/art_configs/multisite_panel.yamlden Blockpanel_custom:löschen (der Helferinput_booleandarf bleiben, siehebeispiel/art_configs/;input_select.heizsaisonbraucht es seit 0.4 nicht mehr). - Die alte Datei
/homeassistant/www/art_custom/multisite-panel.jslöschen und, falls angelegt, die Dashboard-Ressource/local/art_custom/multisite-panel.jsentfernen. Sonst lädt der Browser die alte Version und die neue kann sich nicht anmelden. - Home Assistant neu starten, dann die Integration hinzufügen.
art_custom/multisite-panel.yamlwird dabei übernommen und kann danach als Sicherung liegen bleiben.
- Bereiche: Allgemein, Standorte, Räume zuordnen, Lagepläne, Energie, Geräte, Szenen, Sicherheit, Benutzer und YAML.
- Räume zuordnen: alle Lichter, Schalter, Rollläden, Thermostate, Fühler, Medien, Schlösser und Kameras mit einer Raumauswahl. Die Auswahl wird sofort in Home Assistant gespeichert, ohne „Speichern“. Das Glühbirnen-Symbol schaltet ein Licht kurz um, damit man es vor Ort findet. Fehlende Räume und Etagen lassen sich dort direkt anlegen, neue Etagen gleich einem Standort zuordnen. Hat ein Gerät nur einen solchen Kanal, bekommt das ganze Gerät den Raum (seine Sensoren ziehen mit); bei mehreren Kanälen (z. B. zweikanaliger Aktor) nur der eine Kanal. In der App führt Orte → Nicht zugeordnet mit einem Knopf direkt dorthin.
- Entwurf/Live: Jeder Eintrag hat oben den Schalter „Live in der App“, jede Zeile und jedes Licht im Lageplan ein Auge-Symbol. Aus = Entwurf: in der App für alle unsichtbar, im Editor bleibt alles erhalten. Ganze Bereiche unten (Orte, Energie, Sicherheit) stehen unter Allgemein → Entwürfe. In der Vorschau blendet „Entwürfe zeigen“ sie ein oder aus.
- Entitäten sucht man per Name oder ID; unter dem Feld steht der aktuelle Wert oder ein Hinweis, wenn es die Entität nicht gibt. Listen zeigen fehlende Entitäten als Warnung.
- Etagen und Räume kommen als Auswahl direkt aus Home Assistant.
- Sortieren per Ziehen oder mit den Pfeilen, Rückgängig/Wiederholen mit Strg+Z/Strg+Y, Speichern mit Strg+S.
- Vorschau: zeigt passend zum Formular den richtigen Bereich der App. „als …“ zeigt die App so, wie ein bestimmter Benutzer sie sieht. Der Kasten darüber meldet Probleme der Einrichtung (fehlende Etagen, Räume, Entitäten).
- Standort-ID ändern zieht alle Verweise (Versorgung, Szenen, Benutzer, Lagepläne …) mit; beim Löschen eines Standorts werden die Verweise entfernt.
- YAML: die ganze Konfiguration als Text, zum Sichern, Kopieren oder Einfügen einer alten
multisite-panel.yaml. - Ungespeicherte Änderungen bleiben im Browser erhalten, falls man den Editor verlässt.
Die Vorschau ist die echte App mit echten Geräten: Antippen schaltet wirklich.
Ein Luftbild, Drohnenfoto oder eine Ansicht aus dem 3D-Modell des Areals, darauf die Lichter als runde Knöpfe. In der App unter Orte (und beim Standort, falls der Plan einem zugeordnet ist): mit zwei Fingern zoomen und verschieben, Tippen schaltet, gedrückt halten öffnet Helligkeit und Einstellungen. Ab doppelter Vergrößerung stehen die Namen an den Knöpfen.
Im Editor unter Lagepläne:
- „Lageplan“ anlegen und ein Bild hochladen (JPG, PNG oder WebP, bis 40 MB). Gut sind 4000 bis 8000 Pixel Breite; größere Bilder verkleinert der Editor vor dem Hochladen.
- Unten ein Licht suchen und auswählen, dann ins Bild tippen, wo es sitzt.
- Punkte lassen sich mit der Maus verschieben; mit der Lupe wird das Bild für genaues Platzieren größer. Neben Lichtern gehen auch Schalter, Ventilatoren und
input_boolean.
Die Bilder liegen in /homeassistant/multisite_panel/ (nicht unter www). Home Assistant liefert sie nur an angemeldete Benutzer aus; der Browser bekommt dafür eine signierte Adresse, die eine Woche gilt. Nicht mehr verwendete Bilder löscht die Integration einen Tag nach dem nächsten Speichern.
Home Assistant bietet eigene Panels nicht als Startseite an, nur Dashboards. Deshalb gibt es die kleine Karte multisite-start, die beim Öffnen der App einmal ins Panel weiterleitet. Die Integration lädt sie automatisch, eine Ressource ist nicht nötig.
- Neues Dashboard „Start“ anlegen, im Rohkonfigurationseditor:
views: - type: panel cards: - type: custom:multisite-start ziel: /zuhause
- Beim Dashboard ⋮ → Als Standard festlegen.
Zum Bearbeiten dieses Dashboards ?bleiben an die Adresse hängen, sonst springt es sofort weiter.
Für Familienmitglieder lässt sich die HA-Seitenleiste im Profil aufräumen. Oben links in der App öffnet ein Menü-Symbol die Seitenleiste. Wer es sieht, steht im Editor unter Allgemein (alle, nur Admins, niemand); unter Benutzer lässt es sich pro Person anders einstellen.
- Etage = ein Gebäude oder ein Stockwerk eines Gebäudes (Einstellungen → Bereiche → Etage hinzufügen), z. B. „Werkstatt“, „Büro“, „Halle Nord“.
- Räume den Etagen zuordnen, Geräte den Räumen (am schnellsten im Editor unter „Räume zuordnen“).
- Favoriten: Geräten das Label
favoritgeben. - Was noch keinem Raum zugeordnet ist, zeigt Orte → Nicht zugeordnet (nur für Admins).
Der Editor deckt alle Schlüssel ab; im YAML-Bereich sieht man sie als Text. Ein Beispiel mit Kommentaren liegt in beispiel/art_custom/multisite-panel.yaml.
| Schlüssel | Bedeutung |
|---|---|
standorte |
id, name, kurz, kuerzel, rolle, icon, etagen (ID oder Name), bereiche (Räume ohne Etage) |
plaene |
Lagepläne mit name, standort, bild (vom Editor vergeben), breite, hoehe, punkte (entity, x, y in Prozent, optional name, icon) |
wetter, aussentemperatur |
Wetter-Entität und Außenfühler für die Startseite |
favoriten_label, favoriten |
Label (Standard favorit) und/oder Liste von Entitäten |
versorgung |
Anschlüsse mit art, standorte, messung, leistung, solar, netz, *_heute, status, werte, versorgt, hinweis, geplant |
geraete |
Wasch-/Spülmaschine & Co. über status oder leistung + schwelle, optional restzeit, fortschritt, programm, mitteilung |
zugang, kameras, ereignisse |
zusätzliche Türen/Tore/Schlösser und Kameras; Ereignisse für „Heute“ |
szenen |
Szenen, Skripte oder Buttons auf der Startseite |
benutzer |
je HA-Benutzer standorte (leer = alle) und menue_knopf (ja/nein, überschreibt die allgemeine Einstellung) |
menue_knopf |
wer das Menü-Symbol für die HA-Seitenleiste sieht: alle (Standard), admins oder niemand |
ausblenden |
Entitäten, die nirgends erscheinen |
entwurf: true |
an jedem Listeneintrag (Standort, Anschluss, Zeile unter versorgt/werte, Gerät, Szene, Zugang, Kamera, Lageplan, Punkt, Benutzerregel): vorbereitet, aber in der App für alle ausgeblendet |
tabs_entwurf |
Bereiche unten, die noch Entwurf sind: orte, energie, sicherheit |
Leistungen dürfen in W oder kW kommen, Energie in Wh oder kWh, das Panel rechnet um.
Ins Repository gehört nur der Code. Alles Persönliche bleibt in Home Assistant oder im Ordner privat/, den Git ignoriert:
| was | wo |
|---|---|
| Konfiguration (Standorte, Adressen, Entitäten) | in HA: .storage/multisite_panel.config |
| Bilder der Lagepläne | in HA: /homeassistant/multisite_panel/, nur angemeldet abrufbar |
| eigene Daten für die lokale Vorschau | privat/vorschau-daten.js (gleicher Aufbau wie dev/demo-daten.js) |
| eigene YAML-Vorlage, alte Entwürfe | privat/ |
beispiel/ und dev/demo-daten.js enthalten nur erfundene Adressen und Geräte.
Marketplace: Update installieren, Home Assistant neu starten.
Von Hand: die Dateien in /homeassistant/custom_components/multisite_panel/ ersetzen. Wenn sich nur Dateien in frontend/ geändert haben, reicht Einstellungen → Geräte & Dienste → Multi-Site Panel → ⋮ → Neu laden; bei Python-Dateien ist ein Neustart nötig. Die Integration hängt das Dateidatum als ?v= an, deshalb lädt auch die iOS-App die neue Version.
Konfiguration und Lageplan-Bilder bleiben bei Updates erhalten.
powershell -ExecutionPolicy Bypass -File .\werkzeuge\vorschau-server.ps1
http://localhost:8765/dev/vorschau.html: die App (?helloder?dunkelerzwingt das Farbschema).http://localhost:8765/dev/editor.html: der Editor. Gespeichert wird in den Browser-Speicher;dev/vorschau.html?speicherim selben Browser zeigt Änderungen live.?zuruecksetzenstellt die Beispieldaten wieder her. Hochgeladene Bilder gibt es nur bis zum Neuladen. Der Mock kann kein YAML, im YAML-Bereich erscheint deshalb JSON.
Die Vorschau nimmt privat/vorschau-daten.js, wenn es die Datei gibt, sonst die erfundenen Daten aus dev/demo-daten.js; ?demo erzwingt die erfundenen. Die Icons kommen dabei aus dem Internet; Panel und Editor selbst brauchen kein Internet.
- Der Filter
benutzerist nur ein Sichtfilter. Home Assistant kennt (Stand 2026.11) keine Rechte pro Gerät; wer angemeldet ist, kann technisch alles schalten und in Verlauf und Logbuch alles sehen. Lagepläne ohne Standort sehen nur Benutzer ohne Einschränkung. - Kameras: Die Kacheln zeigen Standbilder, das Live-Bild öffnet sich im Kamera-Dialog von Home Assistant.
- Verlauf: Das Diagramm zeigt nur den heutigen Tag.
- Lagepläne sind Bilder, keine 3D-Ansicht. Aus einem 3D-Modell lässt sich eine Ansicht von oben oder schräg als Bild exportieren.
- Mitteilungen: Push-Mitteilungen (z. B. „Waschmaschine fertig“) laufen über HA-Automationen; ein Beispiel steht in
beispiel/art_configs/multisite_panel.yaml.
custom_components/multisite_panel/: die Integration__init__.py: meldet App, Editor und Startseiten-Karte an, speichert die Konfiguration, liefert sie per Websocket aus und nimmt Lageplan-Bilder entgegenfrontend/multisite-panel.js: die App (eine Datei, kein Build-Schritt)frontend/multisite-editor.js: der Editorfrontend/multisite-start.js: die Startseiten-Kartebrand/: Symbol für die Integrationsseite
hacs.json: für die Installation über den Marketplacebeispiel/: Helfer-Paket (art_configs/) und Beispielkonfiguration (art_custom/), erfundendev/: lokale Vorschau von App und Editor mit erfundenen Beispieldatenwerkzeuge/: Kopier-Skript und Vorschau-Server