Intégration domotique Flair, gratuite et open source

Pilotez les bouches Flair, les consignes des pièces et Présent/Absent, lisez les Pucks.
Pilotez vos bouches connectées Flair (Smart Vents) depuis Gladys, suivez la température de chaque pièce et passez votre maison de Présent à Absent.
Ce que vous obtenez
Une fois configurée, l'onglet Découverte liste un appareil par élément Flair :
| Élément Flair | Dans Gladys |
|---|---|
| Maison | Interrupteur Présent (éteint = Absent), Mode auto (éteint = Manuel) |
| Pièce | Consigne (thermostat), Température, Humidité, Active |
| Smart Vent | Ouverture (0 % fermée à 100 % ouverte) et les boutons ouvrir / fermer |
| Puck | Température, Humidité |
Chaque appareil affiche un badge cloud : Flair ne se pilote que par son cloud. Le badge passe à injoignable quand Flair ne répond pas, ou quand une bouche ou un puck ne donne plus de nouvelles (pile vide, hors de portée).
Avant de commencer : obtenir vos identifiants d'API
Flair ouvre son API sur demande : écrivez au support Flair (depuis le site ou l'application Flair) et demandez des identifiants d'API pour votre compte. Vous recevez un identifiant client (client ID) et un secret client (client secret).
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Collez l'Identifiant client et le Secret client.
- Modifiez si besoin l'Intervalle de rafraîchissement : l'intégration lit votre compte Flair toutes les 2 minutes par défaut (une minute minimum).
- Enregistrez, puis cliquez sur Tester la connexion : la réponse liste les maisons, pièces, bouches et pucks trouvés.
- Ouvrez l'onglet Découverte et ajoutez les appareils voulus.
Bon à savoir
- En mode Auto, Flair ouvre et ferme lui-même les bouches pour atteindre la consigne de chaque pièce. Une ouverture réglée depuis Gladys tient jusqu'à la prochaine décision de Flair. Pour garder les bouches là où vous les mettez, passez la maison en Manuel (interrupteur Mode auto).
- Une pièce inactive est mise de côté par Flair : ses bouches restent fermées.
- Un changement fait dans l'application Flair arrive dans Gladys au prochain rafraîchissement.
Scènes
L'intégration ajoute ses propres cartes à l'éditeur de scènes, dans la catégorie Intégrations.
Déclencheurs :
- Flair présent ou absent a changé — une maison est passée de Présent à
Absent ou l'inverse (application Flair, géorepérage ou Gladys… sauf un
changement fait par la même scène). Choisissez éventuellement la maison et
le nouveau mode. Les actions suivantes peuvent lire
{{triggerEvent.data.mode}}(homeouaway) et{{triggerEvent.data.home_name}}. - Appareil Flair en ligne ou hors ligne — une bouche ou un puck a cessé
de répondre, ou est revenu. Choisissez éventuellement l'appareil et l'état.
Variables :
{{triggerEvent.data.status}}(offlineouonline) et{{triggerEvent.data.device_name}}.
Actions :
- Régler l'ouverture d'une bouche Flair — de 0 à 100 %. Renvoie l'ouverture et si la maison est en mode Auto (Flair peut alors redéplacer la bouche).
- Régler la consigne d'une pièce Flair — de 10 à 32 °C. Renvoie la consigne.
- Passer une maison Flair en Présent ou Absent — renvoie si la maison est en Présent.
- Passer une maison Flair en Auto ou Manuel — renvoie si le mode Auto est actif.
Tableau de bord
Ajoutez le widget Vue d'ensemble Flair à un tableau de bord. Il affiche la température moyenne des pièces, le nombre de bouches ouvertes, les appareils hors ligne, puis chaque maison (Présent / Absent, Auto / Manuel) et chaque pièce (température → consigne, en vert si proche, orange ou rouge si éloignée). Ses boutons basculent la première maison entre Présent et Absent, entre Auto et Manuel, et rafraîchissent les données tout de suite.
Dépannage
- « Flair a refusé les identifiants de l'API » — vérifiez l'identifiant et le secret client, sans espace autour. Contactez le support Flair si le refus persiste.
- « Le cloud Flair ne répond pas » — Flair ou votre connexion Internet est en panne. L'intégration réessaie à chaque rafraîchissement.
- Un appareil reste injoignable — vérifiez sa pile et sa distance au pont (bridge) Flair dans l'application Flair.
- Plus de détails dans les logs de l'intégration (interface Gladys, ou
docker logssur l'hôte), avecLOG_LEVEL=debug.
Paramètres de configuration
Voici les paramètres demandés par Flair dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Flair se pilote par son API cloud, avec des identifiants OAuth 2.0 (un identifiant client et un secret client) que le support Flair fournit sur demande. Saisissez-les ci-dessous, enregistrez, puis cliquez sur « Tester la connexion » : vos maisons, pièces, bouches et pucks apparaissent dans l'onglet Découverte. |
| Identifiant client | string | Oui | Identifiant client OAuth 2.0 de l'API Flair. |
| Secret client | secret | Oui | Secret client OAuth 2.0 de l'API Flair. Stocké comme secret, jamais journalisé. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture du compte Flair, en secondes (une minute minimum). |
Comment installer Flair dans Gladys
- Dans Gladys, ouvrez Intégrations : Flair 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-flair: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). - 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-flair.
Flair nécessite Gladys >=5.3.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
Flair 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