Aller au contenu principal

Intégration Freebox pour Gladys Assistant

Intégration Freebox pour Gladys Assistant

Contrôlez la domotique, les players et les caméras de votre Freebox depuis Gladys.

Voir sur GitHubToutes les intégrations externes

Cette intégration permet de contrôler votre Freebox depuis Gladys Assistant, directement sur votre réseau local, sans cloud.

Fonctionnalités​

  • Domotique Freebox : capteurs d'ouverture, capteurs de mouvement, niveau de batterie, volets roulants (état et position).
  • Freebox Players (modèles compatibles, voir plus bas) : allumage détecté (lecture seule), volume, coupure du son, et contrôle de la lecture (play, pause, stop, précédent, suivant, retour et avance rapide).
  • Caméras Freebox : image affichée sur le tableau de bord (rafraîchie automatiquement) et à la demande, via une capture ffmpeg du flux vidéo.
  • Actions : appairer, tester la connexion, redémarrer la Freebox et désappairer, directement depuis l'écran de configuration.

Prérequis​

  • Une Freebox (Delta, Ultra, Pop, Revolution...) avec le serveur domotique activé.
  • Gladys Assistant et cette intégration doivent être sur le même réseau local que la Freebox (accès à mafreebox.freebox.fr).

Appairage​

  1. Ouvrez l'écran de configuration de l'intégration Freebox dans Gladys.
  2. Cliquez sur le bouton « Appairer avec la Freebox ».
  3. Rendez-vous devant votre Freebox Server : l'écran LCD affiche une demande d'autorisation. Appuyez sur la flèche de droite pour valider.
  4. L'appairage est mémorisé : vous n'avez à le faire qu'une seule fois.

Permissions à cocher (important)​

Après l'appairage, ouvrez les réglages de votre Freebox :

Freebox OS > Paramètres > Gestion des accès > Applications > Gladys Assistant

et cochez les permissions suivantes :

  • Gestion de la domotique et de l'alarme (capteurs, volets)
  • Accès aux caméras
  • Contrôle du Freebox Player

⚠️ Sans ces cases cochées, les appareils correspondants n'apparaîtront pas lors de la découverte. C'est la cause la plus fréquente d'un appareil manquant.

Une fois les permissions accordées, lancez une découverte des appareils : Gladys vous proposera tous les appareils détectés sur votre Freebox. Choisissez ceux que vous souhaitez créer.

Limitation des Freebox Player POP / Android TV​

Les Freebox Player POP (et autres players basés sur Android TV) ne sont pas contrôlables par cette intégration : Free n'expose pas l'API de contrôle locale sur ces modèles (le player est signalé avec api_available: false et est donc ignoré). Pour piloter un Player POP, il faut passer par une intégration Android TV (protocole ADB), en dehors du périmètre de cette intégration.

Les Player des Freebox Delta et Revolution (qui exposent l'API player locale) restent, eux, pleinement contrôlables.

Redémarrer la Freebox​

L'action « Redémarrer la Freebox » de l'écran de configuration relance votre Freebox Server. Il n'existe pas d'action d'extinction : l'API Freebox n'expose que le redémarrage (une box éteinte ne pourrait pas être rallumée à distance).

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Connectez votre FreeboxsectionNonCette intégration communique avec votre Freebox Server sur votre réseau local. Pour l'appairer, cliquez sur « Appairer avec la Freebox » ci-dessous, puis confirmez physiquement l'autorisation sur l'écran LCD de votre Freebox Server (flèche de droite sur la box). L'appairage n'est à faire qu'une seule fois.
Accordez les permissionssectionNonAprès l'appairage, ouvrez les réglages de votre Freebox (Freebox OS > Paramètres > Gestion des accès > Applications > Gladys Assistant) et cochez les permissions Domotique, Caméra et Player. Sans elles, les appareils correspondants n'apparaîtront pas lors de la découverte.

Comment installer Freebox dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Freebox 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-freebox:1.0.7), 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-freebox.

Freebox nécessite Gladys >=4.84.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​

Freebox 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.

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 🙂
Dernière mise à jour le