Intégration domotique Flipr, gratuite et open source

Analyseur de piscine Flipr et Hub : température, pH, chlore, filtration, scènes, widget.

• Publiée par William-De71
• Appareils
• Version 0.1.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations externes

Présentation

Cette intégration amène dans Gladys votre analyseur de piscine connecté Flipr et le Flipr Hub :

• un appareil par analyseur : température de l’eau, pH, chlore, redox (ORP), batterie, et l’évaluation du pH et du chlore donnée par Flipr (trop bas, un peu bas, idéal, un peu haut, trop haut) ;
• un appareil par Hub : filtration en marche ou arrêtée et mode de filtration (automatique, manuel, programmation), tous deux pilotables depuis Gladys ;
• des déclencheurs de scène (nouvelle mesure, évaluation de l’eau changée, aucune mesure depuis 24 heures, filtration basculée par le Hub) et des actions de scène (lire la dernière mesure, changer le mode de filtration) ;
• un widget de tableau de bord « Eau de la piscine ».

Flipr n’a pas d’API locale : l’analyseur envoie ses mesures au cloud Flipr environ une fois par heure, et l’intégration les y lit avec votre compte Flipr (transport cloud). Votre e-mail et votre mot de passe ne partent que vers le cloud Flipr, comme avec l’application Flipr.

Prérequis

• Gladys Assistant 5.1.0 ou plus récent.
• Un analyseur Flipr (Start, AnalysR…) qui fonctionne déjà dans l’application mobile Flipr, et éventuellement un Flipr Hub.
• L’e-mail et le mot de passe de votre compte Flipr.

Configuration

1. Intégrations → Flipr → Configuration.
2. Remplissez les champs, puis enregistrez.

Champ	Description
E-mail	L’e-mail de votre compte Flipr.
Mot de passe	Son mot de passe, enregistré comme secret et jamais réaffiché.
Intervalle de lecture (min)	De 5 à 60 minutes, 15 par défaut. L’analyseur mesure environ une fois par heure : inutile d’aller plus vite.
Langue des textes	Noms des fonctionnalités, évaluations et résumés des scènes. Automatique : la langue de votre tableau de bord.

Tester la connexion se connecte à Flipr et indique combien d’analyseurs et de Hubs compte le compte.

Utilisation

Appareils

Appareils → Flipr → Découverte, puis ajoutez l’analyseur (« Flipr AB256C ») et le Hub (« Flipr Hub CD256C »). Leurs valeurs apparaissent à la lecture suivante.

Appareil	Fonctionnalités
Analyseur	Température de l’eau, pH, chlore (mg/L), redox (mV), batterie, état du pH et du chlore
Flipr Hub	Filtration (marche/arrêt), mode de filtration (automatique, manuel, programmation)

Démarrer ou arrêter la filtration met le Hub en mode manuel, comme le fait l’application Flipr. Choisissez à nouveau « Automatique » ou « Programmation » pour rendre la main au Hub.

Scènes

Déclencheurs :

• Flipr : nouvelle mesure : chaque nouvelle mesure, avec toutes ses valeurs en variables.
• Flipr : évaluation de l’eau changée : le pH ou le chlore a changé d’évaluation. Filtrez sur le paramètre et sur la nouvelle évaluation (« Trop bas » et « Trop haut » pour une alerte).
• Flipr : aucune mesure depuis 24 heures : pile vide, mode hiver, réseau. Déclenché une fois.
• Flipr Hub : filtration basculée : le Hub a démarré ou arrêté la pompe de lui-même (programmation, mode automatique, application Flipr). Pas déclenché par les commandes envoyées depuis Gladys.

Actions :

• Flipr : lire la dernière mesure : température, pH, chlore, redox, batterie, évaluations et une phrase toute prête.
• Flipr Hub : changer le mode de filtration : automatique, manuel ou programmation.

Exemples :

• Quand l’évaluation de l’eau passe à « Trop bas » ou « Trop haut » → envoyer un message avec {{triggerEvent.data.summary}}.
• Quand il n’y a aucune mesure depuis 24 heures → me rappeler de vérifier le Flipr.
• Chaque soir à 20 h → lire la dernière mesure, puis envoyer son résumé.

Widget

Tableau de bord → Modifier → ajoutez Eau de la piscine. Choisissez l’analyseur, le Hub, le graphique (température, pH, chlore, redox ou aucun) et sa période. Le graphique montre l’historique que Gladys conserve : il apparaît dès que l’appareil de l’analyseur est ajouté.

Dépannage

• « Flipr a refusé l’e-mail ou le mot de passe » : vérifiez-les dans l’application Flipr, puis dans la configuration.
• Aucun appareil dans Découverte : le compte n’a ni analyseur ni Hub, ou Flipr n’a pas encore été lu : utilisez « Tester la connexion ».
• « Pas encore de mesure » : le Flipr est en mode hiver ou pas calibré ; il mesure à nouveau une fois remis à l’eau et calibré dans l’application Flipr.
• Valeurs un peu en retard : Flipr mesure environ une fois par heure, et l’intégration lit le cloud toutes les 15 minutes par défaut.
• « Le cloud Flipr ne répond pas » ou « Flipr limite les requêtes » : l’intégration réessaie à la lecture suivante. La société derrière Flipr a été liquidée en 2025 et le service fonctionne de nouveau depuis 2026 : si le problème dure, vérifiez que l’application Flipr fonctionne encore.
• Journaux : ajoutez la variable d’environnement DEBUG=gladys-integration-sdk, puis ouvrez une issue sur GitHub avec les versions de Gladys et de l’intégration et les journaux (le mot de passe n’y apparaît jamais).

L’API utilisée est celle de l’application Flipr : Flipr n’en publie aucune documentation officielle, et elle peut changer sans prévenir.

Paramètres de configuration

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

Paramètre	Type	Obligatoire	Description
Compte Flipr	section	Non	Saisissez l’e-mail et le mot de passe que vous utilisez dans l’application Flipr. L’intégration lit vos mesures dans le cloud Flipr, comme le fait l’application : aucune donnée ne part ailleurs.
E-mail	string	Oui
Mot de passe	secret	Oui
Options	section	Non	Un analyseur Flipr envoie une mesure environ une fois par heure. Chaque lecture coûte une requête par module au cloud Flipr : inutile de le lire toutes les deux minutes.
Intervalle de lecture (min)	number	Non	De 5 à 60 minutes, 15 par défaut.
Langue des textes	select	Non	Noms des fonctionnalités, modes de filtration, évaluations de l’eau et résumés des scènes. Automatique : la langue de votre tableau de bord, dès que le widget Flipr a été affiché.

Comment installer Flipr dans Gladys

1. Dans Gladys, ouvrez Intégrations : Flipr 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/william-de71/gladys-flipr:0.1.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).
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/William-De71/gladys-flipr.

Flipr 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

Flipr 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 William-De71, 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

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 🙂