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, volume, coupure du son, choix de la chaîne par son numéro, contrôle de la lecture (lecture/pause, stop, précédent, suivant, retour et avance rapide) et touches de la télécommande (chaîne suivante/précédente, TV, accueil, guide, info, enregistrement, flèches directionnelles, OK et retour).

    ℹ️ « Suivant » / « Précédent » ne changent pas de chaîne : ce sont des commandes de lecture (piste ou chapitre du média en cours). Pour zapper, utilisez « Chaîne » (numéro direct), ou « Chaîne suivante » / « Chaîne précédente ».

    ℹ️ « Lecture » et « Pause » agissent comme une bascule : l'API Freebox n'expose qu'une seule commande play_pause pour les deux, les deux boutons ont donc le même effet.

    ℹ️ « Muet » est également une bascule : chaque appui coupe ou rétablit le son selon l'état réel du player, lu juste avant l'envoi de la commande.

    ⚠️ Certaines touches ne sont pas garanties. Seuls l'allumage, le volume, le choix de chaîne par numéro et les commandes de lecture reposent sur l'API documentée par Free. Les touches de navigation (flèches, OK, retour, accueil, guide, info, chaîne suivante/précédente) utilisent un point d'entrée non documenté, susceptible de cesser de fonctionner après une mise à jour de la Freebox.

    ℹ️ Les commandes de lecture dépendent de ce que le player est en train de lire : sur l'écran d'accueil, sans média actif, elles peuvent rester sans effet. Utilisez alors les touches de navigation pour lancer une chaîne ou un contenu.

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

⏱️ Vous avez environ 55 secondes pour appuyer sur la flèche de droite du LCD. Passé ce délai, l'appairage échoue avec le message « l'autorisation n'a pas été confirmée sur l'écran LCD » : relancez simplement l'action « Appairer avec la Freebox ». Pensez à être à côté de votre Freebox avant de cliquer sur le bouton.

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). Vous disposez d'environ 55 secondes pour confirmer : placez-vous près de votre Freebox avant de cliquer ; si le délai expire, relancez simplement l'action. 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.8), 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