EXT‐Freebox - bugsounet/MMM-Bugsounet GitHub Wiki
(French user only)
EXT-Freebox permet d'afficher, sur votre Mirroir, divers informations de votre Freebox en temps réél.
- Modèle de la Freebox.
- Bande Passante.
- Adresse IP.
- Appareils connectés.
- Débit utilisé (total et/ou par appareil).
- Ping de votre mirroir vers google.fr (ou autre)
- Type de connexion utilisé par les appareils. (ethernet, wifi, machine virtuelle)
Screenshot

Installation
- Exécuter l'installation du module depuis le dossier MMM-Bugsounet:
cd ~/MagicMirror/modules/MMM-Bugsounet
npm run setup:EXT-Freebox
- Associer
EXT-Freeboxà votre Freebox Server.
cd ~/MagicMirror/modules/MMM-Bugsounet
npm run setup:EXT-Freebox:register
Merci de vérifier votre écran LCD de votre Freebox Server et autoriser l'enregistrement de l'application.
-
Validez l'association par la flèche de droite de l'écran LCD de votre Freebox Server.
-
Sauvegarder précieusement l'information de connexion.
freebox: {
app_token: 'xxxxxxxxxxxxxxxxxxxxxxxxx',
app_id: 'fbx.EXT-Freebox',
api_domain: 'xxxxx.fbxos.fr',
https_port: xxxx,
api_base_url: '/api/',
api_version: 'xxx.x'
},
Attention: Les informations fournies par la Freebox sont à considérer comme des identifiants! Ne JAMAIS les divulguer car cela permet d'avoir un accès à votre freebox à distance!
Configuration
Pour afficher le module, inserez ceci dans votre ficher config.js
Configuration Minimale
Remplacer le contenu de freebox par les valeurs de connexion fourni par votre Freebox Server.
{
module: "MMM-Bugsounet/EXTs/EXT-Freebox",
position: "top_left",
animateIn: "fadeInLeft",
animateOut: "fadeOutLeft",
config: {
freebox: { // inserez vos informations de connexion
app_token: 'xxxxxxxxxxxxxxxxxxxxxxxxx',
app_id: 'fbx.EXT-Freebox',
api_domain: 'xxxxx.fbxos.fr',
https_port: xxxx,
api_base_url: '/api/',
api_version: 'xxx.x'
},
}
},
Configuration Personalisée
Ceci est la configuration par defaut si vous definissez aucune valeurs
{
module: "MMM-Bugsounet/EXTs/EXT-Freebox",
position: 'top_left',
animateIn: "fadeInLeft",
animateOut: "fadeOutLeft",
config: {
freebox: { // inserez vos informations de connexion
app_token: 'xxxxxxxxxxxxxxxxxxxxxxxxx',
app_id: 'fbx.EXT-Freebox',
api_domain: 'xxxxx.fbxos.fr',
https_port: xxxx,
api_base_url: '/api/',
api_version: 'xxx.x'
},
debug: false,
verbose: false,
updateDelay: 5 * 1000,
zoom: 110,
activeOnly: false,
showModel: true,
showIcon: true,
showButton: true,
showBandWidth: true,
showRate: true,
showClient: true,
showClientRate: true,
showEthClientRate: false,
showClientRateDownOnly: false,
showClientIP: false,
showClientCnxType: true,
showWifiStandard: true,
showFree: true,
showIP: true,
showPing: true,
pingAdress: "google.fr",
textWidth: 250,
excludeMac: [],
sortBy: null,
checkFreePlug: false,
checkSFP: false
}
},
| Option | Description | Type | Defaut |
|---|---|---|---|
| debug | Active le mode de debuguage | Boolean | false |
| verbose | Active le mode verbose en console | Boolean | false |
| updateDelay | Delai de mise à jour en ms | Number | 5 * 1000 (5 sec) |
| zoom | Zoom global du module (en pourcent) -- 100 est considéré 100% | Number | 110 |
| activeOnly | Affiche uniquement les appareils connectés | Boolean | false |
| showModel | Affiche le model de Freebox utilisé | Boolean | true |
| showIcon | Affiche les icones personalisés des appareils | Boolean | true |
| showButton | Affiche les boutons de status de connexion | Boolean | true |
| showBandWidth | Affiche la bande passante de votre connexion | Boolean | true |
| showRate | Affiche le débit utilisé de votre connexion | Boolean | true |
| showClient | Affiche la liste des appareils | Boolean | true |
| showClientRate | Affiche le débit des appareils | Boolean | true |
| showEthClientRate | Affiche le débit de connexion de l'appareil connecté sur le port ethernet. | Boolean | false |
| showClientRateDownOnly | Affiche uniquement le debit descendant des appareils | Boolean | true |
| showClientIP | Affiche l'addresse IPv4 des appareils | Boolean | false |
| showClientCnxType | Affiche le type de connexion des appareils | Boolean | true |
| showWifiStandard | Affiche la norme de connexion utilisée | Bolean | true |
| showFree | Affiche les Freebox Player et répéteurs | Boolean | true |
| showIP | Affiche l'adresse ip de votre connexion | Boolean | true |
| showPing | Affiche le ping entre le mirroir et google.fr | Boolean | true |
| pingAdress | personalisation de l'adresse a ping | String | google.fr |
| textWidth | Largeur du texte à afficher (mini: 220) | Number | 250 |
| excludeMac | Ne pas afficher les appareils connectés avec certaines adresses MAC | Array | [] |
| sortBy | Classement des appareils connectés par : "type", "name", "mac" ou null pour classement par defaut | String | null |
| checkFreePlug | Permet de verifier et d'afficher les connexions via FreePlug sur le réseau (Freebox Delta uniquement) | Boolean | false |
| checkSFP | Permet de verifier et d'afficher les connexions via la carte SFP sur le réseau (Freebox Delta/Ultra uniquement) | Boolean | false |
Note sur showEthClientRate:
- Ne fonctionne que si un seul appareil est connecté par port ethernet.
- Activer sur vous n'utiliser pas de swtich/hub sur votre Freebox!
Legende des icones de connexion
Connexion depuis le port Ethernet numéro 1
Connexion depuis le port Ethernet numéro 2
Connexion depuis le port Ethernet numéro 3
Connexion depuis le port Ethernet numéro 4
Connexion depuis le port CPL
Connexion depuis le port SFP
Connexion depuis le wifi 2.4Ghz
Connexion depuis le wifi 5Ghz
Connexion depuis le wifi 6Ghz- ᴿ Cconnexion depuis un répéteur Wifi
Machine Virtuelle
Connexion indéterminée
Legende des icones de norme de connexion wifi
- Connexion avec la norme 802.11b (wifi 1)
- Connexion avec la norme 802.11a (wifi 2)
- Connexion avec la norme 802.11g (wifi 3)
- Connexion avec la norme 802.11n (wifi 4)
- Connexion avec la norme 802.11ac (wifi 5)
- Connexion avec la norme 802.11ax (wifi 6)
- Connexion avec la norme 802.11be (wifi 7)
Personalisation de l'affichage des noms et des icones des appareils connectés
- Utilisez l'interface
FreeboxOSde votre Freebox Server (Periphériques Réseau) - Utilisez l'application
Freebox Connectsur votre téléphone (Appareils)
Notes
- Les essais ont été effectués avec une Freebox Ultra.
- Merci de me confirmer le bon fonctionnement sur les autres Freebox!
- Ne fonctionne pas avec les Freebox Crystal et antérieur (API différante)
Test Freebox
- Ultra: api v11.1 (Freebox OS v4.8)
- Révolution: api v10.2 (Freebox OS v4.7)