Intégration Netatmo pour Gladys Assistant
Connectez vos appareils Netatmo (station météo, thermostats, caméras) à Gladys Assistant.
Publiée par Terdious
- Appareils
- Version 1.1.1
- Nécessite Gladys >=4.83.0
- ★ 0
Connectez vos appareils Netatmo — station météo, thermostats et vannes de radiateur, caméras intérieure/extérieure et leurs accessoires — à Gladys Assistant.
Cette intégration communique avec le cloud Netatmo pour vous : vous créez une fois votre propre application Netatmo Connect, connectez votre compte, et Gladys découvre vos appareils puis maintient leurs valeurs à jour.
Prérequis
- Un compte Netatmo, avec vos appareils déjà installés et fonctionnels dans l'application Netatmo (Gladys lit ce que Netatmo expose — un appareil doit d'abord être en ligne dans Netatmo).
- Une instance Gladys Assistant compatible avec les intégrations externes.
Étape 1 — Créez votre application Netatmo Connect
Gladys n'embarque aucune clé Netatmo partagée : vous utilisez votre propre application Netatmo Connect, pour que vos données restent entre votre Gladys et votre compte Netatmo.
- Rendez-vous sur Netatmo Connect et connectez-vous avec votre compte Netatmo.
- Ouvrez My Apps → Créer et créez une nouvelle application (nom et description libres — par ex. « Gladys »).
- Une fois créée, la page de l'application affiche deux valeurs à copier dans
Gladys :
- le client id (identifiant client)
- le client secret (secret client)
Vous n'avez pas besoin de configurer de scopes ni d'URL de redirection sur le portail : Gladys demande automatiquement les scopes requis (lecture + écriture, couvrant l'Énergie, la Météo et la Sécurité y compris les caméras) au moment de la connexion, et gère lui-même la redirection OAuth2.
Étape 2 — Configurez et connectez dans Gladys
Sur l'écran Configuration de l'intégration :
- Collez votre client id et votre client secret.
- Cliquez sur Enregistrer.
- Cliquez sur Se connecter : une fenêtre Netatmo s'ouvre, connectez-vous et autorisez Gladys. Vous êtes redirigé et le statut passe à Connecté.
Astuce : Enregistrez toujours le client id / secret avant de cliquer sur Se connecter. Si la connexion indique qu'il faut d'abord sauvegarder les identifiants, enregistrez le formulaire et recliquez sur Se connecter.
Les jetons d'accès et de rafraîchissement sont stockés par l'intégration elle-même et n'apparaissent jamais dans le formulaire. Gladys les rafraîchit automatiquement ; si la session expire définitivement, l'écran Configuration vous invite à vous reconnecter.
Étape 3 — Choisissez les familles d'appareils
Sous Appareils à découvrir, activez les familles que vous possédez :
| Interrupteur | Découvre |
|---|---|
| Énergie | Thermostat (NATherm1), relais (NAPlug), vannes de radiateur (NRV) |
| Météo | Station (NAMain) + modules extérieur, vent, pluie et intérieurs |
| Sécurité | Caméras intérieure (NACamera) et extérieure (NOC), plus leurs accessoires |
Activer une famille et enregistrer relance la découverte automatiquement — pas besoin de re-scanner. Les nouveaux appareils apparaissent sur l'écran Découverte, où vous créez ceux que vous voulez.
Qualité du flux vidéo des caméras (poor / low / medium / high, par
défaut high) règle la qualité du flux vidéo en direct.
Les valeurs sont rafraîchies toutes les 2 minutes (limites d'API Netatmo).
Caméras
Quand la famille Sécurité est activée, chaque caméra est créée avec :
- une image de tableau de bord (un instantané, rafraîchi automatiquement) — Gladys la récupère en priorité sur le réseau local (avec repli sur l'URL VPN Netatmo) ;
- un interrupteur monitoring (activer/désactiver la surveillance de la caméra) ;
- un bouton flux en direct (HLS), construit lui aussi en local d'abord.
Flux en direct — latence et son
- Latence (~10 s) : elle est inhérente au flux HLS en direct de Netatmo — le
même décalage existe sur les applications web et mobile officielles de
Netatmo. Préférez une latence
lowsur la box caméra du tableau de bord, et une qualitémedium(720p) pour plus de fluidité. - Pas de son ? Le microphone de la caméra doit être activé dans l'application Netatmo : Gérer ma maison → sélectionner la pièce de la caméra → Caméra → Paramètres avancés → activer le Microphone. S'il est désactivé là, aucun client (Gladys, web Netatmo, app Netatmo) n'a de son. Gladys transporte l'audio dès que le flux en contient — il n'y a rien à configurer côté Gladys.
Accessoires de sécurité (bridgés par caméra)
Quand la famille Sécurité est activée, les accessoires liés à vos caméras sont également découverts :
- Capteur porte / fenêtre (
NACamDoorTag) — un capteur d'ouverture (ouvert/fermé), plus la batterie et le signal RF. - Sirène intérieure (
NIS) — un capteur sirène en lecture seule, plus la batterie et le signal RF. - Détecteur de fumée (
NSD) — découvert avec sa batterie et son signal. Son état de fumée est délivré par les webhooks (événements temps réel), qui arriveront dans un jalon ultérieur ; le polling seul ne peut pas le remonter.
Mettre à jour l'intégration
Le bouton « Forcer la mise à jour » de l'onglet Supervision récupère une nouvelle image Docker (le runtime). La version affichée et les champs de configuration proviennent du manifest que vous avez installé. Si une mise à jour ajoute de nouveaux champs de configuration, réinstallez / recollez le manifest à jour pour les récupérer.
Migration depuis le service Netatmo intégré
Si vous utilisiez le service Netatmo intégré à Gladys, cette intégration externe
le remplace. Les appareils sont redécouverts comme neufs (leurs
identifiants passent de netatmo:* à ext:netatmo:*), leur historique n'est
donc pas repris — recréez les appareils depuis l'écran Découverte.
Dépannage
- « Enregistrez d'abord » à la connexion : enregistrez le client id / secret, puis recliquez sur Se connecter.
- Session expirée : recliquez sur Se connecter pour réautoriser votre compte Netatmo.
- Un appareil affiche un badge « injoignable » : Netatmo le signale hors ligne (batterie morte, éteint, hors de portée). Gladys cesse de publier ses dernières valeurs connues pour ne pas vous induire en erreur ; le badge disparaît au retour de l'appareil.
- Une valeur de caméra ou une commande monitoring échoue une fois avec un message « reconnecter » : votre autorisation Netatmo n'a pas le scope caméra — reconnectez votre compte.
- Pas de son sur la caméra : voir l'astuce microphone dans la section Caméras ci-dessus.
Paramètres de configuration
Voici les paramètres demandés par Netatmo dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Application Netatmo Connect | section | Non | Gladys communique avec Netatmo via VOTRE propre application Netatmo Connect. Créez un compte Netatmo, puis une application développeur pour obtenir l'identifiant et le secret client ci-dessous. Les scopes (lecture + écriture) sont demandés automatiquement à la connexion — rien à configurer sur le portail. Voir le pas-à-pas dans la Documentation. |
| Identifiant client de l'application Netatmo | string | Oui | L'identifiant client de l'application créée sur dev.netatmo.com (Netatmo Connect). |
| Secret client de l'application Netatmo | secret | Oui | Le secret client de l'application créée sur dev.netatmo.com (Netatmo Connect). |
| Compte Netatmo | oauth2 | Oui | Connectez-vous avec votre compte Netatmo pour autoriser Gladys à accéder à vos appareils. |
| Appareils à découvrir | section | Non | Choisissez les familles d'appareils Netatmo que Gladys doit découvrir. Activer une famille et sauvegarder relance la découverte automatiquement — pas besoin de re-scanner. La Sécurité couvre les caméras et leurs accessoires (capteur porte/fenêtre, sirène, détecteur de fumée). |
| Appareils Énergie (thermostats, vannes) | boolean | Non | Découvrir les appareils Netatmo Énergie : thermostats, relais et vannes de radiateur. |
| Appareils Météo (stations et modules) | boolean | Non | Découvrir les appareils Netatmo Météo : stations, modules extérieur, vent, pluie et intérieur. |
| Appareils Sécurité (caméras) | boolean | Non | Découvrir les appareils Netatmo Sécurité : caméras intérieure (NACamera) et extérieure (NOC). |
| Qualité du flux vidéo des caméras | select | Non | Qualité du flux vidéo des caméras (surcharge par caméra via le paramètre camera_quality). |
Comment installer Netatmo dans Gladys
- Dans Gladys, ouvrez Intégrations : Netatmo 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/terdious/gladys-netatmo:1.1.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). - 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/Terdious/gladys-netatmo.
Netatmo nécessite Gladys >=4.83.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
Netatmo 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 Terdious, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation