Shelly Script Studio: Eigene Logik direkt auf dem Gerät programmieren

Was ist das Shelly Script Studio?

Das Shelly Script Studio ist die lokale Programmierumgebung für Shelly-Geräte der Plus und Pro-Serie. Diese Geräte verfügen über eine integrierte JavaScript-Engine, die auf Espruino basiert und damit sehr nah am Standard-JavaScript liegt. Du kannst also mit bekannten Sprachstrukturen arbeiten, um eigene Automationen zu erstellen – direkt auf dem Gerät, ohne externe Systeme. Der große Vorteil: Die gesamte Logik läuft lokal. Das bedeutet kurze Reaktionszeiten, Unabhängigkeit von Internetverbindungen und keine Cloud-Abhängigkeit. Das ist ideal für alle, die maximale Kontrolle und Datenschutz im eigenen Smart Home wünschen. Unterstützt werden ausschließlich Shelly-Geräte der Plus- und Pro-Serien. Das sind beispielsweise der Shelly Plus 1, Plus 2PM oder Pro 4PM. Diese Modelle besitzen genug Rechenleistung und Speicher, um Skripte lokal auszuführen.

Einrichtung und Start eines Shelly-Skripts

Bevor du dein erstes Skript schreibst, musst du dein Shelly-Gerät korrekt einrichten. Das geht schnell und einfach:

1. Gerät verbinden: Versorge deinen Shelly Plus oder Pro mit Strom und verbinde ihn über WLAN mit deinem Heimnetzwerk. Das geht am einfachsten über die Shelly-App.
2. Weboberfläche öffnen: Rufe die IP-Adresse deines Geräts im Browser auf, zum Beispiel http://192.168.x.x.
3. Skript anlegen: Navigiere im Menü zu „Skripte“ und erstelle ein neues Skript. Gib ihm einen Namen und füge deinen JavaScript-Code in das Textfeld ein.
4. Skript starten: Speichere das Skript und klicke auf „Start“. Optional kannst du die Debug-Ausgabe über Websocket aktivieren, um Konsolenausgaben live zu verfolgen.
5. Autostart aktivieren: Damit das Skript bei jedem Neustart automatisch läuft, aktiviere die Option „Bei Neustart starten“.

So läuft dein Code dauerhaft und unabhängig auf dem Gerät. Diese lokale Ausführung ist besonders nützlich, wenn du zeitkritische Aufgaben oder Sicherheitsfunktionen umsetzen willst, die nicht von einer Cloud oder externen Steuerung abhängen dürfen.

Beispielprojekte: Logik direkt auf dem Gerät

Ein großer Vorteil der Shelly Script Engine ist ihre Flexibilität. Mit ein paar Zeilen Code kannst du aus einem simplen Relaismodul eine vollautomatische Steuerungseinheit machen. Hier zwei praxisnahe Beispiele, die ich selbst in meinem Smart Home umgesetzt habe:

Feuchtigkeitsgesteuerte Lüftung

Ein Shelly H&T misst die Luftfeuchtigkeit im Badezimmer. Ein Shelly Plug S steuert den Ventilator. Das Skript prüft regelmäßig den Feuchtigkeitswert: Ist der Grenzwert überschritten, schaltet sich der Ventilator automatisch ein. Sobald die Luftfeuchtigkeit wieder unter einen definierten Schwellenwert fällt, wird der Ventilator ausgeschaltet. Mit einer kleinen Hysterese vermeidest du ständiges Ein- und Ausschalten.

Windbasierte Markisensteuerung

Ein Shelly Plus 2PM steuert eine Markise. Über eine Wetter-API oder einen angeschlossenen Windsensor wird regelmäßig die Windgeschwindigkeit abgefragt. Überschreitet diese einen bestimmten Wert, fährt die Markise automatisch ein, um Schäden zu vermeiden. Bei schwächerem Wind bleibt sie ausgefahren. Dieses Beispiel zeigt besonders gut, wie leistungsfähig Shelly-Skripte sind – du kannst externe Datenquellen einbinden, Bedingungen definieren und Reaktionen steuern, alles lokal auf dem Gerät.

Vorteile und Grenzen des Shelly Script Studio

Die Shelly Script Engine ist ein mächtiges Werkzeug, das viele Automatisierungsaufgaben direkt auf dem Gerät ermöglicht. Aber wie immer im Smart Home gilt: Es gibt Stärken und Schwächen.

Vorteile

• Vollständige Offline-Funktion: Du bist unabhängig von Cloud-Diensten, Internet oder zentralen Servern.
• Schnelle Reaktionszeiten: Da alles lokal läuft, reagiert dein System nahezu verzögerungsfrei.
• Hohe Ausfallsicherheit: Selbst wenn dein WLAN oder dein Home Assistant ausfällt, laufen die Skripte weiter.
• Offene Schnittstellen: REST, MQTT und CoAP machen die Integration in bestehende Systeme wie Home Assistant oder Node-RED einfach.
• Flexible Logik: Du kannst komplexe Bedingungen abbilden, die über einfache Wenn-Dann-Regeln hinausgehen.

Nachteile

• Programmierkenntnisse erforderlich: Ohne Grundkenntnisse in JavaScript wird es schwierig, eigene Logiken zu entwickeln.
• Nur für Plus- und Pro-Geräte: Ältere Shelly-Modelle unterstützen keine Skripte.
• Isolierte Logik: Skripte laufen nur auf dem jeweiligen Gerät – eine zentrale Übersicht fehlt bislang.
• Fehleranfälligkeit: Ein fehlerhaftes Skript kann das Gerät blockieren oder zum Absturz bringen.
• Kein grafischer Editor: Anders als in Home Assistant gibt es keine visuelle Oberfläche für Automationen.

Trotz dieser Einschränkungen bietet das Shelly Script Studio eine enorme Freiheit – besonders für fortgeschrittene Nutzer, die ihre Automatisierungen bis ins Detail selbst gestalten möchten.

Fehlersuche und Debugging-Tipps

Wenn ein Skript nicht wie erwartet läuft, ist das kein Grund zur Panik. Shelly bietet einige nützliche Werkzeuge zum Debuggen.

Websocket-Debugging aktivieren

Im Webinterface deines Shelly findest du im Skript-Bereich die Option „Debug über Websocket“. Aktivierst du sie, kannst du Konsolenausgaben in Echtzeit verfolgen. So erkennst du schnell, an welcher Stelle dein Code hängt oder falsche Werte liefert.

Schrittweise testen

Gerade bei komplexeren Automationen lohnt es sich, deinen Code in kleinen Schritten zu testen. Setze gezielt print()-Ausgaben, um Werte zu prüfen oder Abläufe zu kontrollieren. So findest du Fehler deutlich schneller.

Firmware aktuell halten

Shelly verbessert seine Script Engine regelmäßig. Ein Firmware-Update kann also nicht nur neue Funktionen bringen, sondern auch Probleme mit bestehenden Skripten lösen.

Community-Ressourcen nutzen

Die Shelly Knowledge Base, das offizielle Forum oder GitHub bieten eine Vielzahl an Beispielen und Hilfestellungen. In Smart-Home-Communities tauschen sich viele Anwender über ihre Skripte aus – eine echte Fundgrube für Inspiration und Lösungen.

Kosten und Zukunftsaussichten

Ein weiterer Pluspunkt: Die Nutzung der Shelly Script Engine ist kostenlos. Es gibt keine Lizenzgebühren oder Abos – die Funktion ist Teil der Firmware. Die einzigen Kosten entstehen durch die Hardware selbst, und die ist im Vergleich zu anderen Smart-Home-Komponenten sehr günstig. Ein einfaches Modul wie der Shelly 1 kostet etwa 15–20 €, während leistungsfähigere Modelle wie der Shelly Pro 4PM im Bereich von 40–60 € liegen. Spannend ist auch der Blick in die Zukunft: Shelly entwickelt das Scripting-Ökosystem stetig weiter. Neben einer wachsenden Skriptbibliothek und der Shelly Academy bietet der Hersteller inzwischen auch Schulungen und Tutorials an, um den Einstieg zu erleichtern. Und mit der neuen Gen4-Serie geht Shelly noch einen Schritt weiter – hier sind Matter und Zigbee bereits integriert, und die Geräte unterstützen Wi-Fi 6. Damit wird die lokale Automatisierung noch vielseitiger und performanter. Für ältere Modelle gibt es sogar eine Matter Bridge, sodass auch bestehende Geräte in moderne Ökosysteme eingebunden werden können. Damit zeigt Shelly deutlich: Lokale Automatisierung bleibt ein zentraler Bestandteil der Produktstrategie.