ATLAS Plugins
Diese Rubrik sammelt alles, was nicht den ATLAS-Kern selbst beschreibt, sondern installierbare Erweiterungen: Plugin-Verträge, Repository-Format, Veröffentlichung, Update-Verhalten und einzelne Plugin-Seiten.
Entwicklungsstand
Die Plugin-Schnittstellen sind noch in Arbeit. Die Seiten dokumentieren den aktuellen ATLAS-Stand und werden mit stabileren Verträgen weiter ausgebaut.
Einstieg
- Repository-Format: Struktur einer
repository.json, Pflichtfelder, ATLAS-Kennung und Beispiel. - Plugin-Vorlage: Vorlage verwenden, Plugin anpassen, Paket bauen und veröffentlichen.
- Plugin-Entwicklung: Aufbau, Manifest, Runtime-Lebenszyklus und Veröffentlichung eigener Plugins.
- Geprüfte Plugins: kompakte Listen geprüfter und neuer ungeprüfter ATLAS-Plugins.
- Home Assistant Card Editor: erstes offizielles ATLAS-Referenz-Plugin.
- ATLAS File Studio: zweites unabhängiges ATLAS-Plugin für freigegebene Home-Assistant-Dateipfade.
- ATLAS Icon Studio: Iconsets verwalten, importieren und in Home Assistant speichern.
- ATLAS Icon Bibliothek: Iconsets durchsuchen und vollständige Icon-Namen kopieren.
- ATLAS Terminal: authentifiziertes Browser-Terminal mit optionalem SSH-Ziel, Oh-My-Posh-Themes und serverseitig geladener Nerd Font.
- ATLAS Automation Exporter / Editor: neues Plugin zum Analysieren, sicheren Sichern und Exportieren von Home-Assistant-Automationen.
- Demo-Repository: öffentliches Test-Repository für Administration, Hub und Installationsfluss.
Plugin-Version sichern und wiederherstellen
Ab ATLAS 0.1.304:
- Zuerst HA/ATLAS und eigene Plugin-Daten vollständig sichern.
- Im Plugin-Manager ein vorhandenes Plugin-Paket importieren und die Vorschau mit alter/neuer Version und Fähigkeiten prüfen.
- „Sichern und übernehmen“ erstellt vor dem Ersetzen eine serverseitige Rücksicherung. Ungeklärte Kompatibilität ausdrücklich prüfen; inkompatible Pakete bleiben gesperrt.
- Für eine Rückkehr beim Plugin „Wiederherstellen“ wählen, Sicherung und Versionsrichtung prüfen und übernehmen. Auch der gerade installierte Stand wird dabei gesichert.
Browserdaten und Datenformate werden damit nicht zurückgesetzt. Ein älteres Plugin muss zum vorhandenen Datenformat passen. Grenzen und Sicherungspfad. Die Oberfläche ist isoliert und auf Pi 5 und Proxmox mit Icon Bibliothek, File Studio und Terminal geprüft; andere Plugins und Datenmigrationen brauchen eigene Prüfungen.
Ziel
ATLAS-Plugins sollen die Plattform erweitern, ohne Kernpakete direkt zu verändern. Dazu gehören Home-Assistant-nahe Werkzeuge, Card-Editoren, Diagnoseflächen, Renderer, Themes, Provider und später auch Community-Erweiterungen.
Lebenszyklus
Ein Plugin soll nachvollziehbar installiert, geprüft, aktiviert, aktualisiert und entfernt werden können:
- Manifest lesen
- Abhängigkeiten prüfen
- Plugin registrieren
- Services, Commands oder UI-Flächen bereitstellen
- Aktivieren
- Diagnose- und Statusdaten melden
- Deaktivieren oder sauber entfernen
Aktueller technischer Anker
Der aktuelle Einstieg ist der Runtime-Adapter. Ein RuntimePlugin kann mit createRuntimeModuleFromPlugin() in ein ATLAS-Runtime-Modul übersetzt werden. RuntimePluginCatalog stellt die Discovery-Fläche bereit, während die Administration Plugins sichtbar macht, Versionen vergleicht und lokale Installationen vorbereitet.
Der Plugin-Hub folgt inzwischen einer klaren Startregel: Wenn keine Plugins installiert sind, verweist er auf die Administration. Bei genau einem aktiven Plugin öffnet ATLAS dieses Plugin direkt. Bei zwei oder mehr aktiven Plugins zeigt ATLAS die Auswahlseite. Geplante oder deaktivierte Plugins dürfen sichtbar sein, werden aber nicht automatisch gestartet.
Der Plugin-Hub kann außerdem Seitenleisten-Einträge für Home Assistant vorbereiten. Der Dialog listet die aktuellen Plugins dynamisch, zeigt Name, URL, Version, Status und Icon-Vorschlag und kopiert wahlweise nur die URL oder einen fertigen panel_iframe-Block für die configuration.yaml. Die URL-Kopie ist für Home-Assistant-Dashboards vom Typ Webseite gedacht. Lange Fähigkeitslisten und Seitenleisten-URLs bleiben auf Plugin-Karten standardmäßig eingeklappt, damit der Hub auch mit vielen Plugins kompakt bleibt.
Card Editor, Administration und lokale Plugin-Assets werden im Add-on-Betrieb über ATLAS-App-Routen ausgeliefert. Dadurch bleiben Home-Assistant-Ingress-Basispfade in Hub- und Seitenleisten-URLs erhalten und andere Rechner im Netzwerk müssen die separaten Entwicklungsports nicht direkt erreichen.
Gemeinsame Spracheinstellung
Administration und Plugin-Hub unterstützen Deutsch, Englisch und Französisch. Eine in einer der beiden Oberflächen gewählte Sprache wird gespeichert und auch auf der anderen Oberfläche verwendet, selbst wenn beide über getrennte Ports laufen. Ein expliziter language-Parameter in einer Plugin-URL überschreibt diese Voreinstellung für den jeweiligen Aufruf.
Für ATLAS File Studio nutzt der Hub die Plugin-URL unter /plugin-assets/file-studio/index.html am ATLAS-App-Port beziehungsweise über die entsprechende Home-Assistant-Ingress-/Webseiten-Adresse. Diese URL wird auch dann vorbereitet, wenn ein älterer gespeicherter Plugin-Stand noch keine Start-URL enthält.
Neue lokale Plugins bekommen ebenfalls automatisch eine Start-URL, wenn ihr Plugin-Ordner eine index.html enthält und im Manifest kein entry gesetzt ist. ATLAS veröffentlicht dann /plugin-assets/<plugin-ordner>/index.html, sodass Nutzer direkt zwischen Hub und Home-Assistant-Seitenleiste wählen können.
Veröffentlichungsregeln
Veröffentlichbare Plugins brauchen eindeutige Namen, klare Versionsangaben, dokumentierte Abhängigkeiten, sichere Demo- oder Fallback-Daten, nachvollziehbare Build-Artefakte und Hinweise für ATLAS, Home Assistant oder HACS-nahe Nutzung.
Automation Exporter / Editor
Der ATLAS Automation Exporter / Editor ergänzt die Plugin-Sammlung um Werkzeuge zum Erkennen von Automationen, Anzeigen ihrer Abhängigkeiten, Erstellen einer Sicherheitskopie beim Lesen und Exportieren einer Export-Version mit ID sowie einer bereinigten Import-Version ohne ID für den Home-Assistant-YAML-Editor.