Floorplan in Home Assistant einbauen
Vom leeren Canvas bis zum funktionierenden Dashboard. In 15 Minuten. Ohne Vorkenntnisse.
Grundriss zeichnen
Öffne den Floorplan-Editor. Du siehst ein leeres Canvas mit Raster.
Im Topbar: vier Tools. Auswählen für Klicks und Verschieben. Rechteck für viereckige Räume: klick und zieh. Polygon für freie Formen, Ecken einzeln setzen. Ecken, um die Eckpunkte eines schon gezeichneten Raums zu verschieben.
Tipp: Erst Außenwände, dann Innenwände. Räume dürfen sich Kanten teilen, der Editor klebt die Vertices nicht automatisch zusammen, aber Snap-to-Grid (10px) sorgt für saubere Übergänge.
Mehrere Etagen? Topbar → + Etage. Jede Etage hat ihre eigenen Räume und Geräte.
Geräte platzieren
Linke Sidebar: neun Entity-Typen. Klick auf einen Typ, eine Entity erscheint in der Canvas-Mitte. Mit dem Auswählen-Tool kannst du sie an die richtige Stelle ziehen.
In der rechten Sidebar kannst du dann anpassen:
- Entity-ID: deine echte HA-ID wie
light.wohnzimmer_decke - MDI-Icon: der Icon-Name ohne
mdi:-Prefix, alsoceiling-light,blinds,thermometer - Animation: 10 Presets (Glow, Pulse, Slide, Fade, Bounce, Shake, Rotate, Breathe, Ripple, Keine), wird in ha-floorplan ausgeführt
Die Entity-IDs müssen exakt mit denen in deinem HA übereinstimmen, sonst klappt der Tap-to-Toggle nicht.
Export wählen
Topbar oben rechts → Exportieren. Zwei Modi:
SVG, YAML und CSS. Animationen, Hover-Effekte auf Entities, Raum-Beleuchtung bei eingeschaltetem Licht. Braucht HACS oder manuelles Setup. Mehr Wow-Effekt.
PNG und YAML. Native HA-Karte, keine HACS nötig. Statisches Bild mit gestylten State-Icons (runde Chips mit Schatten). Einfacher.
Du kriegst ein ZIP. Drin: alle Dateien plus eine anleitung.html mit den Installation-Schritten, falls du diese Anleitung gerade verlierst.
In Home Assistant einbauen
- Dateien hochladen. Per Samba, File Editor oder Studio Code Server nach
/config/www/floorplan/kopieren. Falls der Ordner nicht existiert: anlegen. - HACS-Setup (nur für ha-floorplan-Modus): HACS, Frontend,
ha-floorplansuchen, installieren, HA neu starten. Für Picture-Elements überspringst du das. - Karte anlegen. Dashboard öffnen, Bearbeiten, "Karte hinzufügen", ganz unten "Manuell".
- YAML einfügen. Inhalt von
floorplan.yaml(ha-floorplan) oderpicture-elements.yaml(Picture-Elements) reinkopieren. Speichern.
Fertig. Deine Räume und Geräte sind jetzt live auf dem Dashboard.
Dein Floorplan ist jetzt auf dem Dashboard. Die folgenden Abschnitte sind Referenz-Material für später.
HACS vs. ohne HACS
Picture-Elements ist nativ in HA, kein HACS, keine Custom-Cards. Empfehlung wenn du grad startest.
ha-floorplan braucht entweder HACS oder ein manuelles Setup mit Custom Resource. Dafür Animationen, Hover-Effekte auf Entities und visuelles Raum-Glow bei eingeschaltetem Licht.
Manuelle Installation ohne HACS:
- Lad die neueste ha-floorplan-Release herunter.
- Entpack
ha-floorplan.jsnach/config/www/community/ha-floorplan/. - Einstellungen, Dashboards, 3-Punkt-Menü, Ressourcen, "Ressource hinzufügen".
- URL:
/local/community/ha-floorplan/ha-floorplan.js, Typ: JavaScript-Modul. - HA neu starten. Fertig.
Editor-Features im Überblick
Der Editor hat mehr als nur Zeichenwerkzeuge. Hier die wichtigsten Features:
Notion-Clean, Dark, Midnight, Nordic, Sunset. Per Dropdown im Topbar.
Theme-Presets oder eigene Farbe per Color-Picker.
PNG/JPG hochladen (max. 10 MB), halbtransparent drüberzeichnen.
Cmd/Ctrl+Z. Bis zu 50 Schritte zurück.
V/P/R/E für Tools, Delete, Space+Maus zum Panning.
Cmd/Ctrl+C/V. Duplikat erscheint 20px versetzt.
Unabhängige Etagen. Per Dropdown kopierbar.
13 Typen mit Resize-Handles an Ecken und Kanten.
Parkett, Fliesen, Teppich, Stein, Beton als SVG-Pattern.
Lampen amber, Sensoren teal, Rollos blau, Mediaplayer violett.
Long-Lived-Token, echte Geräte laden. Token bleibt im Browser-Tab.
Troubleshooting
Karte zeigt nur ein leeres Quadrat
Pfad in der YAML stimmt nicht. Prüf, ob die Dateien wirklich in /config/www/floorplan/ liegen und der Pfad im YAML matched.
Geräte reagieren nicht auf Klicks
Entity-ID falsch geschrieben. Geh in HA, Entwicklerwerkzeuge, Status, und kopier die ID 1:1.
Animationen laufen nicht (ha-floorplan)
Die floorplan.css wurde nicht mit hochgeladen, oder der stylesheet-Pfad in der YAML zeigt ins Leere.
Mein Custom-Icon erscheint nicht
MDI-Icon-Name prüfen auf pictogrammers.com/library/mdi/ — Tippfehler sind häufig.
Entities sind schwarz statt farbig
Die CSS-Variablen werden nicht geladen. Im ha-floorplan-Export müssen SVG, CSS und YAML zusammen in /config/www/floorplan/ liegen.
Bereit?
Editor öffnen, Grundriss zeichnen, exportieren. Komplett kostenlos.
