Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

Repository files navigation

Multi-Site Panel für Home Assistant

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).

Installation

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:

  1. Home Assistant neu starten.
  2. Einstellungen → Geräte & Dienste → Integration hinzufügen → „Multi-Site Panel“.
  3. 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.

Umstieg von der YAML-Variante (Version 0.1)

  1. Integration wie oben installieren, noch nicht einrichten.
  2. In /homeassistant/art_configs/multisite_panel.yaml den Block panel_custom: löschen (der Helfer input_boolean darf bleiben, siehe beispiel/art_configs/; input_select.heizsaison braucht es seit 0.4 nicht mehr).
  3. Die alte Datei /homeassistant/www/art_custom/multisite-panel.js löschen und, falls angelegt, die Dashboard-Ressource /local/art_custom/multisite-panel.js entfernen. Sonst lädt der Browser die alte Version und die neue kann sich nicht anmelden.
  4. Home Assistant neu starten, dann die Integration hinzufügen. art_custom/multisite-panel.yaml wird dabei übernommen und kann danach als Sicherung liegen bleiben.

Editor

  • 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.

Lagepläne

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:

  1. „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.
  2. Unten ein Licht suchen und auswählen, dann ins Bild tippen, wo es sitzt.
  3. 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.

Als Startseite der iPhone-App

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.

  1. Neues Dashboard „Start“ anlegen, im Rohkonfigurationseditor:
    views:
      - type: panel
        cards:
          - type: custom:multisite-start
            ziel: /zuhause
  2. 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.

Struktur in Home Assistant

  • 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 favorit geben.
  • Was noch keinem Raum zugeordnet ist, zeigt Orte → Nicht zugeordnet (nur für Admins).

Konfiguration

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.

Eigene Daten und das Repository

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.

Update

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.

Lokale Vorschau ohne Home Assistant

powershell -ExecutionPolicy Bypass -File .\werkzeuge\vorschau-server.ps1
  • http://localhost:8765/dev/vorschau.html: die App (?hell oder ?dunkel erzwingt das Farbschema).
  • http://localhost:8765/dev/editor.html: der Editor. Gespeichert wird in den Browser-Speicher; dev/vorschau.html?speicher im selben Browser zeigt Änderungen live. ?zuruecksetzen stellt 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.

Grenzen

  • Der Filter benutzer ist 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.

Aufbau

  • 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 entgegen
    • frontend/multisite-panel.js: die App (eine Datei, kein Build-Schritt)
    • frontend/multisite-editor.js: der Editor
    • frontend/multisite-start.js: die Startseiten-Karte
    • brand/: Symbol für die Integrationsseite
  • hacs.json: für die Installation über den Marketplace
  • beispiel/: Helfer-Paket (art_configs/) und Beispielkonfiguration (art_custom/), erfunden
  • dev/: lokale Vorschau von App und Editor mit erfundenen Beispieldaten
  • werkzeuge/: Kopier-Skript und Vorschau-Server

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages