Home Assistant

Skripte in HA: wiederverwendbare Bausteine

Wer länger mit Home Assistant arbeitet, kennt das Problem: Dieselbe Abfolge von Aktionen taucht in fünf Automationen leicht abgewandelt wieder auf. Eine TTS-Ansage hier, eine Benachrichtigung dort, ein Licht-Reset überall. Sobald sich etwas ändert, muss man jede Kopie einzeln anpassen. Die elegante Lösung heisst Skript – eine wiederverwendbare Sequenz, die Sie einmal definieren und mit Parametern aus beliebig vielen Stellen aufrufen.

Die Idee: Automationen ohne Auslöser

Ein Skript ist im Grunde eine Automation ohne Trigger. Es enthält nur den sequence-Block – also das, was passieren soll. Aufgerufen wird es manuell, von einer Automation, von einem Dashboard-Button oder von einem anderen Skript. Damit zentralisieren Sie Logik an einem einzigen Ort. Ändern Sie das Skript, profitieren sofort alle Aufrufer.

Richtig mächtig werden Skripte durch Felder (fields). Damit übergeben Sie beim Aufruf Variablen, etwa welcher Lautsprecher sprechen soll oder welcher Text angesagt wird. Aus einem starren Ablauf wird so ein konfigurierbarer Baustein – ein Skript, viele Einsatzzwecke.

Schritt für Schritt: ein TTS-Ansage-Skript

Angenommen, Sie wollen überall im Haus Sprachansagen auslösen, mal über den HomePod, mal über einen Voice-Satelliten. Statt für jede Ansage eine eigene Automation zu bauen, definieren Sie ein generisches Skript mit zwei Feldern – Zielgerät und Nachricht:


script:
  ansage_universal:
    alias: Universelle Sprachansage
    fields:
      ziel:
        description: Media-Player für die Ansage
        example: media_player.homepod
        selector:
          entity:
            domain: media_player
      nachricht:
        description: Der anzusagende Text
        example: Die Waschmaschine ist fertig
        selector:
          text:
    sequence:
      - action: tts.speak
        target:
          entity_id: tts.home_assistant_cloud
        data:
          media_player_entity_id: "{{ ziel }}"
          message: "{{ nachricht }}"


Der Aufruf aus einer beliebigen Automation ist nun denkbar schlank:


      - action: script.ansage_universal
        data:
          ziel: media_player.homepod
          nachricht: >
            Achtung, die Bodenfeuchte im Garten ist niedrig.


Jede Variable, die Sie unter data mitgeben, steht im Skript als Template-Variable zur Verfügung – selbst dann, wenn Sie sie nicht als Feld definiert haben. Die fields dienen vor allem der sauberen Dokumentation und liefern in der Oberfläche praktische Eingabe-Selektoren.

Bausteine verschachteln und absichern

Skripte dürfen sich gegenseitig aufrufen. So bauen Sie aus kleinen, getesteten Einheiten grössere Abläufe – etwa ein Skript «Gute Nacht», das nacheinander ein Licht-Reset-Skript, eine Ansage und das Scharfstellen der Anwesenheitssimulation aufruft. Diese Modularität macht das Debugging erheblich einfacher, weil Sie jeden Baustein isoliert prüfen können.

Achten Sie auf den Ausführungsmodus (mode). Standardmässig läuft ein Skript im Modus single – ein zweiter Aufruf während der Ausführung wird ignoriert und erzeugt eine Warnung im Log. Für Ansagen ist oft queued oder restart sinnvoll, damit sich Aufrufe nicht in die Quere kommen. Und denken Sie an Robustheit: Fangen Sie mögliche unavailable-Zustände der Zielgeräte mit einer vorgelagerten condition ab, damit ein offline gegangener Lautsprecher nicht den ganzen Ablauf stoppt.

Ein Tipp aus der Praxis: Probieren Sie neue Skripte zuerst in den Entwicklerwerkzeugen unter «Aktionen» aus. Dort können Sie das Skript mit Testwerten aufrufen und sehen sofort, ob die Templates korrekt aufgelöst werden, bevor Sie es in eine Automation einbauen. Wer seine wiederkehrenden Tasten-Aktionen ebenfalls sauber strukturieren will, findet im Beitrag Event-Entitäten in HA: Tasten clever auslösen den passenden Gegenpart auf der Trigger-Seite.

Wer ein Skript über die eigene Installation hinaus teilen möchte, wirft einen Blick auf Blueprints: Seit Home Assistant 2026.4 gibt es sie nicht nur für Automationen, sondern auch für die Domänen script und template. Damit lässt sich ein gut gebauter Baustein als Vorlage exportieren und von anderen mit eigenen Werten befüllen.

Fazit

Skripte sind das vielleicht unterschätzteste Werkzeug in Home Assistant. Sie verwandeln kopierte Code-Fragmente in saubere, wartbare Bausteine und halten Ihre Konfiguration schlank. Beginnen Sie klein: Suchen Sie eine Aktionsfolge, die mehrfach vorkommt, giessen Sie sie in ein Skript mit Feldern und ersetzen Sie die Kopien durch schlanke Aufrufe. Ihr Setup wird übersichtlicher – und die nächste Änderung machen Sie nur noch an einer einzigen Stelle.

← Zurück zur Übersicht