Intégration domotique Garmin Connect, gratuite et open source
Montres, balances et données santé Garmin (pas, sommeil, Body Battery) dans Gladys.
Publiée par gboulvin
- Appareils
- Version 2.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Votre compte Garmin dans Gladys : les valeurs santé du jour (pas, fréquence cardiaque, sommeil, Body Battery, stress, poids...), vos appareils Garmin (montres, compteurs vélo, balances Index...), vos activités, des déclencheurs et des actions de scène, et trois widgets de tableau de bord.
Garmin ne propose pas d’API publique aux particuliers. L’intégration se connecte comme l’application Garmin Connect et ne fait que lire vos données. Garmin peut modifier cette connexion à tout moment : si elle cesse de fonctionner, mettez l’intégration à jour.
Configuration
- Ouvrez l’onglet Configuration de l’intégration.
- Saisissez l’e-mail et le mot de passe de votre compte Garmin Connect.
- Réglages facultatifs :
- Région Garmin :
garmin.cnuniquement pour les comptes créés en Chine ; - Fuseau horaire de votre compte (ex.
Europe/Paris), pour savoir quel jour est « aujourd’hui » ; - Intervalle de synchronisation : 15 minutes par défaut, 5 minutes minimum (Garmin limite son API) ;
- Seuil de Body Battery faible du déclencheur de scène (20 par défaut) ;
- Langue des noms d’appareils créés dans Gladys.
- Région Garmin :
- Enregistrez. Sans vérification en deux étapes, l’intégration se connecte immédiatement.
Vérification en deux étapes (MFA)
Si votre compte demande un code :
- À l’enregistrement, Garmin vous envoie un code (e-mail, SMS ou application d’authentification) et le statut de connexion le demande. Pas de code reçu ? Lancez l’action Se connecter sans code pour en obtenir un nouveau.
- Lancez Se connecter avec ce code.
La session est ensuite conservée dans le volume de l’intégration et renouvelée toute seule : le code n’est plus demandé, même après un redémarrage.
Appareils
Ouvrez l’onglet Découverte et ajoutez :
- Garmin Connect - <votre nom> : les valeurs du jour. Elles appartiennent au compte (Garmin fusionne toutes vos montres) : l’historique survit à un changement de montre ;
- un appareil par produit Garmin de votre compte, avec l’indicateur dernier appareil synchronisé et le temps depuis sa dernière synchronisation (connu pour l’appareil synchronisé en dernier).
Une valeur que vos appareils ne mesurent pas (pas de balance → pas de poids) reste simplement vide.
Actions
- Se connecter — se connecte (et termine la vérification en deux étapes).
- Tester la connexion — lit Garmin Connect et affiche vos pas du jour.
- Synchroniser maintenant — lit Garmin Connect sans attendre l’intervalle.
- Se déconnecter — supprime la session Garmin de Gladys.
Scènes
Dans la catégorie Intégrations de l’éditeur de scènes (Gladys 5.1 ou plus récent) :
Déclencheurs :
- Activité Garmin terminée — filtrable par type (course à pied, vélo,
marche, randonnée, natation, renforcement musculaire, autre). Variables :
activity_type,activity_name,distance_km,duration_minutes,calories,average_hr(ex.{{triggerEvent.data.activity_name}}). - Objectif de pas quotidien atteint — une fois par jour (
steps,step_goal). - Body Battery faible — quand elle passe sous le seuil configuré
(
body_battery,threshold). - Nuit de sommeil enregistrée — quand la nuit arrive sur Garmin Connect,
en général à la synchro du matin (
sleep_hours,sleep_score). - Nouvelle pesée (
weight_kg,body_fat,bmi). - Appareil Garmin synchronisé — éventuellement pour un appareil précis
(
device_name).
Actions :
- Synchroniser Garmin Connect — sorties
synced,steps,body_battery. - Lire le résumé quotidien Garmin — les valeurs du jour en sorties (pas, sommeil, fréquence cardiaque au repos, Body Battery, stress, VFC, poids...).
- Lire la dernière activité Garmin —
found,name,type,distance_km...
Exemple : « Quand une nuit de sommeil est enregistrée et que le score de sommeil est inférieur à 60, m’envoyer un message avec la durée de sommeil ».
Les valeurs elles-mêmes sont des fonctionnalités d’appareil : le déclencheur standard « état d’un appareil » fonctionne aussi (ex. « Body Battery au-dessus de 80 »).
Tableau de bord
- Résumé quotidien Garmin — pas, Body Battery, fréquence cardiaque au repos, score de sommeil, stress et distance en direct, plus le compte, l’objectif de pas, la dernière synchro et la dernière activité, et un bouton Synchroniser.
- Activités Garmin — vos 3, 5 ou 8 dernières activités ; chacune ouvre son détail et un lien vers Garmin Connect.
- Tendance santé Garmin — l’historique d’une mesure (pas, fréquence cardiaque, Body Battery, stress, sommeil, VFC, poids) sur 7 jours à un an.
Dépannage
- « Garmin a refusé la connexion » : vérifiez l’e-mail et le mot de passe (essayez-les sur connect.garmin.com), enregistrez puis lancez Se connecter.
- « Garmin bloque temporairement les connexions » : Garmin limite les connexions par réseau. L’intégration attend une heure avant de réessayer seule ; vous pouvez réessayer avec Se connecter.
- Pas de valeur pour une fonctionnalité : Garmin n’avait pas de donnée aujourd’hui (pas de pesée, pas de capteur VFC sur votre montre...).
- Consultez les logs de l’intégration depuis l’interface de Gladys, avec
LOG_LEVEL=debugpour le détail complet. Les logs ne contiennent jamais votre mot de passe ni votre session.
Paramètres de configuration
Voici les paramètres demandés par Garmin Connect dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Garmin Connect | section | Non | Saisissez les identifiants de votre compte Garmin Connect. Garmin ne propose pas d’API publique aux particuliers : l’intégration se connecte comme l’application Garmin Connect et ne fait que lire vos données. Avec la vérification en deux étapes, enregistrez puis lancez deux fois l’action « Se connecter » : une fois pour recevoir le code, une fois avec le code. |
string | Oui | ||
| Mot de passe | secret | Oui | Envoyé uniquement à Garmin pour se connecter ; la session est ensuite conservée dans le volume de l’intégration. |
| Région Garmin | select | Non | |
| Fuseau horaire | string | Non | Fuseau horaire de votre compte Garmin, pour savoir quel jour est « aujourd’hui ». |
| Intervalle de synchronisation (s) | number | Non | Fréquence de lecture de Garmin Connect, en secondes (5 minutes minimum : Garmin limite son API). |
| Seuil de Body Battery faible | number | Non | Le déclencheur de scène « Body Battery faible » se déclenche quand le niveau passe sous cette valeur. |
| Langue des noms d’appareils | select | Non | Langue des noms d’appareils et de fonctionnalités créés dans Gladys. |
Comment installer Garmin Connect dans Gladys
- Dans Gladys, ouvrez Intégrations : Garmin Connect 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/gboulvin/gladys-garminconnect:2.0.0), 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/gboulvin/Gladys-GarminConnect.
Garmin Connect 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
Garmin Connect 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 gboulvin, 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