SimpliSafe Smart-Home-Integration, kostenlos und Open Source

SimpliSafe-Alarmanlage über die Cloud: Scharfschalten, Sensoren, Smart Lock, Kameras, Klingel.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Holt deine SimpliSafe-Alarmanlage in Gladys, über die SimpliSafe-Cloud (die auch die SimpliSafe-App nutzt): den Alarmstatus (unscharf, scharf zu Hause, scharf abwesend, Ausgangs- und Eingangsverzögerung, Alarm), die Basisstation (online, Netzstrom, Notstrombatterie, Meldungen), jeden Sensor (Öffnung, Bewegung, Glasbruch, Rauch, Kohlenmonoxid, Wasser, Frost, Tastenfeld, Paniktaste, Sirene: Erkennung, Batterie schwach, online), das Smart Lock und die SimpliCam, Außenkameras und Video Doorbell Pro (Bild der letzten Bewegung oder des letzten Klingelns, Türklingel). Scharfschalten, Alarme, Türklingel und Schlösser kommen in Echtzeit über den WebSocket, den die App nutzt.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde nach der Arbeit der Home-Assistant-Integration simplisafe, der Bibliothek simplisafe-python und von homebridge-simplisafe3 geschrieben, ohne SimpliSafe-System oder -Konto zur Hand. Wenn etwas nicht wie beschrieben funktioniert, eröffne bitte ein Issue auf github.com/guim31/gladys-simplisafe/issues mit den Protokollen der Integration (LOG_LEVEL=debug).

Diese Integration ist nicht mit SimpliSafe verbunden. SimpliSafe ist eine Marke von SimpliSafe, Inc.

Was du brauchst

• Ein SimpliSafe-3-System (die aktuelle Generation, seit 2018 verkauft) und das SimpliSafe-Konto der App. Das kostenlose Abo reicht für die Zustände; aus der Ferne scharf und unscharf schalten braucht ein Abo mit Fernsteuerung.
• Die Bestätigung in zwei Schritten im Konto aktiviert (SimpliSafe-App, Einstellungen): ohne sie gibt SimpliSafe nie den Anmeldecode heraus, den die Integration braucht (das haben Home-Assistant-Nutzer festgestellt).
• Einen Computer mit Chrome oder Edge für die Anmeldung (einmalig).
• Gladys 5.1 oder neuer, mit Internetzugang.

Einrichtung

Öffne Integrationen → SimpliSafe → Konfiguration, wähle die Optionen unten, speichere und melde dich dann an. Öffne den Tab Entdecken und füge die gewünschten Geräte hinzu.

Anmeldung

SimpliSafe meldet über eine eigene Seite an, die den Browser danach zu einer Adresse schickt, die nur die mobile App öffnet (com.simplisafe.mobile://…). Der Browser zeigt nichts an, aber die Adresse erscheint in seinen Entwicklertools: Genau sie kopierst du in Gladys. Gladys sieht dein Passwort nie.

1. Klicke auf Verbinden neben SimpliSafe-Konto: Die SimpliSafe-Anmeldeseite öffnet sich in einem neuen Tab. Öffne in diesem Tab die Entwicklertools (F12, oder Cmd+Option+I auf dem Mac), Reiter Konsole.
2. Melde dich mit der E-Mail-Adresse und dem Passwort der SimpliSafe-App an und bestätige die Anmeldung (Code oder Link per E-Mail oder SMS).
3. Die Seite scheint danach nichts zu tun: Das ist normal. In der Konsole steht in einer roten Zeile etwa Failed to launch 'com.simplisafe.mobile://auth.simplisafe.com/ios/com.simplisafe.mobile/callback?code=…'. Kopiere diese Zeile, oder nur die Adresse.
4. Füge sie innerhalb weniger Minuten in die Aktion Anmeldung abschließen unten auf der Konfigurationsseite ein und starte sie. Die Antwort listet die gefundenen Systeme auf.

Nichts in der Konsole? Öffne vor der Anmeldung den Reiter Netzwerk: Die letzte, rote Zeile trägt die Adresse in ihrem Header Location. Bist du in diesem Browser schon bei SimpliSafe angemeldet, springt die Seite eventuell direkt ans Ende: Öffne ein privates Fenster und beginne erneut mit Verbinden. Ein Code gilt einmal und wenige Minuten; jedes Verbinden erzeugt eine neue Seite, und nur der Code der letzten funktioniert.

Einstellungen

• SimpliSafe-Konto: der Knopf Verbinden und der Status der Verbindung.

• Scharfschalten über Gladys:

  • Aus (nur Status), die Voreinstellung: Gladys zeigt den Alarmstatus an und ändert ihn nie;
  • Nur scharf schalten: Widget und Szenenaktion können scharf schalten (zu Hause, abwesend), nie unscharf;
  • Scharf und unscharf schalten: Wer deine Gladys-Dashboards und -Szenen nutzt, kann auch unscharf schalten. Unscharf schalten im Widget fragt nach einer Bestätigung.

  Warum standardmäßig aus: Mit professioneller Überwachung ruft eine versehentlich scharf geschaltete Anlage, während jemand zu Hause ist, die Leitstelle, und ein Fehlalarm kostet oft Geld; ein Unscharfschalten von einem geteilten Dashboard öffnet das Haus. Der Alarmstatus ist nie ein Schalter: Kein Sprachassistent und keine Szene „Gerätewert“ kann ihn ändern, nur das Widget und die Aktion unten.

• Entriegeln des Smart Lock erlauben: standardmäßig aus. Gladys kann die Tür immer verriegeln; das Entriegeln braucht diese Option.

• Abfrage der Sensoren: wie oft Systeme, Sensoren und Schlösser gelesen werden (30 s, 1, 2 oder 5 Minuten; standardmäßig 1 Minute). Scharfschalten, Alarme, Türklingel und Schlösser kommen ohnehin in Echtzeit.

• Sprache der Gerätenamen: die Sprache der Namen der Geräte und Funktionen. Gladys behält die Namen, die beim Hinzufügen eines Geräts gewählt wurden.

Aktionen der Konfiguration

• Anmeldung abschließen: siehe oben.
• Verbindung testen: listet die Systeme des Kontos auf. Nichts wird scharf oder unscharf geschaltet.
• Abmelden: löscht die von Gladys gespeicherten Token. Die Geräte bleiben, ohne neue Werte.

Die Geräte

Das System

Ein Gerät pro Basisstation, nach dem Ort benannt:

• Alarmstatus: Unscharf, Scharf (zu Hause), Scharf (abwesend), Ausgangsverzögerung, Eingangsverzögerung oder Alarm ausgelöst (Werte off, home, away, exit_delay, entry_delay, alarm in Szenen). Nur lesbar.
• Online: Die Basisstation erreicht die SimpliSafe-Cloud.
• Netzstrom: 0 bei einem Stromausfall (die Basis läuft mit ihrer Batterie).
• Notstrombatterie: der Wert, den SimpliSafe für die Notstrombatterie meldet, vermutlich in Millivolt (etwa 5.000 bei geladener Batterie).
• Meldungen: die letzte Meldung der SimpliSafe-App (Stromausfall, Sensorfehler…), mit ihrer Anzahl, wenn es mehrere sind, oder „Keine Meldung“.

Sensoren

Ein Gerät pro Sensor, benannt „Name in der App - Art“:

• Öffnungsmelder: Öffnung (offen oder geschlossen). Bei jeder Abfrage gelesen und durch einen Alarm oder einen stillen Alarm sofort auf offen gesetzt.
• Bewegungsmelder: Bewegung; Glasbruchmelder: Glasbruch. SimpliSafe speichert für sie keinen Zustand: Diese gehen für eine Minute auf 1, wenn ein Alarm oder ein stiller Alarm (Secret Alert) sie nennt, sonst 0. Richte in der SimpliSafe-App einen stillen Alarm für sie ein, um jede Erkennung zu sehen, auch unscharf.
• Rauchmelder: Rauch und Manipulation; Rauch- und CO-Melder: Rauch, Kohlenmonoxid und Manipulation; CO-Melder: Kohlenmonoxid.
• Wassermelder: Wasserleck.
• Frostmelder: Temperatur (in °F, in deiner Einheit angezeigt) und Temperaturalarm (außerhalb der in der App gesetzten Grenzen).
• Tastenfeld, Fernbedienung, Paniktaste, Sirenen: keine Erkennung.
• Alle Sensoren: Batterie schwach und Online.

Was zuverlässig ist: Die Basisstation verfolgt Öffnungs-, Rauch-, CO-, Wasser- und Frostmelder, und die Integration liest sie bei jeder Abfrage der Sensoren (mit frischen Werten von der Basisstation, wie Home Assistant). Bewegung und Glasbruch zeigen sich nur über Ereignisse.

Smart Lock

Verriegelung (verriegeln oder entriegeln, siehe Option oben), Schlossstatus (verriegelt, entriegelt, Fehler bei blockiertem Riegel), Batterie schwach, Tastenfeld-Batterie schwach und Online.

Kameras und Türklingeln

Bild: das Bild der letzten Bewegung oder des letzten Klingelns, wenn SimpliSafe eines liefert, oder ein Livebild einer kabelgebundenen SimpliCam der ersten Generation, deren Privatsphäre-Klappe im aktuellen Modus offen ist (ein Bild öffnet nie eine Klappe und weckt nie eine Akku-Kamera). Bewegung (1 für eine Minute nach einer Bewegung), Türklingel (bei einer Türklingel: 1 für einige Sekunden nach dem Klingeln) und Online.

Dashboard

Das Widget SimpliSafe-Alarm zeigt den Alarmstatus, die Basisstation, die Stromversorgung, offene Eingänge, schwache Batterien und Meldungen, sowie die Knöpfe Scharf (zu Hause), Scharf (abwesend) und Unscharf schalten, die Scharfschalten über Gladys erlaubt. Der aktuelle Modus ist mit einem Haken markiert. Wähle das System in den Widget-Einstellungen, wenn das Konto mehrere hat.

Szenen

Auslöser

• SimpliSafe-Alarm ausgelöst: Der Alarm ist losgegangen. Filter nach System und Art (Einbruch, Feuer, Kohlenmonoxid, Wasser, Frost, Panik). Variablen: die Art, der Name des Sensors.
• SimpliSafe scharf oder unscharf: per App, Tastenfeld, Fernbedienung oder Gladys. Filter nach System, neuem Modus und Herkunft. Variablen: der Modus, die Herkunft, der Name der PIN, wenn SimpliSafe ihn nennt (z. B. „Master PIN“).
• SimpliSafe-Türklingel gedrückt: Filter nach Türklingel. Das Kamerabild ist das Bild des Klingelns, wenn SimpliSafe eines liefert.

Die Funktion Alarmstatus dient auch als Geräteauslöser; die Auslöser oben ergänzen die Art des Alarms, wer scharf geschaltet hat, und das Klingeln.

Aktionen

• SimpliSafe scharf oder unscharf schalten: schaltet scharf (zu Hause, abwesend) oder unscharf, soweit Scharfschalten über Gladys es erlaubt. Ausgabe: der Status nach dem Befehl (exit_delay, wenn das System eine Ausgangsverzögerung hat).
• Das Smart Lock ist ein normales Schloss: „Wert setzen“ von Verriegelung.

Szenen-Ideen

• SimpliSafe-Alarm ausgelöst → alle Lichter einschalten und das Kamerabild per Nachricht schicken.
• SimpliSafe scharf oder unscharf, neuer Modus Scharf (abwesend) → Heizung und Lichter ausschalten; Modus Unscharf vom Tastenfeld → das Licht im Flur einschalten.
• SimpliSafe-Türklingel gedrückt → das Bild der Türklingel aufs Handy schicken.
• Jeden Abend um 23 Uhr, wenn der Alarmstatus Unscharf ist → SimpliSafe scharf oder unscharf schalten (Scharf (zu Hause)), mit „Nur scharf schalten“.

Aktualisierung und Grenzen der Cloud

Die SimpliSafe-API ist die inoffizielle API der Apps: kein veröffentlichtes Kontingent. Die Integration liest standardmäßig jede Minute (Home Assistant: alle 30 s), nur die Systeme, die ein Gerät in Gladys haben, die Einstellungen der Basisstation alle 10 Minuten, und hört für den Rest auf den WebSocket. Antwortet SimpliSafe mit 403 (so lehnt es einen Client ab, der zu oft fragt), pausieren die Abfragen 1 Minute, dann jedes Mal doppelt so lange, bis zu 2 Stunden. Direkt nach einem Scharfschalten wird ein System mit Smart Lock 20 s in Ruhe gelassen: SimpliSafe hat einen Fehler, bei dem die Basisstation dann ansagt, dass das Schloss nicht antwortet.

Fehlerbehebung

• „Nicht angemeldet“: Führe die Anmeldung oben durch. „SimpliSafe hat die gespeicherte Anmeldung abgelehnt“: Das Passwort wurde geändert, oder das Konto hat alle Geräte abgemeldet: Melde dich neu an.
• „SimpliSafe hat den Code abgelehnt“: Der Code wurde schon benutzt, ist älter als ein paar Minuten oder stammt von einem früheren Verbinden: Klicke erneut auf Verbinden.
• Kein Code in der Konsole: Prüfe, dass die Bestätigung in zwei Schritten aktiv ist, nutze Chrome oder Edge, ein privates Fenster und den Reiter Netzwerk.
• „Das SimpliSafe-Abo dieses Systems erlaubt keine Fernsteuerung“: Das Abo enthält kein Scharfschalten aus der App.
• Ein Sensor bleibt auf „kein aktueller Wert“: SimpliSafe meldet diese Art Sensor (Bewegung, Glasbruch) erst bei einem Ereignis.
• Protokolle: Integrationen → SimpliSafe → Protokolle; mit LOG_LEVEL=debug für jede Abfrage und jedes Ereignis. Kein Token, Code, keine Adresse und kein PIN-Name wird je geschrieben.

Grenzen

• Ohne die Hardware entwickelt: Das Verhalten ist das der Bibliotheken, denen sie folgt, geprüft an deren aufgezeichneten Antworten.
• SimpliSafe-2-Systeme (vor 2018) werden aufgelistet, aber nicht unterstützt.
• Kein Live-Video, keine Sirenensteuerung, keine PIN-Verwaltung, keine Änderung der Systemeinstellungen (Lautstärken, Verzögerungen).
• Die Kameras der neuesten Generation streamen über einen anderen Dienst: Diese zeigen nur das Bild ihrer Ereignisse.
• Ein Ereignis, das während der Neuverbindung des WebSockets verpasst wird, löst seine Szene nicht aus; die Zustände holen bei der nächsten Abfrage auf.
• Der Wert Notstrombatterie ist der Rohwert von SimpliSafe.

Konfigurationseinstellungen

Diese Einstellungen fragt SimpliSafe in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Bevor du loslegst	section	Nein	Diese Integration meldet sich wie die App bei deinem SimpliSafe-Konto an und verfolgt dein SimpliSafe-3-System in Echtzeit: Alarmstatus, Sensoren, Smart Lock, Kameras und Türklingel. Im Konto muss die Bestätigung in zwei Schritten aktiviert sein (SimpliSafe-App, Einstellungen). Ohne die Hardware entwickelt: Rückmeldungen willkommen. Nicht mit SimpliSafe verbunden.
Anmeldung	section	Nein	Am Computer, am besten in Chrome oder Edge: 1. Klicke auf Verbinden: Die SimpliSafe-Anmeldeseite öffnet sich in einem neuen Tab. Öffne in diesem Tab die Entwicklertools (F12, oder Cmd+Option+I auf dem Mac), Reiter Konsole. 2. Melde dich mit der E-Mail-Adresse und dem Passwort der SimpliSafe-App an und bestätige die Anmeldung (Code oder Link per E-Mail oder SMS). 3. Die Seite scheint danach nichts zu tun: Das ist normal. In der Konsole nennt eine rote Zeile eine Adresse, die mit com.simplisafe.mobile:// beginnt und code= enthält. Kopiere diese Adresse. 4. Füge sie innerhalb weniger Minuten in die Aktion „Anmeldung abschließen“ unten auf dieser Seite ein. Gladys sieht dein Passwort nie. Nichts in der Konsole? Öffne vor der Anmeldung den Reiter Netzwerk, oder sieh in die Anleitung.
SimpliSafe-Konto	account_link	Nein
Scharfschalten über Gladys	select	Nein	Aus: Gladys zeigt den Alarmstatus an und ändert ihn nie. Nur scharf: Widget und Szenen können scharf schalten (zu Hause, abwesend). Scharf und unscharf: Wer deine Dashboards und Szenen nutzt, kann auch unscharf schalten. Nie per Sprache.
Entriegeln des Smart Lock erlauben	boolean	Nein	Aus: Gladys kann die Tür verriegeln, nie entriegeln. An: Wer deine Dashboards und Szenen nutzt, kann sie öffnen.
Abfrage der Sensoren	select	Nein	Wie oft Systeme, Sensoren und Schlösser gelesen werden. Scharfschalten, Alarme, Türklingel und Schlösser kommen ohnehin in Echtzeit.
Sprache der Gerätenamen	select	Nein	Gladys behält die Namen, die beim Hinzufügen eines Geräts gewählt wurden.

So installierst du SimpliSafe in Gladys

1. Öffne in Gladys Integrationen: SimpliSafe erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-simplisafe:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-simplisafe.

SimpliSafe benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

SimpliSafe ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂