Aller au contenu principal

Intégration domotique Freebox, gratuite et open source

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

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, contacts anti-arrachement, volets roulants (état et position), centrale d'alarme (armement, désarmement, état) et télécommande d'alarme.

  • 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 le volume, la coupure du son, le choix de chaîne par numéro et les principales commandes de lecture reposent sur l'API documentée par Free. L'allumage et les touches de navigation (flèches, OK, retour, accueil, guide, info, chaîne suivante/précédente) simulent l'appui sur une touche de la télécommande virtuelle, 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 chaque minute) et à la demande, via une capture ffmpeg du flux vidéo.

  • Connexion internet : un appareil Freebox Server avec l'état de la connexion et les débits descendant et montant, pour surveiller votre ligne et déclencher une scène quand elle tombe.

  • 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, alarme)
  • Accès aux caméras
  • Contrôle du Freebox Player
  • Modification des réglages de la Freebox : uniquement pour l'action « Redémarrer la Freebox ».

⚠️ 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.

Connexion internet​

L'appareil Freebox Server affiche l'état de votre connexion internet et ce qu'elle transporte en ce moment :

FonctionnalitéValeur
Internet connectionup (active), down (inactive), going_up ou going_down (en cours)
Download ratedébit descendant actuel, en Mbit/s
Upload ratedébit montant actuel, en Mbit/s

Il est lu toutes les 30 secondes et ne demande aucune permission dans Freebox OS. Pour être prévenu quand la ligne tombe, créez une scène déclenchée par Freebox Server → Internet connection avec le texte down ; une seconde scène sur up vous indique son retour.

ℹ️ Vous utilisez déjà l'intégration ? Cet appareil est nouveau : ouvrez l'onglet Découverte, cliquez sur Scanner, puis ajoutez Freebox Server. Vos appareils existants ne sont pas modifiés.

ℹ️ Les valeurs sont désormais envoyées à Gladys quand elles changent : un capteur qui reste fermé n'ajoute plus un point toutes les 30 secondes à son historique, et un appareil que vous ajoutez reçoit aussitôt ses valeurs actuelles.

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

En cas de problème​

  • « Freebox not found on the local network » (ou ENOTFOUND mafreebox.freebox.fr) : Gladys n'arrive pas à joindre mafreebox.freebox.fr. Vérifiez que Gladys est bien derrière la Freebox (et non derrière un autre routeur) et que cette adresse est résolue sur votre réseau.
  • Un appareil manque à la découverte : la permission correspondante n'est pas cochée dans Freebox OS (voir plus haut). Cochez-la, puis relancez un scan.
  • « Freebox session could not be opened » : l'autorisation a été révoquée dans Freebox OS. Cliquez sur « Désappairer », puis de nouveau sur « Appairer avec la Freebox ».
  • Redémarrage refusé : la permission « Modification des réglages de la Freebox » n'est pas cochée.
  • Pas d'image de caméra : vérifiez que la caméra affiche son flux dans Freebox OS. L'image est rafraîchie chaque minute ; la vue en direct en capture une nouvelle à la demande.
  • Pas d'appareil « Freebox Server » : il est apparu avec cette version. Lancez un scan depuis l'onglet Découverte, puis ajoutez-le.

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. L'action « Redémarrer la Freebox » nécessite en plus la permission de modification des réglages de la Freebox.

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.3.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-freebox.

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