Intégration domotique Scrypted, gratuite et open source
Caméras, sonnettes, détection de mouvement et d'objets, prises et serrures de Scrypted.
Publiée par prohand
- Appareils
- Version 1.0.2
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à Scrypted, la plateforme vidéo de la maison qui rassemble vos caméras (Reolink, Hikvision, Amcrest, UniFi, ONVIF, Ring, Nest…), vos sonnettes et leurs détections. Scrypted fait le travail vidéo ; Gladys reçoit les appareils, les images et les événements, et en fait des scènes et des tableaux de bord.
Ce que vous obtenez
| Dans Scrypted | Dans Gladys |
|---|---|
| Caméra | Caméra (images) |
| Détecteur de mouvement (caméra ou capteur) | Détecteur de mouvement + déclencheur « détecte un mouvement » |
| Bouton de sonnette | Sonnette + déclencheur « on sonne » |
| Détection d'objets (NVR, plugins de détection) | Déclencheur « détecte un objet » |
| Lumière (allumage, luminosité) | Lumière |
| Interrupteur, prise | Interrupteur |
| Sirène | Sirène |
| Serrure | Serrure |
| Capteur de porte / fenêtre | Capteur d'ouverture |
| Thermomètre, hygromètre | Capteur de température, capteur d'humidité |
| Batterie | Niveau de batterie |
Scrypted envoie chaque changement au moment où il arrive : rien n'est interrogé en boucle.
Avant de commencer
Il vous faut un serveur Scrypted qui tourne, avec vos caméras déjà fonctionnelles dedans.
- Dans la console Scrypted, ouvrez Settings → Users et créez un utilisateur pour Gladys. Un administrateur voit tous les appareils ; un simple utilisateur ne voit que ceux que vous lui donnez, ce qu'il vous faut si certaines caméras doivent rester hors de Gladys.
- Prenez un jeton de connexion pour cet utilisateur plutôt que son mot de
passe : sur un ordinateur de votre réseau, lancez
npx scrypted login <adresse de Scrypted>et connectez-vous avec cet utilisateur. Le jeton est enregistré dans le fichierlogin.jsondu dossier.scryptedde votre dossier personnel (la valeurtoken). Un jeton se révoque sans changer le mot de passe.
Configuration
Ouvrez l'intégration dans Gladys, puis Configuration.
| Champ | Quoi mettre |
|---|---|
| Adresse locale | L'adresse du serveur sur votre réseau, avec son port : https://192.168.1.20:10443/ |
| Adresse Scrypted Cloud | L'adresse que le plugin Scrypted Cloud donne à votre serveur (ou votre domaine). Peut rester vide |
| Nom d'utilisateur | L'utilisateur Scrypted créé pour Gladys |
| Mot de passe ou jeton de connexion | Son jeton de connexion (ou son mot de passe) |
| Intervalle des images caméra (s) | Fréquence d'envoi d'une nouvelle image par caméra. 60 par défaut, 10 minimum, 0 = sur événement seulement |
| Image à chaque événement | Une nouvelle image quand une caméra voit un mouvement, un objet ou un appui sur la sonnette |
| Pause entre détections (s) | Temps d'attente d'une caméra avant de redéclencher « détecte un objet » pour le même type d'objet |
Cliquez ensuite sur Tester la connexion : la réponse indique quelle adresse a répondu, la version de Scrypted, et combien d'appareils et de caméras ont été trouvés.
Local ou cloud
Le manifeste déclare les deux connexions, Gladys affiche donc un interrupteur Préférer la connexion locale :
- activé (par défaut) : l'adresse locale est essayée d'abord, Scrypted Cloud prend le relais quand elle ne répond pas ;
- désactivé : Scrypted Cloud d'abord, l'adresse locale en secours.
Renseignez une adresse ou les deux. Quand Gladys tourne sur l'adresse de secours, chaque appareil Scrypted affiche son badge de transport avec un point orange, et l'infobulle dit pourquoi. L'adresse préférée est réessayée toutes les 10 minutes, et reprise dès qu'elle répond.
Scrypted utilise un certificat auto-signé sur https://<ip>:10443 :
l'intégration l'accepte, comme le font les applications Scrypted. Le simple
http://<ip>:11080 fonctionne aussi sur un réseau de confiance.
Ajouter les appareils
Une fois connecté, ouvrez l'onglet Découverte de l'intégration : chaque appareil Scrypted que Gladys sait utiliser y est, sous son nom Scrypted. Ajoutez ceux que vous voulez et rangez-les dans leur pièce.
Une caméra ajoutée ou renommée plus tard dans Scrypted apparaît d'elle-même après quelques secondes. Le bouton Synchroniser les appareils le fait à la demande.
Images des caméras
Chaque caméra envoie une image :
- toutes les Intervalle des images caméra secondes ;
- à chaque mouvement, objet ou appui sur la sonnette (si Image à chaque événement est activé) ;
- quand le tableau de bord de Gladys ou un message de chat en demande une ;
- quand une scène lance Prendre une image avec une caméra Scrypted.
Gladys accepte des images jusqu'à 150 Ko : elles sont redemandées plus petites à Scrypted jusqu'à ce qu'elles tiennent. Une caméra n'envoie jamais plus de 12 images par minute.
Scènes
Déclencheurs
- Une caméra Scrypted détecte un mouvement : quand une caméra ou un détecteur passe du calme au mouvement. Filtre : l'appareil. Variable : le nom de l'appareil.
- On sonne à une sonnette Scrypted : le bouton de la sonnette. Filtre : la sonnette. Variable : le nom de l'appareil.
- Une caméra Scrypted détecte un objet : ce que la détection d'objets de Scrypted (Scrypted NVR, OpenVINO, CoreML, ONNX…) reconnaît. Filtres : la caméra et le type d'objet (personne, véhicule, animal, colis, visage, plaque d'immatriculation, autre objet). Variables : le nom de l'appareil, le type d'objet, le nom (visage ou plaque reconnus, s'il y en a un) et la confiance en pourcentage.
Une personne qui passe devant une caméra donne un événement, pas un par image : la même caméra attend la Pause entre détections avant de redéclencher pour le même type d'objet.
Actions
- Prendre une image avec une caméra Scrypted : une nouvelle image est envoyée à Gladys, prête pour l'action « envoyer l'image d'une caméra ». Sortie : si une image a été prise.
- Synchroniser les appareils Scrypted : relit la liste des appareils Scrypted. Sortie : le nombre d'appareils trouvés.
Exemple : « Quand on sonne, prendre une image avec la caméra de la sonnette et me l'envoyer par message. »
Widgets du tableau de bord
- Scrypted : la connexion (locale, cloud, secours ou injoignable), la version du serveur, le nombre d'appareils et de caméras, les derniers événements vus, et deux boutons : Synchroniser et Toutes les images.
- Caméra Scrypted : choisissez une caméra dans les réglages du widget. Il affiche sa dernière image, son état de mouvement en direct et un bouton Prendre une image.
Dépannage
| Ce que vous voyez | Que faire |
|---|---|
| « Renseignez l'adresse de Scrypted… » | Il faut une adresse, le nom d'utilisateur et le mot de passe ou le jeton |
| « Scrypted ne répond pas (… statusCode 401) » | Nom d'utilisateur, mot de passe ou jeton faux. Créez un nouveau jeton avec npx scrypted login |
| « Scrypted ne répond pas (ECONNREFUSED) » | Mauvaise adresse ou mauvais port, ou Scrypted arrêté. Ouvrez la même adresse dans un navigateur de votre réseau |
| « Scrypted ne répond pas (no answer after 20 s) » | L'adresse répond trop lentement ou pas du tout : pare-feu, VPN, mauvaise IP |
| Une caméra manque | L'utilisateur Scrypted n'y a pas accès, ou elle ne sait pas donner d'image dans Scrypted (plugin Snapshot) |
| Aucun événement « détecte un objet » | La détection d'objets doit être activée pour cette caméra dans Scrypted (Scrypted NVR ou un plugin de détection) |
| Point orange sur le badge de transport | Gladys tourne sur l'adresse de secours : l'infobulle dit pourquoi l'adresse préférée n'a pas répondu |
Le mot de passe et le jeton de connexion n'apparaissent jamais dans les journaux de l'intégration.
Paramètres de configuration
Voici les paramètres demandés par Scrypted dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Gladys parle à votre serveur Scrypted comme le fait la console web de Scrypted. Donnez-lui l'adresse locale du serveur, l'adresse Scrypted Cloud, ou les deux : l'interrupteur « Préférer la connexion locale » choisit celle qui est essayée en premier, l'autre prend le relais quand elle ne répond pas. Utilisez un compte Scrypted créé pour Gladys, et de préférence un jeton de connexion plutôt que son mot de passe. |
| Adresse locale | string | Non | L'adresse du serveur Scrypted sur votre réseau, avec son port : https://<ip>:10443/ par défaut. Son certificat auto-signé est accepté. |
| Adresse Scrypted Cloud | string | Non | L'adresse que le plugin Scrypted Cloud donne à votre serveur (ou votre propre domaine derrière lui). Laissez vide pour rester sur le réseau local. |
| Nom d'utilisateur | string | Oui | Un utilisateur Scrypted (Paramètres, Utilisateurs). Un administrateur voit tous les appareils ; un utilisateur ne voit que ceux qui lui sont donnés. |
| Mot de passe ou jeton de connexion | secret | Oui | Le mot de passe de cet utilisateur, ou mieux un jeton de connexion : lancez npx scrypted login sur un ordinateur de votre réseau, puis collez le jeton enregistré dans ~/.scrypted/login.json. Il n'est jamais écrit dans les journaux. |
| Intervalle des images caméra (s) | number | Non | Fréquence à laquelle chaque caméra envoie une nouvelle image à Gladys, en secondes (10 minimum). 0 n'envoie d'images que sur événement et à la demande. |
| Image à chaque événement | boolean | Non | Envoie une nouvelle image de la caméra quand elle voit un mouvement, un objet ou un appui sur la sonnette. |
| Pause entre détections (s) | number | Non | Après un événement « objet détecté », la même caméra attend ce nombre de secondes avant de le redéclencher pour le même type d'objet : une personne qui passe, c'est un événement, pas trente. |
Comment installer Scrypted dans Gladys
- Dans Gladys, ouvrez Intégrations : Scrypted apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-scrypted:1.0.2), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-scrypted.
Scrypted 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
Scrypted 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 prohand, 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