Intégration domotique Orange Livebox, gratuite et open source
Connecteur non officiel : présence Wi-Fi Livebox, internet, Wi-Fi et appels manqués, en local.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Connecteur non officiel, sans lien avec Orange. Il parle à votre Livebox sur le réseau local, via la même API que la page d'administration de la box (http://livebox/) : rien ne sort de chez vous. Fonctionne avec les Livebox 3, 4, 5, 6 et 7 (firmware Sagemcom / Sercomm). Livebox est une marque d'Orange.
Ce que vous obtenez
| Surface | Contenu |
|---|---|
| L'appareil Livebox | internet connecté, type de liaison (fibre, ADSL/VDSL), IP publique, durée de fonctionnement, interrupteurs Wi-Fi et Wi-Fi invité, appareils en ligne (total et en Wi-Fi), appels manqués et dernier appel de la ligne fixe, et sur une box xDSL les débits descendant / montant |
| Un capteur de présence par appareil | chaque téléphone, tablette, TV ou ordinateur que la box connaît en Wi-Fi (et en Ethernet si vous le demandez), nommé comme dans la Livebox : la détection « qui est à la maison » la plus simple |
| Déclencheurs de scène | appareil connecté, appareil déconnecté, appel manqué, internet rétabli ou coupé |
| Actions de scène | appareils en ligne (nombre et noms), Wi-Fi on / off (principal ou invité), redémarrer |
| Widgets | Livebox (état, liaison, durée, compteurs, boutons Wi-Fi) et Appareils Livebox (qui est en ligne) |
Installation
- Installez l'intégration. L'adresse
192.168.1.1et l'utilisateuradminconviennent à une Livebox standard ; changez-les si besoin. - Saisissez le mot de passe d'administration : celui de http://livebox/. Par défaut, ce sont les 8 premiers caractères de la clé Wi-Fi imprimée sur la box (ou celui que vous avez défini dans les réglages de la Livebox).
- Enregistrez, cliquez sur Tester la connexion : le modèle, le firmware et l'état d'internet s'affichent.
- Ouvrez Découverte : la Livebox et tous les appareils Wi-Fi qu'elle connaît sont proposés. Ajoutez la box et les appareils à suivre (vos téléphones pour la présence, la TV pour « quand la TV s'allume »…). Cochez appareils filaires dans la configuration pour proposer aussi ceux en Ethernet.
- Placez les widgets sur un tableau de bord.
Tout est lu toutes les 30 secondes par défaut (Intervalle de rafraîchissement) ; les informations de la box toutes les 10 minutes, la ligne xDSL toutes les 5.
Scènes
- Appareil connecté / déconnecté : choisissez un appareil suivi, ou laissez vide pour tous. « Téléphone connecté » est le « je suis rentré » classique ; ajoutez un délai à la déconnexion pour absorber un téléphone qui s'endort.
- Appel manqué : la ligne fixe a sonné sans réponse ; les variables
portent le numéro et le nom de l'appelant (quand la box le connaît).
Envoyez une notification avec
{{triggerEvent.data.number}}. - Internet rétabli ou coupé : pour une notification, ou une scène de surveillance : après 10 minutes de coupure, lancer l'action redémarrer.
- L'action appareils en ligne donne
{{online}},{{wifi_online}}et{{names}}; Wi-Fi on / off bascule le réseau principal ou invité (mode nuit, arrivée d'invités).
Les capteurs de présence sont des capteurs de présence Gladys ordinaires : ils fonctionnent avec les déclencheurs natifs « maison vide » et « quelqu'un est rentré », et avec l'alarme.
Dépannage
- « La Livebox a refusé la connexion » : le mot de passe est celui de la page d'administration, pas la clé Wi-Fi elle-même (ses 8 premiers caractères par défaut). Certaines box bloquent la connexion quelques minutes après plusieurs échecs.
- « La Livebox ne répond pas » : vérifiez l'adresse ; l'intégration tourne dans un conteneur sur l'hôte Gladys, qui doit joindre la box (même réseau, ou une route vers elle).
- Un appareil ne passe jamais « absent » : la Livebox garde un appareil « actif » un moment après son départ (plusieurs minutes en Wi-Fi) ; un téléphone en veille profonde peut aussi disparaître et revenir. Utilisez un délai dans la scène.
- Pas de débit descendant / montant : ils viennent de la ligne xDSL ; une box fibre ne rapporte que l'état d'internet et l'IP.
- Pas d'appels manqués : la ligne fixe doit être sur la box (VoIP) et le journal lisible avec ce compte ; décochez Lire le journal d'appels sinon.
- Logs : le niveau de log de l'intégration se règle avec la variable
LOG_LEVEL.
Confidentialité
Le mot de passe est stocké chiffré par Gladys et envoyé uniquement à la box sur votre réseau local. Les noms d'appareils, adresses et le journal d'appels restent dans Gladys.
Paramètres de configuration
Voici les paramètres demandés par Orange Livebox dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Livebox Orange | section | Non | Connecteur non officiel, sans lien avec Orange. Il parle à la Livebox sur votre réseau local (la même API que http://livebox/), sans cloud : chaque appareil connecté à la box devient un capteur de présence dans Gladys, la box elle-même expose la liaison internet, les interrupteurs Wi-Fi et Wi-Fi invité, les appareils en ligne et les appels manqués de la ligne fixe. Fonctionne avec les Livebox 3, 4, 5, 6 et 7. Livebox est une marque d'Orange. |
| Adresse de la Livebox | string | Non | L'adresse IP ou le nom de la box sur votre réseau. |
| Utilisateur | string | Non | |
| Mot de passe d'administration | secret | Oui | Le mot de passe de http://livebox/ : par défaut les 8 premiers caractères de la clé Wi-Fi imprimée sur la box. Stocké chiffré par Gladys. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture des appareils, de la liaison et des appels. |
| Proposer aussi les appareils filaires (Ethernet) comme capteurs de présence | boolean | Non | |
| Lire le journal d'appels de la ligne fixe (appels manqués) | boolean | Non |
Comment installer Orange Livebox dans Gladys
- Dans Gladys, ouvrez Intégrations : Orange Livebox 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/lm1lc3n7/gladys-livebox:0.1.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/LM1LC3N7/gladys-livebox.
Orange Livebox 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
Orange Livebox 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 LM1LC3N7, 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