Intégration domotique SimpliSafe, gratuite et open source

Alarme SimpliSafe via le cloud SimpliSafe : armement, capteurs, Smart Lock, caméras, sonnette.

• Publiée par guim31
• Appareils
• Version 1.0.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Amène votre alarme SimpliSafe dans Gladys, par le cloud SimpliSafe (celui qu'utilise l'application SimpliSafe) : l'état de l'alarme (désarmée, armée maison, armée absent, délais de sortie et d'entrée, alarme), la base (en ligne, alimentation secteur, batterie de secours, alertes), chaque capteur (ouverture, mouvement, bris de vitre, fumée, monoxyde de carbone, eau, gel, clavier, bouton panique, sirène : détection, pile faible, en ligne), la Smart Lock, et les SimpliCam, caméras extérieures et Video Doorbell Pro (image du dernier mouvement ou de la dernière sonnerie, sonnette). L'armement, les alarmes, la sonnette et les serrures arrivent en temps réel par le WebSocket qu'utilise l'application.

Développée sans le matériel : retours bienvenus. Cette intégration a été écrite d'après le travail de l'intégration Home Assistant simplisafe, de la bibliothèque simplisafe-python et de homebridge-simplisafe3, sans système ni compte SimpliSafe sous la main. Si quelque chose ne fonctionne pas comme décrit, ouvrez un ticket sur github.com/guim31/gladys-simplisafe/issues avec les journaux de l'intégration (LOG_LEVEL=debug).

Cette intégration n'est pas affiliée à SimpliSafe. SimpliSafe est une marque de SimpliSafe, Inc.

Ce qu'il faut

• Un système SimpliSafe 3 (la génération actuelle, vendue depuis 2018) et le compte SimpliSafe de l'application. L'abonnement gratuit suffit pour les états ; armer et désarmer à distance demandent un abonnement qui permet le pilotage à distance.
• La vérification en deux étapes activée sur le compte (application SimpliSafe, Réglages) : sans elle, SimpliSafe ne donne jamais le code de connexion dont l'intégration a besoin (constat des utilisateurs de Home Assistant).
• Un ordinateur avec Chrome ou Edge pour la connexion (une seule fois).
• Gladys 5.1 ou plus récent, avec un accès à Internet.

Mise en place

Ouvrez Intégrations → SimpliSafe → Configuration, choisissez les options ci-dessous et enregistrez, puis connectez-vous. Ouvrez l'onglet Découverte et ajoutez les appareils voulus.

Connexion

SimpliSafe connecte par sa propre page, qui envoie ensuite le navigateur vers une adresse que seule l'application mobile ouvre (com.simplisafe.mobile://…). Le navigateur n'affiche rien, mais l'adresse apparaît dans ses outils de développement : c'est elle que vous copiez dans Gladys. Gladys ne voit jamais votre mot de passe.

1. Cliquez sur Connecter à côté de Compte SimpliSafe : la page de connexion SimpliSafe s'ouvre dans un nouvel onglet. Dans cet onglet, ouvrez les outils de développement (F12, ou Cmd+Option+I sur Mac), onglet Console.
2. Connectez-vous avec l'adresse e-mail et le mot de passe de l'application SimpliSafe, puis confirmez la connexion (code ou lien envoyé par e-mail ou SMS).
3. La page semble ensuite ne rien faire : c'est normal. Dans la console, une ligne rouge dit à peu près Failed to launch 'com.simplisafe.mobile://auth.simplisafe.com/ios/com.simplisafe.mobile/callback?code=…'. Copiez cette ligne, ou seulement l'adresse.
4. Dans les minutes qui suivent, collez-la dans l'action Terminer la connexion en bas de la page de configuration et lancez-la. La réponse liste les systèmes trouvés.

Rien dans la console ? Ouvrez l'onglet Réseau avant de vous connecter : la dernière ligne, en rouge, porte l'adresse dans son en-tête Location. Déjà connecté à SimpliSafe dans ce navigateur, la page peut sauter directement à la fin : ouvrez une fenêtre de navigation privée et recommencez depuis Connecter. Un code ne sert qu'une fois et quelques minutes ; chaque Connecter crée une nouvelle page, et seul le code de la dernière fonctionne.

Réglages

• Compte SimpliSafe : le bouton Connecter et l'état de la liaison.

• Armement depuis Gladys :

  • Désactivé (état seul), par défaut : Gladys affiche l'état de l'alarme sans jamais le changer ;
  • Armer seulement : le widget et l'action de scène peuvent armer (maison, absent), jamais désarmer ;
  • Armer et désarmer : quiconque utilise vos tableaux de bord et scènes Gladys peut aussi désarmer. Désarmer depuis le widget demande une confirmation.

  Pourquoi désactivé par défaut : avec la télésurveillance, une alarme armée par erreur alors que quelqu'un est à la maison appelle le centre de surveillance, et une fausse alerte est souvent facturée ; un désarmement depuis un tableau de bord partagé ouvre la maison. L'état de l'alarme n'est jamais un interrupteur : aucun assistant vocal ni aucune scène « valeur d'un appareil » ne peut le changer, seuls le widget et l'action ci-dessous.

• Autoriser le déverrouillage de la Smart Lock : désactivé par défaut. Gladys peut toujours verrouiller la porte ; la déverrouiller demande cette option.

• Lecture des capteurs : fréquence de lecture des systèmes, capteurs et serrures (30 s, 1, 2 ou 5 minutes ; 1 minute par défaut). L'armement, les alarmes, la sonnette et les serrures arrivent de toute façon en temps réel.

• Langue des noms d'appareils : la langue des noms des appareils et des fonctionnalités. Gladys garde les noms choisis à l'ajout d'un appareil.

Actions de configuration

• Terminer la connexion : voir plus haut.
• Tester la connexion : liste les systèmes du compte. Rien n'est armé ni désarmé.
• Se déconnecter : supprime les jetons enregistrés par Gladys. Les appareils restent, sans nouveau relevé.

Les appareils

Le système

Un appareil par base, nommé d'après le lieu :

• État de l'alarme : Désarmée, Armée (maison), Armée (absent), Délai de sortie, Délai d'entrée ou Alarme en cours (valeurs off, home, away, exit_delay, entry_delay, alarm dans les scènes). En lecture seule.
• En ligne : la base joint le cloud SimpliSafe.
• Alimentation secteur : 0 pendant une coupure de courant (la base tourne sur sa batterie).
• Batterie de secours : la valeur que SimpliSafe donne pour la batterie de secours, a priori en millivolts (environ 5 000 pour une batterie chargée).
• Alertes : le dernier message de l'application SimpliSafe (coupure de courant, erreur de capteur…), avec leur nombre quand il y en a plusieurs, ou « Aucune alerte ».

Capteurs

Un appareil par capteur, nommé « nom dans l'application - type » :

• Détecteur d'ouverture : Ouverture (ouvert ou fermé). Lu à chaque lecture, et passé à ouvert aussitôt par une alarme ou une alerte secrète.
• Détecteur de mouvement : Mouvement ; détecteur de bris de vitre : Bris de vitre. SimpliSafe ne garde aucun état pour eux : ils passent à 1 pendant une minute quand une alarme ou une alerte secrète les nomme, 0 sinon. Réglez une alerte secrète dans l'application SimpliSafe pour voir chaque détection, même désarmé.
• Détecteur de fumée : Fumée et Sabotage ; détecteur de fumée et CO : Fumée, Monoxyde de carbone et Sabotage ; détecteur de CO : Monoxyde de carbone.
• Détecteur de fuite d'eau : Fuite d'eau.
• Détecteur de gel : Température (en °F, affichée dans votre unité) et Alerte température (hors des limites réglées dans l'application).
• Clavier, télécommande, bouton panique, sirènes : pas de détection.
• Tous les capteurs : Pile faible et En ligne.

Ce qui est fiable : la base suit les détecteurs d'ouverture, de fumée, de CO, d'eau et de gel, et l'intégration les lit à chaque Lecture des capteurs (en demandant des valeurs fraîches à la base, comme Home Assistant). Mouvement et bris de vitre ne se voient que par les événements.

Smart Lock

Verrouillage (verrouiller ou déverrouiller, voir l'option plus haut), État de la serrure (verrouillée, déverrouillée, erreur quand le pêne est bloqué), Pile faible, Pile du clavier faible et En ligne.

Caméras et sonnettes

Image : l'image du dernier mouvement ou de la dernière sonnerie quand SimpliSafe en donne une, ou une image en direct d'une SimpliCam filaire de première génération dont le cache est ouvert dans le mode en cours (une image n'ouvre jamais un cache, ni ne réveille une caméra sur batterie). Mouvement (1 pendant une minute après un mouvement), Sonnette (sur une sonnette : 1 quelques secondes après une sonnerie) et En ligne.

Tableau de bord

Le widget Alarme SimpliSafe montre l'état de l'alarme, la base, l'alimentation, les ouvertures, les piles faibles et les alertes, et les boutons Armer (maison), Armer (absent) et Désarmer que permet Armement depuis Gladys. Le mode en cours est marqué d'une coche. Choisissez le système dans les réglages du widget quand le compte en a plusieurs.

Scènes

Déclencheurs

• Alarme SimpliSafe déclenchée : l'alarme s'est déclenchée. Filtre par système et type (intrusion, incendie, monoxyde de carbone, eau, gel, panique). Variables : le type, le nom du capteur.
• SimpliSafe armée ou désarmée : depuis l'application, un clavier, une télécommande ou Gladys. Filtre par système, nouveau mode et origine. Variables : le mode, l'origine, le nom du code quand SimpliSafe le donne (par exemple « Master PIN »).
• Sonnette SimpliSafe pressée : filtre par sonnette. L'image de la caméra est celle de la sonnerie quand SimpliSafe la donne.

La fonctionnalité État de l'alarme sert aussi de déclencheur d'appareil ; les déclencheurs ci-dessus ajoutent le type d'alarme, qui a armé, et la sonnerie.

Actions

• Armer ou désarmer SimpliSafe : arme (maison, absent) ou désarme, dans la limite de Armement depuis Gladys. Sortie : l'état après la commande (exit_delay quand le système a un délai de sortie).
• La Smart Lock est une serrure ordinaire : « changer la valeur » de Verrouillage.

Idées de scènes

• Alarme SimpliSafe déclenchée → allumer toutes les lumières et envoyer l'image de la caméra par message.
• SimpliSafe armée ou désarmée, nouveau mode Armée (absent) → couper le chauffage et les lumières ; mode Désarmée depuis le clavier → allumer la lumière de l'entrée.
• Sonnette SimpliSafe pressée → envoyer l'image de la sonnette sur votre téléphone.
• Chaque soir à 23 h, si l'état de l'alarme est Désarmée → Armer ou désarmer SimpliSafe (Armée (maison)), avec « Armer seulement ».

Rafraîchissement et limites du cloud

L'API SimpliSafe est l'API non officielle des applications : aucun quota publié. L'intégration lit toutes les minutes par défaut (Home Assistant : toutes les 30 s), seulement les systèmes qui ont un appareil dans Gladys, les réglages de la base toutes les 10 minutes, et écoute le WebSocket pour le reste. Quand SimpliSafe répond 403 (sa façon de refuser un client trop insistant), les lectures s'arrêtent 1 minute, puis deux fois plus longtemps à chaque fois, jusqu'à 2 heures. Juste après un armement, un système avec une Smart Lock est laissé tranquille 20 s : SimpliSafe a un bug où la base annonce alors que la serrure ne répond pas.

Dépannage

• « Non connecté » : faites la connexion ci-dessus. « SimpliSafe a refusé la connexion enregistrée » : le mot de passe a changé, ou le compte a déconnecté tous les appareils : reconnectez-vous.
• « SimpliSafe a refusé le code » : le code a déjà servi, date de plus de quelques minutes, ou vient d'un Connecter précédent : recliquez sur Connecter.
• Pas de code dans la console : vérifiez que la vérification en deux étapes est activée, utilisez Chrome ou Edge, une fenêtre privée, et l'onglet Réseau.
• « L'abonnement SimpliSafe de ce système ne permet pas le pilotage à distance » : l'abonnement n'inclut pas l'armement depuis l'application.
• Un capteur reste sur « pas de valeur récente » : SimpliSafe ne remonte pas ce type de capteur (mouvement, bris de vitre) avant un événement.
• Journaux : Intégrations → SimpliSafe → Journaux ; avec LOG_LEVEL=debug pour chaque lecture et chaque événement. Aucun jeton, code, adresse ni nom de code n'y est jamais écrit.

Limites

• Développée sans le matériel : le comportement est celui des bibliothèques qu'elle suit, vérifié sur leurs réponses enregistrées.
• Les systèmes SimpliSafe 2 (avant 2018) sont listés mais pas pris en charge.
• Pas de vidéo en direct, pas de commande de sirène, pas de gestion des codes, pas de modification des réglages du système (volumes, délais).
• Les caméras de dernière génération diffusent par un autre service : elles ne montrent que l'image de leurs événements.
• Un événement manqué pendant que le WebSocket se reconnecte ne déclenche pas sa scène ; les états se rattrapent à la lecture suivante.
• La valeur Batterie de secours est la valeur brute de SimpliSafe.

Paramètres de configuration

Voici les paramètres demandés par SimpliSafe dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Avant de commencer	section	Non	Cette intégration se connecte à votre compte SimpliSafe comme l'application et suit votre système SimpliSafe 3 : état de l'alarme, capteurs, Smart Lock, caméras et sonnette, en temps réel. La vérification en deux étapes doit être activée sur le compte (application SimpliSafe, Réglages). Développée sans le matériel : retours bienvenus. Sans lien avec SimpliSafe.
Connexion	section	Non	Sur un ordinateur, de préférence dans Chrome ou Edge : 1. Cliquez sur Connecter : la page de connexion SimpliSafe s'ouvre dans un nouvel onglet. Dans cet onglet, ouvrez les outils de développement (F12, ou Cmd+Option+I sur Mac), onglet Console. 2. Connectez-vous avec l'adresse e-mail et le mot de passe de l'application SimpliSafe, puis confirmez la connexion (code ou lien envoyé par e-mail ou SMS). 3. La page semble ensuite ne rien faire : c'est normal. Dans la console, une ligne rouge cite une adresse qui commence par com.simplisafe.mobile:// et contient code=. Copiez cette adresse. 4. Dans les minutes qui suivent, collez-la dans l'action « Terminer la connexion » en bas de cette page. Gladys ne voit jamais votre mot de passe. Rien dans la console ? Ouvrez l'onglet Réseau avant de vous connecter, ou consultez le guide.
Compte SimpliSafe	account_link	Non
Armement depuis Gladys	select	Non	Désactivé : Gladys affiche l'état de l'alarme sans jamais le changer. Armer seulement : le widget et les scènes peuvent armer (maison, absent). Armer et désarmer : quiconque utilise vos tableaux de bord et scènes peut aussi désarmer. Jamais à la voix.
Autoriser le déverrouillage de la Smart Lock	boolean	Non	Désactivé : Gladys peut verrouiller la porte, jamais la déverrouiller. Activé : quiconque utilise vos tableaux de bord et scènes peut l'ouvrir.
Lecture des capteurs	select	Non	Fréquence de lecture des systèmes, capteurs et serrures. L'armement, les alarmes, la sonnette et les serrures arrivent de toute façon en temps réel.
Langue des noms d'appareils	select	Non	Gladys garde les noms choisis à l'ajout d'un appareil.

Comment installer SimpliSafe dans Gladys

1. Dans Gladys, ouvrez Intégrations : SimpliSafe apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-simplisafe:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-simplisafe.

SimpliSafe nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

SimpliSafe est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂