| Name | LiveboxMonitor JSON |
| Version |
1.4.8
JSON |
| download |
| home_page | None |
| Summary | Advanced graphical user interface to control a Livebox 4, 5, 6 or 7 |
| upload_time | 2024-07-06 15:29:19 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT License Copyright (c) 2022-24 Pierre Dor Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
livebox
sysbus
ui
monitoring
traffic
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
PyQt6
requests
python-dateutil
cryptography
pyqtgraph
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
#  LiveboxMonitor
L'application [LiveboxMonitor](https://github.com/p-dor/LiveboxMonitor) est une interface graphique dynamique pour :
- Contrôler les appareils qui se connectent à la Livebox et détecter rapidement les intrusions,
- Enregistrer le journal d'activités et recevoir des notifications par email aux connexions ou déconnexions,
- Obtenir des statistiques détaillées de trafic, par appareil, global,
- Visualiser graphiquement les statistiques de trafic sur plusieurs jours, par appareil ou par interface,
- Obtenir beaucoup de détails sur la Livebox elle-même et contrôler la qualité de sa ligne fibre,
- Avoir beaucoup de détails sur les appareils qui se connectent (actifs ou non),
- Lire le journal des événements d'un appareil donné,
- Contrôler de manière fine les réglages du serveur DHCP et des règles NAT/PAT,
- Contrôler l'état du Wifi,
- Contrôler les appels téléphoniques ainsi que la liste des contacts,
- Contrôler un ou plusieurs répéteurs Wifi Orange connectés.
**AVERTISSEMENT** : le programme a été **conçu pour contrôler une Livebox 5 et a été adapté avec quelques tests pour les Livebox 4, 6 et 7**, des tests supplémentaires avec une Livebox 4, 6 ou 7 seraient bienvenus. Les architectures étant totalement différentes, **le logiciel n'est pas compatible avec la "Livebox Pro 4"**.
L'application est dynamique car elle réagit aux événements envoyés par la Livebox et les interprète.
## Sections de cette documentation
1. [Installation](#install)
2. [Configuration minimale](#minimalconfig)
3. [À propos de l'auteur](#author)
4. [Discussion](#discussion)
5. [Prise en main](#handling)
6. [Profils](#profiles)
7. [Options de ligne de commande](#commandline)
8. [Accès à distance](#remoteaccess)
9. [Configuration](#configuration)
10. [Linux](#linux)
11. [Appareils - Liste des appareils connectés](#devicelist)
12. [Stats/Infos Livebox - Statistiques de trafic et infos avancées de la Livebox](#infos)
13. [Graphes - Courbes de trafic par interface et par appareil](#graphs)
14. [Infos Appareil - Informations détaillées pour chaque appareil connu](#deviceinfos)
15. [Événements - Liste des événements reçus pour chaque appareil connu](#events)
16. [DHCP - Contrôle fin du serveur DHCP](#dhcp)
17. [NAT/PAT - Règles de redirection de port et de protocole](#natpat)
18. [Téléphone - Liste des appels téléphoniques / liste des contacts](#phone)
19. [Actions - Boutons d'actions et de contrôle](#actions)
20. [Onglets répéteurs Wifi](#repeaters)
21. [Gestion et personnalisation des icônes d'appareil](#icons)
## Installation <a id="install"></a>
L'application est écrite en [Python 3.9](https://www.python.org/downloads/) et est basée sur [PyQT 6](https://pypi.org/project/PyQt6/) pour l'interface graphique et sur [PyQtGraph](https://www.pyqtgraph.org/) pour les graphes statistiques.
Les autres dépendances sont `requests`, `cryptography` et `python-dateutil`.
**Note** : Le module `LmSession` est une adaptation du package [sysbus](https://github.com/rene-d/sysbus) pour les Livebox 5,6 & 7. Le support des événements a aussi été rajouté.
### Téléchargement - version 1.4 (24/04/2023)
Des programmes autonomes construits avec [PyInstaller](https://pyinstaller.org) sont disponibles pour les plateformes Windows & MacOS :
- Windows : [Télécharger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor.exe)
- Windows avec console : [Télécharger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Console.exe)
- MacOS (Intel) : [Télécharger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor.dmg)
- MacOS (Intel) avec console : [Télécharger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Console.dmg)
- MacOS (Silicon) : [Télécharger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Silicon.dmg)
- MacOS (Silicon) avec console : [Télécharger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Silicon_Console.dmg)
Nouveautés de la version 1.4 et historique des versions : [ici](https://github.com/p-dor/LiveboxMonitor/blob/main/docs/ReleaseHistory.md) ou [ici](https://github.com/p-dor/LiveboxMonitor/releases).
### PyPI
Installation :
```
pip install LiveboxMonitor
```
Mise à jour :
```
pip install --upgrade LiveboxMonitor
```
Lancement :
```
LiveboxMonitor
```
### Utilisation directe via les sources
Installation :
```
git clone https://github.com/p-dor/LiveboxMonitor.git
cd LiveboxMonitor
pip install -r requirements.txt
```
Lancement :
```
cd src\LiveboxMonitor
python3 lbm.py
```
Ou via un virtualenv.
Installation :
```
git clone https://github.com/p-dor/LiveboxMonitor.git
cd LiveboxMonitor
virtualenv -p python3 .venv
source .venv/bin/activate
pip install -r requirements.txt
```
Lancement :
```
cd src\LiveboxMonitor
source .venv/bin/activate
python3 lbm.py
```
## Configuration minimale <a id="minimalconfig"></a>
Étant donné les dépendances documentées de [Python 3.9](https://www.python.org/downloads/release/python-390/), [PyInstaller](https://pyinstaller.org/en/stable/requirements.html) et de [PyQt6](https://www.qt.io/product/qt6/technical-specifications) la configuration minimale requise pour faire tourner cette application est :
- Windows : **Windows 10** ou plus récent.
- MacOS : **10.15 (Catalina)** ou plus récent.
## À propos de l'auteur <a id="author"></a>
L'auteur de ce logiciel est un professionnel de l'informatique n'ayant aucun lien avec Orange. Ce logiciel n'est donc en rien un produit d'Orange.
Aucune documentation officielle des APIs de la Livebox n'étant disponible, l'élaboration a été effectuée à partir de techniques classiques de rétro-ingénierie (reverse engineering), et l'ensemble du projet sur le temps libre de l'auteur.
## Discussion <a id="discussion"></a>
Un [fil de discussion](https://lafibre.info/orange-les-news/controler-son-reseau-livebox-5-ou-6/) est actif sur le forum [lafibre.info](https://lafibre.info). Il est possible d'y poster vos commentaires, résultats de tests ou de faire des demandes de fonctionnalités.
## Prise en main <a id="handling"></a>
L'interface se veut intuitive mais il vaut mieux se reporter à la documentation pour comprendre certains comportements ou représentations.
Les points importants à comprendre avant de commencer :
- La connexion s'établit avec exactement les mêmes informations que pour accéder à l'interface Web de configuration de la Livebox. Pour l'URL il faut essayer http://livebox.home/, http://livebox/ ou http://192.168.1.1/. Pour l'utilisateur il faut laisser à la valeur par défaut `admin`. Et pour le mot de passe c'est soit ce que vous avez indiqué vous-même soit le mot de passe d'origine. Plus d'informations [ici pour la Livebox 5](https://assistance.orange.fr/livebox-modem/toutes-les-livebox-et-modems/installer-et-utiliser/piloter-et-parametrer-votre-materiel/l-interface-de-configuration/livebox-5-acceder-a-l-interface-de-configuration_292471-827404), ou [ici pour la Livebox 6](https://assistance.orange.fr/livebox-modem/toutes-les-livebox-et-modems/installer-et-utiliser/piloter-et-parametrer-votre-materiel/l-interface-de-configuration/livebox-6-acceder-a-l-interface-de-configuration_363963-897414).
- Il est normal que lors du premier lancement de l'application tous les appareils soient marqués comme inconnus (**INCONNU** en rouge). En effet un des buts de ce programme est d'identifier rapidement des appareils inconnus connectés sur le réseau grâce à une base de noms locale (le fichier `MacAddrTable.txt`). Il faut donc commencer par nommer chaque appareil que vous jugez légitime grâce au bouton `Assigner Nom...` de l'onglet `Infos Appareil`. Cette base locale constituera la référence de confiance de tous les appareils légitimes sur votre réseau. Le bouton `Assigner Nom...` vous permettra aussi de facilement assigner le même nom que celui qui a été donné à la Livebox.
- Il est normal que les statistiques réseau apparaissent et disparaissent. En effet le programme rafraîchit ces statistiques toutes les 3 secondes par défaut (ou toutes les 30 secondes dans certains cas), et si d'un rafraîchissement à l'autre il n'y a pas eu de transfert la case devient vide. Ce choix a été fait pour permettre de mieux visualiser les cases non-vides, là où il se passe quelque chose.
- Tous les onglets peuvent être déplacés à la souris pour être mis dans l'ordre qui vous convient. Cet ordre sera restauré au prochain lancement du programme.
- Toutes les colonnes dans le programme sont redimensionnables à la souris sauf certaines qui s'élargissent dynamiquement en fonction de la taille de la fenêtre. Donc, en fonction de la situation, vous pouvez soit redimensionner la colonne soit la fenêtre avec la souris pour ajuster la largeur d'une colonne.
- On peut copier la valeur de n'importe quelle cellule de liste dans le presse-papiers. Pour cela il suffit de cliquer sur la cellule et de taper Ctrl-C.
- Le programme dispose d'une barre de statut en bas de la fenêtre. Elle affiche sur la gauche des tâches en cours et sur la droite le nom du profil en cours (voir la section **Profils** ci-dessous). Un clic sur le nom de profil affichera la fenêtre pour en changer.
- Des **tooltips** sont disponibles dans l'interface pour vous aider à vous passer de la documentation.
## Profils <a id="profiles"></a>
Le programme supporte de pouvoir gérer plusieurs Livebox à l'aide de profils différents. Chaque profil doit avoir un nom unique. Par défaut un profil principal est créé automatiquement, mais il est possible d'en créer d'autres soit au démarrage du programme dans la fenêtre de sélection de profils soit dans les préférences du programme.
Si plusieurs profils sont configurés le nom du profil en cours est affiché dans le titre de la fenêtre principale entre crochets.
Plusieurs informations sont associées à chaque profil, telle que l'URL de la Livebox, son mot de passe, etc. Le programme associe aussi automatiquement l'adresse physique (MAC) de la Livebox sur laquelle la connexion s'est effectuée.
Que se passe-t-il au lancement du programme ?
- Si la touche `Ctrl` est enfoncée le programme affiche un dialogue pour sélectionner le profil à utiliser.
- Sinon, si un profil par défaut est configuré, il sera sélectionné.
- Sinon, le programme parcourt la liste des profils et cherche si une Livebox avec la même adresse physique que celle associée au profil répond à l'URL du profil. Le premier profil qui répond à ces critères est sélectionné.
- Si aucun profil trouvé, le programme affiche un dialogue pour sélectionner le profil à utiliser.
Le dialogue de sélection de profils vous prévient si vous tentez d'utiliser un profil pour une Livebox différente de celle avec lequel il est normalement associé. Si vous validez le dialogue, le profil sera mis à jour pour être associé à cette nouvelle Livebox. Le dialogue de sélection de profils vous permet aussi de créer un nouveau profil si aucun dans la liste ne convient.
## Options de ligne de commande <a id="commandline"></a>
- `--redir` `-r`
Permet de rediriger une URL configurée / utilisée par le programme pour se connecter à la Livebox ou à un répéteur Wifi.
Le format est `url1=url2`.
Exemple : `LiveboxMonitor --redir http://livebox/=http://myproxy:2080`
Avec cette option le programme utilisera plutôt l'URL 'http://myproxy:2080/' pour se connecter à 'http://livebox/'.
Cette option peut être utilisée plusieurs fois sur la même ligne.
## Accès à distance <a id="remoteaccess"></a>
Il est possible d'utiliser le programme à distance si l'accès à distance de la Livebox est activé.
Dans la configuration de la Livebox, cliquez sur la tuile "Mon accès à distance". Activez l'accès, configurez un nom, un mot de passe, et un numéro de port personnalisé. Vous pouvez aussi en profiter pour activer un DynDNS pour éviter de changer l'URL à chaque fois que votre IP internet change.
Votre URL de connexion devient alors quelque chose comme ceci : https://monIP:monPort/
Ou alors si vous avez configuré un DynDNS : https://monNomDeDomaine.com:monPort/
Évidement configurez aussi le nom et le mot de passe de connexion en fonction.
## Configuration <a id="configuration"></a>
### Répertoire de configuration
- Si le programme est lancé par son code source le répertoire de configuration est le même que celui contenant le fichier source de lancement `lbm.py`.
- Si le package PyPI (installation avec la commande 'pip') ou les programmes construits avec [PyInstaller](https://pyinstaller.org) sont utilisés, le répertoire de configuration se trouve dans les répertoires standards du système :
- Windows : `%APPDATA%\LiveboxMonitor`
- MacOS : `~/Library/Application Support/LiveboxMonitor`
Le programme créé automatiquement dans son répertoire de configuration deux fichiers au format JSON :
- `Key.txt` : clef de chiffrement unique générée pour crypter tous les mots de passe. Cette clef est elle-même cryptée avec une clef qui est calculée par le programme à partir des caractéristiques uniques de votre PC (y compris son nom). Si quelque chose de significatif change sur votre PC (le processeur, l'OS, son nom, etc), cette clef sera régénérée automatiquement et tous vos mots de passe devront être ressaisis.
- `Config.txt` : contient tous les paramètres de l'application.
- `MacAddrTable.txt` : contient la correspondance entre les adresses MAC et les noms d'appareil.
### Le fichier Config.txt
Ce fichier est géré automatiquement par l'application et il ne devrait pas être nécessaire de l'éditer. Les réglages principaux se font via le bouton `Préférences...` de l'onglet `Actions`.
À savoir :
- Les mots de passe y sont stockés cryptés grace à la clef de chiffrement du fichier `Key.txt`.
- La clef `Repeaters` est générée automatiquement par le programme si des mots de passe différents sont utilisés pour le ou les répéteurs Wifi Orange connectés. La structure de ce paramètre est aussi au format JSON, utilise pour clef les adresses MAC des répéteurs, et référence pour chaque répéteur les valeurs 'User' & 'Password'.
### Le fichier MacAddrTable.txt
Ce fichier est géré automatiquement par l'application et il ne devrait pas être nécessaire de l'éditer.
Les clefs correspondent aux adresses MAC des appareils et les valeurs au nom attribué.
Tout appareil détecté dont l'adresse MAC n'est pas répertoriée sera affiché comme 'INCONNU' en rouge. Cette fonctionnalité est surtout utile pour détecter les nouveaux appareils ou des tentatives d'intrusions.
Pourquoi utiliser une base de noms locale alors que la Livebox stocke aussi des noms ?
- Parce que la Livebox "oublie" tout appareil qui ne s'est pas connecté depuis plus d'un mois.
- Parce que parfois la Livebox perd des noms de façon impromptue pour certains appareils. C'est le cas par exemple pour le nom des répéteurs Wifi.
Un fichier de noms local offre la garantie de savoir si un appareil est vraiment inconnu.
## Linux <a id="linux"></a>
En cas d'utilisation d'un virtualenv, si des erreurs de plugin Qt apparaissent, rajoutez ces commandes pour l'installation :
```
apt install qt6-base-dev
apt install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev
```
En cas d'erreurs avec Wayland, il est possible de changer le moteur de rendu de Qt avec la variable d’environnement `QT_QPA_PLATFORM`.
Par exemple : `QT_QPA_PLATFORM=xcb python3 lbm.py` permet d'utiliser X Window directement (qui éventuellement sera rendu avec Xwayland mais cela fonctionne).
Une autre méthode consiste à supprimer la variable d’environnement `WAYLAND_DISPLAY` uniquement pour l’exécution du programme et pas de façon globale, pour ce faire : `env -u WAYLAND_DISPLAY python3 lbm.py`.
## Appareils - Liste des appareils connectés <a id="devicelist"></a>
### Liste
La liste des appareils affiche les colonnes suivantes :
- **T** : icône correspondant au type de l'appareil. Ce type peut être attribué ou changé via le bouton `Assigner Type...` de l'onglet `Infos Appareil`.
- **Nom** : nom local de l'appareil. Ce nom peut être attribué, changé ou supprimé via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.
- **Nom Livebox** : nom de l'appareil tel que paramétré dans la Livebox et visible dans l'interface Web de la Livebox. Ce nom peut être attribué, changé ou supprimé via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.
- **MAC** : adresse MAC, aussi appelée adresse physique de l'appareil.
- **IP** : adresse IP v4 de l'appareil sur le LAN. Cette adresse s'affiche en caractères gras si cette adresse est réservée pour cet appareil dans la configuration DHCP de la Livebox. Et elle s'affiche en rouge si l'adresse n'est pas atteignable sur le réseau (unreacheable), typiquement lorsque l'appareil n'est pas actif.
- **Accès** : point d'accès de l'appareil sur le réseau. D'abord le nom de l'appareil, c'est-à-dire la Livebox elle-même ou le nom d'un des répéteurs Wifi Orange connectés, et ensuite l'interface sur cet appareil. `Eth` signifie une des prises Ethernet suivi du numéro de prise. `Wifi` signifie une connexion Wifi suivi par la bande de connexion.
- **A** : indique par une icône si l'appareil est actif ou non. Par défaut la liste est triée pour montrer d'abord les appareils actifs.
- **Wifi** : qualité de la connexion Wifi.
- **E** : indique par une icône avec un point d'exclamation  lorsqu'un événement est reçu pour cet appareil. La liste détaillée des événements, ainsi que le contenu des événements eux-mêmes, peuvent être consultés via l'onglet `Événements`.
- **Rx** : nombre d'octets reçus par l'appareil depuis le dernier démarrage de la Livebox.
- **Tx** : nombre d'octets envoyés par l'appareil depuis le dernier démarrage de la Livebox.
- **TauxRx** : taux d'octets reçus par seconde par l'appareil dans les dernières 30 secondes si affiché en noir, dans les trois dernières secondes si affiché en bleu (fréquence réglable dans les préférences).
- **TauxTx** : taux d'octets envoyés par seconde par l'appareil dans les dernières 30 secondes si affiché en noir, dans les trois dernières secondes si affiché en bleu (fréquence réglable dans les préférences).
Les statistiques d'octets envoyés ou reçus par seconde sont calculées grâce aux statistiques envoyées par la Livebox sous forme d'événement toutes les 30 secondes par appareil. Cette résolution étant peu significative le programme utilise une autre interface disponible pour les appareils Wifi uniquement pour obtenir des statistiques toutes les trois secondes (option pour les activer/désactiver dans les préférences, ainsi que la fréquence). Ces dernières sont affichées en bleu.
Si une statistique s'affiche en rouge cela signifie que des erreurs de transfert ont été détectées par la Livebox.
Les statistiques semblent parfois surprenantes, mais il s'agit d'une interprétation sans filtre de ce que renvoie la Livebox (il ne s'agit pas d'un défaut du programme).
**Note** : le trafic TV standard de la box TV UHD n'est pas comptabilisé dans les statistiques pour cet appareil. Par contre celui de services VOD tel que Netflix est bien comptabilisé.
### Boutons
L'onglet `Appareils` propose les boutons suivants :
- **`Rafraîchir`** : permet de forcer le rafraîchissement de la liste des appareils, non seulement dans cet onglet mais aussi dans les onglets `Infos Appareil` et `Événements`. Utile par exemple si le programme est actif alors que l'ordinateur sort de veille : des événements ayant probablement été raté par le programme, un rafraîchissement permettra de retrouver une vue à jour.
- **`Infos Appareil`** : permet de basculer dans l'onglet `Infos Appareil` pour l'appareil sélectionné et de voir directement ses informations.
- **`Événements Appareil`** : permet de basculer dans l'onglet `Événements` pour l'appareil sélectionné et de voir directement les événements reçus le concernant.
- **`IPv6...`** : permet d'avoir le statut d'activation de l'IPv6, l'adresse IPv6 de la Livebox ainsi que son préfixe, et la liste des appareils connectés ou non ayant une ou plusieurs IPv6 assignées.
- **`DNS...`** : permet d'avoir la liste des noms DNS assignés aux appareils. Ces noms DNS peuvent être attribués, changés ou supprimés via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.
## Stats/Infos Livebox - Statistiques de trafic et infos avancées de la Livebox <a id="infos"></a>
Les statistiques de trafic par interface sont affichées sous forme de liste en haut à gauche.
Et toutes les informations sont accessibles par les boutons, chaque bouton remplissant la liste d'attributs sur la droite. Il est aussi possible d'exporter l'ensemble des informations dans un fichier.
### Statistiques
Liste permettant de surveiller l'état du trafic :
- **Nom** : nom de l'interface réseau. `Fiber` concerne tout le trafic WAN, c'est-à-dire externe entre la Livebox et internet. `LAN` tout le trafic interne transitant à travers la Livebox. Ensuite on dispose des statistiques par interface précise. Les interfaces `Guest` concernent le trafic du réseau Wifi invité, s'il est activé.
- **Rx** : nombre d'octets reçus par l'interface. La fenêtre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont détectées. Attention ce compteur est circulaire et ne dépasse pas les 4 Go pour certaines interfaces. En effet pour d'autres, un compteur de plus haute résolution est interprété toutes les 30 secondes environ et qui vient remplacer au lancement du programme le compteur de base limité à 4 Go.
- **Tx** : nombre d'octets envoyés par l'interface. La fenêtre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont détectées. Attention ce compteur est circulaire et ne dépasse pas les 4 Go pour certaines interfaces. En effet pour d'autres, un compteur de plus haute résolution est interprété toutes les 30 secondes environ et qui vient remplacer au lancement du programme le compteur de base limité à 4 Go.
- **TauxRx** : taux d'octets reçus par seconde par l'interface dans les trois dernières secondes (fréquence réglable dans les préférences). S'affiche en rouge si des erreurs de transmission sont détectées.
- **TauxTx** : taux d'octets envoyés par seconde par l'interface dans les trois dernières secondes (fréquence réglable dans les préférences). S'affiche en rouge si des erreurs de transmission sont détectées.
Si une statistique s'affiche en rouge cela signifie que des erreurs de transfert ont été détectées par la Livebox.
Les statistiques semblent parfois surprenantes, mais il s'agit d'une interprétation sans filtre de ce que renvoie la Livebox (il ne s'agit pas d'un défaut du programme).
**Note** : le trafic TV standard de la box TV UHD n'est pas comptabilisé dans ces statistiques. Par contre celui de services VOD tel que Netflix est bien comptabilisé.
### Boutons
L'onglet `Stats/Infos Livebox` propose les boutons suivants :
- **`Infos Livebox`** : affiche les informations principales concernant la Livebox, telles que les versions de logiciels, l'adresse IP WAN, les services actifs, l'état de la mémoire, etc.
- **`Infos Internet`** : affiche le type d'accès internet, les identifiants de connexion, les adresses IPs v4 & v6, la date et heure de la dernière connexion, la bande passante de la connexion, la MTU, etc
- **`Infos Wifi`** : affiche les informations générales sur la connectivité Wifi, et l'état de chaque accès y compris pour les accès invités. Pour chaque accès on dispose d'informations détaillées telles que le canal, le standard, la bande passante, la qualité, la bande, le nombre d'appareils connectés, etc.
- **`Infos LAN`** : affiche les informations générales sur la connectivité LAN. Il s'agit des informations DHCP de base et pour chaque interface Ethernet on peut identifier si elle est active ou non, la bande passante, etc.
- **`Infos ONT`** : affiche les informations importantes concernant la connexion et le module Fibre (ONT), telles que la bande passante, la qualité du signal, le numéro de série et les versions logicielles, etc. Les champs `Puissance Signal Réception`, `Puissance Signal Transmission`, `Température`, `Voltage` et `BIAS` affichent des valeurs vertes si elles correspondent aux normes de qualité acceptables pour la connexion, en rouge si elles représentent un problème. Attention ce bouton n'est **pas disponible pour les Livebox 4**.
- **`Infos VoIP`** : affiche les informations générales concernant la téléphonie, telles que le protocole, le numéro de téléphone, la version logicielle de l'interface DECT, etc.
- **`Infos IPTV`** : affiche les informations générales relatives aux services de télévision.
- **`Infos USB`** : affiche les informations concernant le ou les ports USBs. Si une clef USB est insérée, ou a été insérée depuis le dernier démarrage de la Livebox, ses informations sont affichées.
- **`Export...`** : permet d'exporter l'ensemble des informations affichées par chacun des boutons dans un fichier texte. Utile pour communiquer ces informations ou faire un suivi pour détecter les changements.
## Graphes - Courbes de trafic par interface et par appareil <a id="graphs"></a>
Affiche les graphiques des données reçues et transmises pour chaque interface / appareil sélectionné à partir de données stockées par la Livebox elle-même. Les volumes sont en méga-octets entre deux échantillons, en principe toutes les 30 secondes (l'échantillonnage et sa fréquence sont contrôlés par la Livebox). Les graphes se mettent à jour automatiquement à la réception de nouveaux échantillons sous forme d'événements.
Il est possible de naviguer et de zoomer dans les graphiques à la souris, puis de revenir à la vue normale en cliquant dans le coin en bas à gauche. Un clic droit sur un graphe permet d'accéder à d'autres fonctionnalités telles que l'exportation en différents formats. Toute la documentation est accessible [ici](https://pyqtgraph.readthedocs.io/en/latest/user_guide/index.html).
### Sélection des interfaces et des appareils
Il faut commencer par sélectionner les interfaces et/ou les appareils dont on veut obtenir les graphiques, pour cela deux boutons sont disponibles :
- **`Ajouter...`** : affiche un dialogue permettant de sélectionner une interface ou un appareil.
Commencer par sélectionner le type, interface ou appareil. Puis l'interface ou l'appareil en question, ainsi que la couleur à utiliser sur le graphique pour cet objet. La sélection n'affiche que des objets pour lesquels des mesures sont potentiellement disponibles. Pour les appareils les noms locaux sont utilisés, et par défaut l'adresse physique (MAC). Le dialogue affiche en informations complémentaires l'identifiant interne à la Livebox de l'objet sélectionné, le nombre d'échantillons stockés dans la Livebox pour cet objet (le nombre maximum est fixé à 8680 par la Livebox) et une estimation de la fenêtre de temps correspondante. Cependant cette fenêtre de temps peut être erronée, car si l'interface ou l'appareil sont déconnectés pendant une période de temps aucun échantillon n'est émis durant cette période. Ce qui veut dire que la période de temps totale entre le plus ancien échantillon et le plus récent peut être bien plus longue que cette estimation.
- **`Supprimer`** : permet de supprimer l'interface ou l'appareil sélectionné.
### Options des graphiques
Des options sont disponibles pour paramétrer les graphiques :
- **`Fenêtre`** : fenêtre de temps en heure de l'affichage des graphiques, à partir du présent. Une valeur à 0 affichera l'ensemble des statistiques disponibles dans la Livebox pour les objets sélectionnés.
- **`Couleur de fond`** : couleur de fond à utiliser pour les graphiques de réception et d'émission. Un clic droit supprime toute couleur, la couleur par défaut sera donc utilisée.
### Génération des graphiques
Le bouton **`Appliquer`** permet de charger toutes les informations relatives aux interfaces et appareils sélectionnés, de dessiner les graphiques correspondants en tenant compte des options ci-dessus, et de sauvegarder la configuration. Celle-ci sera automatiquement rechargée au prochain lancement du programme.
Le bouton **`Export...`** permet d'exporter au format CSV (avec le point-virgule comme séparateur) les dernières données chargées par le bouton `Appliquer` ainsi que celles reçues entre temps via des événements.
## Infos Appareil - Informations détaillées pour chaque appareil connu <a id="deviceinfos"></a>
La liste des appareils connus, sur la gauche, affiche les colonnes suivantes :
- **Nom** : nom local de l'appareil. Ce nom peut être attribué, changé ou supprimé via le bouton `Assigner Nom...`.
- **MAC** : adresse MAC, aussi appelée adresse physique de l'appareil.
Lorsqu'un appareil est sélectionné dans cette liste ses informations détaillées s'affichent dans la liste de droite. Attributs notables :
- **Actif** : indique si l'appareil est actif ou non.
- **Authentifié** : indique si la connexion Wifi de l'appareil a bien été authentifiée.
- **Bloqué** : indique si vous avez bloqué la connexion de l'appareil à la Livebox ou non. Le blocage peut être contrôlé avec les boutons `Bloquer` et `Débloquer`. Il peut être utile de bloquer un appareil inconnu si vous avez des suspicions.
- **Première Connexion** : date et heure de la première connexion. Attention cette valeur peut aussi correspondre à la date/heure d'un précédent redémarrage de la Livebox.
- **Dernière Connexion** : date et heure de la dernière connexion.
- **Dernier Changement** : date et heure du dernier changement détecté pour cet appareil.
- **Nom** : nom connu par la Livebox pour cet appareil, avec la source de ce nom entre parenthèses. Ainsi plusieurs noms peuvent s'afficher pour des sources différentes.
- **Type** : type connu par la Livebox pour cet appareil, avec la source de ce type entre parenthèses. Ainsi plusieurs types peuvent s'afficher pour des sources différentes.
- **Adresse IPvX** : adresse IP (v4 ou v6) de l'appareil. Entre parenthèses s'affiche si l'adresse est celle active ou non, et atteignable sur le réseau (reacheable) ou non (not reacheable). Si l'adresse est réservée pour cet appareil dans la configuration DHCP de la Livebox une mention s'affiche (Reserved).
- **Fabricant** : le fabricant de cet appareil, déduit à partir de son adresse MAC. Le programme utilise l'API du site [macaddress.io](https://macaddress.io/) pour déterminer le fabricant. C'est un service gratuit, mais il faut créer un compte et indiquer l'API Key correspondante dans les préférences pour bénéficier de cette fonctionnalité.
- **Force Signal Wifi** et **Taux Bruit Signal Wifi** : donnent des indications sur la qualité de la connexion pour les appareils Wifi.
### Boutons
L'onglet `Infos Appareil` propose les boutons suivants :
- **`Rafraîchir`** : rafraîchit les informations affichées pour l'appareil sélectionné.
- **`Assigner Nom...`** : permet d'attribuer ou d'effacer le nom local, le nom Livebox et/ou le nom DNS de l'appareil sélectionné.
Décocher la boite pour effacer le nom. Les deux noms peuvent être différents.
- **`Assigner Type...`** : permet d'attribuer ou d'effacer le type de l'appareil sélectionné.
Il est possible de sélectionner un des types standards connus par la Livebox dans le menu, chaque type étant affiché avec son icône Livebox correspondante. Lorsqu'un type standard est sélectionné, son nom connu par la Livebox est automatiquement rempli dans la zone de texte et on peut valider le dialogue. Il reste possible d'assigner manuellement un type non connu par la Livebox en le tapant directement dans la zone de texte. Note : bien que le type "Djingo Speaker" soit référencé comme standard par la Livebox 5, ce type ne semble pas (encore ?) supporté par l'interface graphique de la Livebox.
- **`Oublier...`** : permet de demander à la Livebox d'oublier définitivement cet appareil. Il disparaîtra donc immédiatement de toutes les listes. Attention si l'appareil en question est actif, sa connexion ne sera nullement suspendue, cependant toute son activité restera invisible et ce jusqu'à sa prochaine tentative de connexion.
- **`Bloquer`** : permet de bloquer la connexion de l'appareil sélectionné.
- **`Débloquer`** : permet de débloquer la connexion de l'appareil sélectionné. L'état bloqué ou non s'affiche dans les informations de l'appareil, champs "Bloqué".
## Événements - Liste des événements reçus pour chaque appareil connu <a id="events"></a>
La liste des appareils connus, sur la gauche, affiche les colonnes suivantes :
- **Nom** : nom local de l'appareil. Ce nom peut être attribué, changé ou supprimé via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.
- **MAC** : adresse MAC, aussi appelée adresse physique de l'appareil.
Lorsqu'un appareil est sélectionné dans cette liste tous les événements reçus depuis le lancement du programme pour cet appareil s'affichent dans la liste de droite. La plupart de ces événements ont été interprétés par le programme pour mettre à jour l'interface dynamiquement, et cette liste permet d'avoir un historique. La taille de cet historique par appareil est limitée aux 100 dernières entrées (cette limite peut être ajustée facilement en modifiant la variable `MAX_EVENT_BUFFER_PER_DEVICE` du module `LmEventsTab.py`).
La liste des événements est composée des colonnes :
- **Heure** : heure de réception de l'événement.
- **Raison** : le type d'événement généré par la Livebox.
- **Attributs** : aperçu des données brutes de l'événement lui-même, au format JSON.
Un double clic sur un événement ou un clic sur le bouton **`Afficher Événement`** permet d'afficher un dialogue contenant les informations complètes :
- **Raised** : date et heure précise de réception de l'événement.
- **Handler** : gestionnaire de l'événement, contenant la plupart du temps la clef de l'appareil qui n'est autre que son adresse MAC.
- **Reason** : le type d'événement.
- **Attributes** : données brutes complètes de l'événement lui-même, au format JSON tel que généré par la Livebox.
### Notifications automatiques
- Le bouton **`Notifications...`** permet d'accéder à configuration des notifications automatiques à générer (par exemple par email) à la détection de certains événements.
Vous pouvez créer autant de règles que nécessaire. Ce n'est pas grave si plusieurs règles concernent le ou les mêmes appareils, le programme ne détecte pas non plus les règles dupliquées. Il suffit qu'au moins une règle soit trouvée qui concerne une notification pour un appareil pour que cette notification soit effectuée.
La liste affiche la liste des règles configurées, avec le ou les appareils concernés, les pastilles bleues indiquent les événements sélectionnés pour la notification, les pastilles vertes le ou les types de notifications sélectionnés (email et/ou fichiers CSV journaliers). Les boutons **`Ajouter`** et **`Supprimer`** permettent de créer une règle ou de supprimer la règle sélectionnée.
Paramètres d'une règle :
- **`Appareil`** : permet de sélectionner le ou les appareils pour lesquels recevoir une notification. `Tout appareil` appliquera la règle pour l'ensemble des appareils. `Tout appareil inconnu` appliquera la règle à n'importe quel appareil inconnu.
- **`Adresse MAC`** : adresse physique de l'appareil sélectionné.
- **`Événements`** : sélection des événements pour lesquels recevoir une notification. Ajout ou suppression d'appareils, connexion, déconnexion, ou changement de points d'accès (utile si vous disposez d'un ou plusieurs répéteurs Wifi Orange).
- **`Actions`** : sélection des actions à réaliser pour notifier. Il est possible de reporter les événements dans un fichier CSV journalier, ou d'envoyer les informations de chaque événement par email instantané.
Préférences des notifications:
- **`Fréquences Résolution des Événements`** : les événements sont détectés instantanément, cependant certains événements peuvent s'annuler lorsque générés dans une courte fenêtre de temps, tels que la déconnexion suivie d'une reconnexion dans les 15 secondes d'un appareil donné (arrive fréquemment). Pour éviter des notifications intempestives un temps d'attente de 30 secondes est fortement recommandé pour laisser le programme identifier ces situations. Un temps inférieur à 5 secondes est fortement déconseillé pour éviter que le programme ne consomme trop de ressources.
- **`Répertoire des fichiers CSV`** : répertoire dans lequel générer les fichiers CSV journaliers. Cocher l'option `Défaut` pour générer les fichiers dans le [le répertoire de configuration du programme](#configuration). Sinon cliquer sur le bouton `Sélectionner` pour choisir un répertoire spécifique.
## DHCP - Contrôle fin du serveur DHCP <a id="dhcp"></a>
### Baux statiques
La liste des baux statiques configurés est affichée sur la gauche. Les deux domaines de réseau sont gérés :
- `Home` : votre réseau privé, dont vous pouvez configurer sa plage d'IPs.
- `Guest` : le réseau Wifi invité, qui a sa propre plage d'IPs (non-modifiable).
La liste affiche les colonnes suivantes :
- **Nom** : nom local de l'appareil. Ce nom peut être attribué, changé ou supprimé via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.
- **Domaine** : domaine d'assignation, `Home` ou `Guest`.
- **MAC** : adresse MAC, aussi appelée adresse physique de l'appareil.
- **IP** : adresse IP assignée statiquement à l'appareil.
### Boutons
Les boutons suivants sont proposés pour gérer la liste des baux :
- **`Rafraîchir`** : rafraîchit la liste des baux statiques.
- **`Ajouter...`** : permet d'ajouter un bail.
La liste des appareils proposés est triée et est composée d'un mélange des appareils connectés et ceux référencés dans le fichier local des adresses MAC. L'adresse MAC est directement déduite de l'appareil sélectionné mais on peut en taper une totalement à la main. Choisir le domaine réseau entre `Home` ou `Guest`, et une adresse IP libre sera automatiquement proposée mais celle ci reste bien sûr configurable. Attention un même appareil ne peut être configuré que sur un seul domaine, et s'il se connecte sur un domaine alors qu'un bail statique est configuré sur l'autre ce bail sera automatiquement supprimé.
- **`Supprimer`** : supprime le bail sélectionné.
### Informations DHCP détaillées
La liste sur la droite affiche de nombreux détails sur le serveur DHCP:
- La configuration détaillée des deux domaines `Home` et `Guest`.
- Des détails sur le DHCPv4 ainsi que toutes les options DHCP envoyées et reçues.
- Des détails sur le DHCPv6 ainsi que toutes les options DHCP envoyées et reçues.
### Boutons
Les boutons suivants sont proposés pour gérer la liste des baux :
- **`Rafraîchir`** : rafraîchit la liste des informations DHCP.
- **`Réglages DHCP...`** : permet de configurer le serveur DHCP.
Permet d'activer ou de désactiver le serveur, de changer l'adresse IP de la Livebox, de changer le masque de sous-réseau du serveur DHCP ainsi que la plage d'adresse IP pour le domaine `Home`.
## NAT/PAT - Règles de redirection de port et de protocole <a id="natpat"></a>
Cet onglet permet de gérer de façon fine les règles de redirection de port et de protocole IPv4, IPv6 et UPnP de la Livebox. De par cette gestion fine il peut arriver que certaines règles, bien que correctement stockées et interprétées par la Livebox, ne s'affichent pas dans l'interface Web de la Livebox. Ceci est normal et ne représente pas vraiment de problème.
### Redirections de port
La liste des règles de redirection de port, en haut, affiche les colonnes suivantes :
- **A** : icône indiquant si la règle est active ou non.
- **Type** : type de la règle, entre IPv4, IPv6 et UPnP. Les règles UPnP sont gérées automatiquement par la Livebox et vous ne devriez normalement pas avoir à les modifier.
- **Nom** : nom de la règle.
- **Description** : description de la règle.
- **Protocoles** : liste des protocoles concernés par la règle.
- **Port Interne** : port ou plage de ports interne sur lequel le trafic est redirigé.
- **Port Externe** : port ou plage de ports externe à rediriger.
- **Appareil** : appareil (ou son adresse IP) sur lequel le trafic est redirigé.
- **IP Externes** : liste des adresses IPs externes concernées par la règle.
Un **double clic** sur une règle permet de facilement l'éditer.
### Boutons
Les boutons suivants sont proposés pour gérer la liste des règles :
- **`Rafraîchir`** : rafraîchit la liste des règles de redirection de port.
- **`Activer/Désactiver`** : active/désactive la règle sélectionnée.
- **`Ajouter...`** : permet d'ajouter une règle de redirection de port.
- **`Modifier...`** : permet de modifier la règle de redirection de port sélectionnée.
- **`Supprimer`** : supprime la règle de redirection de port sélectionnée.
- **`Tout Supprimer...`** : permet de supprimer toutes les règles de redirection de port. Il est possible de supprimer uniquement une sélection de types de règle. Si une ou plusieurs règles posent problème à la Livebox (par exemple lorsque leur nom contient des caractères spéciaux) ce bouton peut permettre de revenir à une situation saine.
- **`Export...`** : permet d'exporter dans un fichier les règles de redirection de port d'un ou plusieurs types choisis.
- **`Import...`** : permet de réimporter des règles de redirection de port précédemment exportées dans un fichier. Si des règles de même nom existent déjà elles seront écrasées par celles importées.
### Redirections de protocole
La liste des règles de redirection de protocole, en bas, affiche les colonnes suivantes :
- **A** : icône indiquant si la règle est active ou non.
- **Type** : type de la règle, entre IPv4 et IPv6.
- **Nom** : nom de la règle.
- **Description** : description de la règle.
- **Protocoles** : liste des protocoles concernés par la règle.
- **Appareil** : appareil (ou son adresse IP) sur lequel le trafic est redirigé.
- **IP Externes** : liste des adresses IPs externes concernées par la règle.
Un **double clic** sur une règle permet de facilement l'éditer.
### Boutons
Les boutons suivants sont proposés pour gérer la liste des règles :
- **`Rafraîchir`** : rafraîchit la liste des règles de redirection de protocole.
- **`Activer/Désactiver`** : active/désactive la règle sélectionnée.
- **`Ajouter...`** : permet d'ajouter une règle de redirection de protocole.
- **`Modifier...`** : permet de modifier la règle de redirection de protocole sélectionnée.
- **`Supprimer`** : supprime la règle de redirection de protocole sélectionnée.
- **`Tout Supprimer...`** : permet de supprimer toutes les règles de redirection de protocole. Il est possible de supprimer uniquement une sélection de types de règle. Si une ou plusieurs règles posent problème à la Livebox (par exemple lorsque leur nom contient des caractères spéciaux) ce bouton peut permettre de revenir à une situation saine.
- **`Export...`** : permet d'exporter dans un fichier les règles de redirection de protocole d'un ou plusieurs types choisis.
- **`Import...`** : permet de réimporter des règles de redirection de protocole précédemment exportées dans un fichier. Si des règles de même nom existent déjà elles seront écrasées par celles importées.
## Téléphone - Liste des appels téléphoniques / liste des contacts <a id="phone"></a>
### Appels téléphoniques
La liste des appels téléphoniques, sur la gauche, affiche les colonnes suivantes :
- **T** : icône correspondant au type de l'appel.
-  : appel reçu.
-  : appel manqué. Dans ce cas toute la ligne est indiquée en couleur rouge.
-  : appel émis.
-  : appel émis mais non abouti.
- **Heure** : date et heure de l'appel.
- **Numéro** : numéro de téléphone concerné.
- **Contact** : le nom du contact déterminé par la Livebox en fonction de la liste des contacts au moment de l'appel. Si la Livebox n'a mémorisé aucun nom, alors le programme essai d'en trouver un dynamiquement à partir de la liste des contacts enregistrés par correspondance avec le numéro de téléphone.
- **Durée** : durée de l'appel.
Un **double clic** sur un appel permet de facilement créer ou éditer le contact correspondant.
### Boutons
Les boutons suivants sont proposés pour gérer la liste des appels :
- **`Rafraîchir`** : rafraîchit la liste des appels.
- **`Supprimer`** : supprime l'appel sélectionné.
- **`Tout Supprimer...`** : supprime tous les appels.
### Contacts
La liste des contacts, sur la droite, affiche les colonnes suivantes :
- **Nom** : nom du contact, au format nom + prénom.
- **Portable** : numéro de téléphone portable.
- **Domicile** : numéro de téléphone fixe.
- **Travail** : numéro de téléphone professionnel.
- **Sonnerie** : type de sonnerie sélectionné parmi les 7 supportés par la Livebox.
Un **double clic** sur un contact permet de facilement l'éditer.
**Attention** : la Livebox supporte un maximum de 255 contacts.
### Boutons
Les boutons suivants sont proposés pour gérer la liste des contacts :
- **`Rafraîchir`** : rafraîchit la liste des contacts.
- **`Ajouter...`** : permet de rajouter un contact. Attention aucun test de doublon n'est effectué.
- **`Modifier...`** : pour éditer le contact sélectionné.
- **`Supprimer`** : supprime le contact sélectionné.
- **`Tout Supprimer...`** : supprime tous les contacts.
- **`Sonnerie`** : permet de tester le téléphone. Sur la gauche du bouton on peut sélectionner un des 7 types de sonnerie proposés par la Livebox, sinon le type par défaut est utilisé.
- **`Export...`** : permet d'exporter l'ensemble des contacts dans un fichier au [format VCF](https://en.wikipedia.org/wiki/VCard). Très utile pour les sauvegarder.
- **`Import...`** : permet d'importer un ou plusieurs fichiers au [format VCF](https://en.wikipedia.org/wiki/VCard). Attention aucun test de doublon n'est effectué. Si la limite du nombre de contacts maximum supporté (255) est atteint l'import est interrompu.
## Actions - Boutons d'actions et de contrôle <a id="actions"></a>
Cet onglet permet une liste d'actions par catégorie.
Les actions concernant le **Wifi** :
- **`Wifi ON`** : permet d'activer l'interface Wifi de la Livebox.
- **`Wifi OFF`** : permet de désactiver l'interface Wifi de la Livebox.
- **`Wifi Invité ON`** : permet d'activer l'interface Wifi invité de la Livebox.
- **`Wifi Invité OFF`** : permet de désactiver l'interface Wifi invité de la Livebox.
- **`Planificateur Wifi ON`** : permet d'activer le planificateur Wifi de la Livebox. Ce planificateur doit être configuré depuis l'interface Web de la Livebox.
- **`Planificateur Wifi OFF`** : permet de désactiver le planificateur Wifi de la Livebox.
- **`État Global Wifi...`** : permet d'afficher l'état global du Wifi, en incluant l'état Wifi de tous les répéteurs Wifi Orange potentiellement connectés.
Les actions concernant les **Redémarrages** :
- **`Redémarrer la Livebox...`** : permet de forcer un redémarrage de la Livebox.
- **`Historique Redémarrages...`** : permet d'afficher l'historique des derniers redémarrages.
Cet historique est particulièrement utile pour détecter les redémarrages forcés par Orange pour mettre à jour le logiciel de la Livebox.
La liste affiche les colonnes suivantes :
- **Date Redémarrage** : date et heure du démarrage.
- **Raison Redémarrage** : la raison de ce démarrage. Typiquement "NMC" indique un démarrage forcé par logiciel et "Unsupported chipset" un redémarrage causé par une coupure de courant ou l'interrupteur de la Livebox.
- **Date Arrêt** : la date et heure de l'arrêt.
- **Raison Arrêt** : la raison de cet arrêt. Typiquement vide pour une coupure de courant, "Upgrade" pour une mise à jour logiciel et "GUI_Reboot" pour un redémarrage demandé depuis l'interface Web ou LiveboxMonitor.
Les actions concernant le **Pare-feu** :
- **`Niveaux de pare-feu...`** : permet de régler les niveaux des pare-feux IPv4 et IPv6.
- **`Réponses aux pings...`** : permet de régler les réponses aux requêtes de ping IPv4 et IPv6.
Les actions concernant les **Réglages** :
- **`Préférences...`** : permet d'afficher l'écran des préférences du programme.
Voir la section **Profils*** ci-dessus pour plus de détail sur leur fonctionnement.
Pour chaque **profil** il est possible de configurer :
- `Nom` : nom du profil.
- `URL Livebox` : adresse de la Livebox. La valeur par défaut est `http://livebox.home/`.
- `Utilisateur` : login pour l'ouverture de session. Par défaut `admin`. Le mot de passe est demandé automatiquement lors de l'utilisation du profil s'il n'est pas renseigné ou s'il est erroné.
- `Filtrage Appareils` : active le filtrage des appareils afin de ne pas montrer certains appareils "fantômes" détectés par la Livebox. Quand ce paramètre est activé le programme affiche les mêmes appareils que l'interface Web de la Livebox. Ce paramètre est activé par défaut.
- `Fichier Table MacAddr` : nom du fichier de stockage des noms d'appareils. Par défaut `MacAddrTable.txt`. Voire `Le fichier MacAddrTable.txt` de la section `Configuration` pour plus d'explications.
- `Défaut` : indique qu'il s'agit du profil par défaut à utiliser au lancement du programme. Il ne peut y avoir qu'un seul profil par défaut.
Les **préférences** générales permettent de régler :
- `Langage` : langue utilisée par l'application, à choisir entre Français (défaut) et Anglais.
- `Tooltips` : active ou non les tooltips.
- `Fréquence Stats` : Fréquence de rafraîchissement, en secondes, de toutes les statistiques. Par défaut 3 secondes.
- `API Key macaddress.io` : le programme utilise l'API du site [macaddress.io](https://macaddress.io/) pour déterminer le fabricant d'un appareil à partir de son adresse MAC (champ **Fabricant** dans les informations détaillées par appareil). C'est un service gratuit, mais il faut créer un compte et indiquer ici l'API Key correspondante pour bénéficier de cette fonctionnalité.
- `Indicatif Téléphonique` : indicatif téléphonique local, utile pour faire correspondre les appels téléphoniques avec les numéros de contacts. Par défaut le code de la France est utilisé, c'est-à-dire 33.
- `Hauteur Entêtes` : hauteur en pixels des entêtes de liste, par défaut 25.
- `Taille Police Entêtes` : taille de la police de caractères des entêtes de liste. Une valeur à zéro signifie d'utiliser la taille système. Par défaut ce paramètre est à zéro.
- `Hauteur Lignes` : hauteur en pixels des lignes de liste, par défaut 30.
- `Taille Police Lignes` : taille de la police de caractères des lignes de liste. Une valeur à zéro signifie d'utiliser la taille système. Par défaut ce paramètre est à zéro.
- `Statistiques temps réel des appareils wifi` : active ou non les statistiques en temps réel pour les appareils wifi. Celles ci s'affichent en bleu dans l'onglet `Appareils` et viennent recouvrir les statistiques standards qui s'affichent en noir toutes les 30 secondes.
- `Utiliser le style d'interface graphique natif` : par défaut le style "Fusion" est utilisé sur toutes les plateformes. Cette option permet sur les plateformes Windows et MacOS d'utiliser un style graphique plus natif. Cette option n'a aucun effet sur les plateformes Linux.
- **`Changer de profil...`** : affiche un dialogue permettant de changer le profil en cours et de relancer le programme.
- **`Réglages Email...`** : permet de configurer l'envoi d'emails automatique, par exemple pour les notifications.
Il est possible de configurer :
- `Adresse Origine` : adresse email d'origine des messages.
- `Adresse Destination` : adresse email de destination des messages.
- `Préfixe Sujet` : préfixe rajouté aux sujets des messages envoyés.
- `Serveur SMTP` : serveur SMTP de votre fournisseur de messagerie.
- `Port` : port SMTP à utiliser. 465 est recommandé pour SSL, 587 pour tout autre protocole.
- `Utiliser TLS` : utilisation du protocole d'encryption TLS (recommandé).
- `Utiliser SSL` : utilisation du protocole d'encryption SSL.
- `Authentification` : à sélectionner si le serveur nécessite de s'authentifier.
- `Utilisateur` : votre nom d'utilisateur pour s'authentifier.
- `Mot de passe` : votre mot de passe pour s'authentifier.
Le bouton `Test Envoi` permet d'envoyer un message de test avec les réglages courants sans les sauvegarder.
La configuration pour le serveur d'Orange est très simple :
- Adresse origine / utilisateur -> mettre votre adresse@orange.fr
- Adresse destination -> la destination souhaitée
- Serveur SMTP -> smtp.orange.fr
- Port -> 587
- Cocher "Utiliser TLS" et "Authentification".
- Mot de passe -> votre mot de passe Orange.
Pour gmail c'est un peu plus compliqué :
- Il faut d'abord régler son compte gmail pour créer un mot de passe dédié pour le programme.
- Aller sur son compte, onglet "Sécurité" -> [ici](https://myaccount.google.com/security)
- Vérifier que la "validation en deux étapes" est activée, si ce n'est pas le cas, il faut le faire.
- Cliquer "Validation en deux étapes" et aller sur "Mots de passe d'application" en bas.
- Créer un nouveau mot de passe pour l'application 'LiveboxMonitor' et notez le mot de passe (sans les espaces).
- Retourner dans LiveboxMonitor, réglage email.
- Dans les champs Adresse origine / utilisateur -> mettre votre adresse@gmail.com
- Adresse destination -> la destination souhaitée
- Serveur SMTP -> smtp.gmail.com
- Port -> 587
- Cocher "Utiliser TLS" et "Authentification"
- Mot de passe -> le mot de passe créé ci dessus.
Les actions techniques de **Débogage** :
- **`JSON Liste Appareils...`** : permet d'afficher la réponse brute JSON de la Livebox concernant la liste des appareils connus. Utile pour avoir plus d'informations ou pour le débogage.
- **`JSON Topologie...`** : permet d'afficher la réponse brute JSON de la Livebox concernant la topologie de connexion des appareils connus. Utile pour avoir plus d'informations ou pour le débogage.
- **`Niveau de log...`** : permet de changer le niveau de logs dans la console. Ce niveau est stocké dans la configuration du programme et sera donc conservé au prochain lancement du programme.
- **`Générer documentation APIs...`** : permet de générer dans des fichiers texte l'ensemble de la documentation accessible sur les APIs de la Livebox, par module. Le programme génère un fichier par module connu, un fichier "_ALL_MODULES_" contenant l'ensemble des modules en un seul fichier, et un fichier "_PROCESSES_" qui permet d'avoir la liste des tâches tournant sur la Livebox. Certains fichiers ne contiennent qu'une erreur "Permission denied" : c'est normal, ces modules sont protégés et donc non accessibles (mais qui sait dans une prochaine version du firmeware ?). Les paramètres de fonction indiqués entre parenthèses sont optionnels. Par défaut le programme génère l'ensemble des instances trouvées par type de ressources (ou "object") ainsi que toutes les valeurs trouvées par paramètres, mais ces valeurs sont filtrées si on maintient la touche `Ctrl` en cliquant sur le bouton. Cela permet de partager librement ces fichiers sans divulguer d'informations spécifiques à sa configuration, cependant avoir la liste des instances reste crucial pour une documentation vraiment complète.
Autres actions :
- **Quitter l'application** : pour quitter l'application. Strictement équivalent à fermer la fenêtre de l'application.
- Un clic sur le lien GitHub de l'application ouvrira la page correspondante sur votre navigateur.
## Onglets répéteurs Wifi <a id="repeaters"></a>
Le programme créé dynamiquement un onglet par répéteur connecté. Si le répéteur a un nom local, celui-ci est utilisé dans l'onglet, sinon le nom par défaut est de type "RW #" suivit du numéro de répéteur dans l'ordre de détection.
Les répéteurs font aussi parti des appareils connus, ils sont donc visibles dans l'onglet `Appareils` et leur nom peut être changé via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.
Une icône dans le nom de l'onglet permet de connaître l'état de la connexion avec le répéteur :
-  : le répéteur est inactif ou n'a pas d'adresse IP attribuée.
-  : le répéteur est actif mais aucune session n'est ouverte. Si cet état subsiste vous pouvez essayer de forcer la création d'une session en cliquant sur le bouton `Réauthentifier...`.
-  : le répéteur est actif et une session a été créée pour communiquer avec lui.
Les statistiques de trafic par interface sont affichées sous forme de liste en haut à gauche.
Et toutes les informations détaillées sont accessibles via la barre de boutons en bas, chaque bouton remplissant la liste d'attributs sur la droite. Il est aussi possible d'exporter l'ensemble des informations dans un fichier. Enfin, une série d'actions est possible via les boutons sur la gauche.
### Statistiques
Liste permettant de surveiller l'état du trafic géré par le répéteur :
- **Nom** : nom de l'interface réseau. `LAN` concerne tout le trafic entre le répéteur et la Livebox. Ensuite on dispose des statistiques par interface précise (les deux prises Ethernet ainsi que les deux bandes Wifi).
- **Rx** : nombre d'octets reçus par l'interface. La fenêtre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont détectées. Attention ce compteur est circulaire et ne dépasse pas les 4 Go.
- **Tx** : nombre d'octets envoyés par l'interface. La fenêtre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont détectées. Attention ce compteur est circulaire et ne dépasse pas les 4 Go.
- **TauxRx** : taux d'octets reçus par seconde par l'interface dans les trois dernières secondes (fréquence réglable dans les préférences).
- **TauxTx** : taux d'octets envoyés par seconde par l'interface dans les trois dernières secondes (fréquence réglable dans les préférences).
Si une statistique s'affiche en rouge cela signifie que des erreurs de transfert ont été détectées par le répéteur.
Les statistiques semblent parfois surprenantes, mais il s'agit d'une interprétation sans filtre de ce que renvoie le répéteur (il ne s'agit pas d'un défaut du programme).
### Actions - Boutons d'actions et de contrôle
Les actions concernant le **Wifi** :
- **`Wifi ON`** : permet d'activer l'interface Wifi du répéteur.
- **`Wifi OFF`** : permet de désactiver l'interface Wifi du répéteur.
- **`Planificateur Wifi ON`** : permet d'activer le planificateur Wifi du répéteur. Ce planificateur doit être configuré depuis l'interface Web du répéteur.
- **`Planificateur Wifi OFF`** : permet de désactiver le planificateur Wifi du répéteur.
L'état global du Wifi peut être consulté via le bouton `État Global Wifi...` de l'onglet `Actions`.
Les actions concernant les **Redémarrages** :
- **`Redémarrer le Répéteur...`** : permet de forcer un redémarrage du répéteur.
- **`Historique Redémarrages...`** : permet d'afficher l'historique des derniers redémarrages.
Cet historique est particulièrement utile pour détecter les redémarrages forcés par Orange pour mettre à jour le logiciel du répéteur.
La liste affiche les colonnes suivantes :
- **Date Redémarrage** : date et heure du démarrage.
- **Raison Redémarrage** : la raison de ce démarrage. Typiquement "NMC" ou "POR" indique un démarrage forcé par logiciel et "Unsupported chipset" un redémarrage causé par une coupure de courant ou l'interrupteur du répéteur.
- **Date Arrêt** : la date et heure de l'extinction.
- **Raison Arrêt** : la raison de cette extinction. Typiquement vide pour une coupure de courant, "Upgrade" pour une mise à jour logiciel et "WebUI reboot" pour un redémarrage demandé depuis l'interface Web ou LiveboxMonitor.
Les actions diverses :
- **Réauthentifier...** : pour forcer la création d'une nouvelle session avec le répéteur. Si vous laissez trop longtemps le programme tourner sans visualiser les statistiques du répéteur ni effectuer la moindre action, la session sera automatiquement libérée par le répéteur. Dans ce cas des erreurs vont se produire en effectuant des actions : ce bouton permettra de recréer la session, permettant de reprendre les actions sans erreur.
### Boutons
Les onglets de répéteur Wifi proposent les boutons suivants :
- **`Informations Répéteur`** : affiche les informations principales concernant le répéteur, telles que les versions de logiciels, le nom du modèle, l'heure de l'horloge interne, etc.
- **`Informations Wifi`** : affiche les informations générales sur la connectivité Wifi, et l'état de chaque accès. Pour chaque accès on dispose d'informations détaillées telles que le canal, le standard, la bande passante, la qualité, la bande, le nombre d'appareils connectés, etc.
- **`Informations LAN`** : affiche les informations générales sur la connectivité LAN. Pour chaque interface Ethernet on peut identifier si elle est active ou non, la bande passante, etc.
- **`Export...`** : permet d'exporter l'ensemble des informations affichées par chacun des boutons dans un fichier texte. Utile pour communiquer ces informations ou faire un suivi pour détecter les changements.
## Gestion et personnalisation des icônes d'appareil <a id="icons"></a>
Toutes les icônes d'appareil sont initialement stockées par la Livebox et le programme va les chercher une à une, ce qui peut provoquer une certaine latence (par exemple lorsque l'on clique une première fois sur le bouton `Assigner Type...` pour changer le type d'un appareil).
Pour éviter cette latence, le programme stocke dans un cache local toutes les icônes téléchargées de la Livebox pour pouvoir les retrouver plus rapidement au prochain lancement. Ce cache est contenu dans un répertoire appelé `lbcache_` suivie de la version du firmware de la Livebox (ce qui fait que plusieurs caches peuvent être maintenu si vous accédez à plusieurs Livebox de versions différentes).
Ce répertoire est créé automatiquement dans [le répertoire de configuration du programme](#configuration).
Il est aussi possible de modifier ces icônes, et aussi de créer de nouveaux types d'appareils avec leur propre icône.
Une page d'explication dédiée à ces possibilités est disponible [ici](https://github.com/p-dor/LiveboxMonitor/blob/main/docs/CustomIcons.md).
Raw data
{
"_id": null,
"home_page": null,
"name": "LiveboxMonitor",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "livebox, sysbus, ui, monitoring, traffic",
"author": null,
"author_email": "Pierre Dor <dorpierre@orange.fr>",
"download_url": "https://files.pythonhosted.org/packages/bf/c9/d325558c87e80ea26e046e9fd2e331e028ff0a51c51ec9f4359dae9c284f/liveboxmonitor-1.4.8.tar.gz",
"platform": null,
"description": "#  LiveboxMonitor\r\n\r\nL'application [LiveboxMonitor](https://github.com/p-dor/LiveboxMonitor) est une interface graphique dynamique pour :\r\n- Contr\u00f4ler les appareils qui se connectent \u00e0 la Livebox et d\u00e9tecter rapidement les intrusions,\r\n- Enregistrer le journal d'activit\u00e9s et recevoir des notifications par email aux connexions ou d\u00e9connexions,\r\n- Obtenir des statistiques d\u00e9taill\u00e9es de trafic, par appareil, global,\r\n- Visualiser graphiquement les statistiques de trafic sur plusieurs jours, par appareil ou par interface,\r\n- Obtenir beaucoup de d\u00e9tails sur la Livebox elle-m\u00eame et contr\u00f4ler la qualit\u00e9 de sa ligne fibre,\r\n- Avoir beaucoup de d\u00e9tails sur les appareils qui se connectent (actifs ou non),\r\n- Lire le journal des \u00e9v\u00e9nements d'un appareil donn\u00e9,\r\n- Contr\u00f4ler de mani\u00e8re fine les r\u00e9glages du serveur DHCP et des r\u00e8gles NAT/PAT,\r\n- Contr\u00f4ler l'\u00e9tat du Wifi,\r\n- Contr\u00f4ler les appels t\u00e9l\u00e9phoniques ainsi que la liste des contacts,\r\n- Contr\u00f4ler un ou plusieurs r\u00e9p\u00e9teurs Wifi Orange connect\u00e9s.\r\n\r\n**AVERTISSEMENT** : le programme a \u00e9t\u00e9 **con\u00e7u pour contr\u00f4ler une Livebox 5 et a \u00e9t\u00e9 adapt\u00e9 avec quelques tests pour les Livebox 4, 6 et 7**, des tests suppl\u00e9mentaires avec une Livebox 4, 6 ou 7 seraient bienvenus. Les architectures \u00e9tant totalement diff\u00e9rentes, **le logiciel n'est pas compatible avec la \"Livebox Pro 4\"**.\r\n\r\nL'application est dynamique car elle r\u00e9agit aux \u00e9v\u00e9nements envoy\u00e9s par la Livebox et les interpr\u00e8te.\r\n\r\n\r\n\r\n\r\n## Sections de cette documentation\r\n1. [Installation](#install)\r\n2. [Configuration minimale](#minimalconfig)\r\n3. [\u00c0 propos de l'auteur](#author)\r\n4. [Discussion](#discussion)\r\n5. [Prise en main](#handling)\r\n6. [Profils](#profiles)\r\n7. [Options de ligne de commande](#commandline)\r\n8. [Acc\u00e8s \u00e0 distance](#remoteaccess)\r\n9. [Configuration](#configuration)\r\n10. [Linux](#linux)\r\n11. [Appareils - Liste des appareils connect\u00e9s](#devicelist)\r\n12. [Stats/Infos Livebox - Statistiques de trafic et infos avanc\u00e9es de la Livebox](#infos)\r\n13. [Graphes - Courbes de trafic par interface et par appareil](#graphs)\r\n14. [Infos Appareil - Informations d\u00e9taill\u00e9es pour chaque appareil connu](#deviceinfos)\r\n15. [\u00c9v\u00e9nements - Liste des \u00e9v\u00e9nements re\u00e7us pour chaque appareil connu](#events)\r\n16. [DHCP - Contr\u00f4le fin du serveur DHCP](#dhcp)\r\n17. [NAT/PAT - R\u00e8gles de redirection de port et de protocole](#natpat)\r\n18. [T\u00e9l\u00e9phone - Liste des appels t\u00e9l\u00e9phoniques / liste des contacts](#phone)\r\n19. [Actions - Boutons d'actions et de contr\u00f4le](#actions)\r\n20. [Onglets r\u00e9p\u00e9teurs Wifi](#repeaters)\r\n21. [Gestion et personnalisation des ic\u00f4nes d'appareil](#icons)\r\n\r\n\r\n## Installation <a id=\"install\"></a>\r\n\r\nL'application est \u00e9crite en [Python 3.9](https://www.python.org/downloads/) et est bas\u00e9e sur [PyQT 6](https://pypi.org/project/PyQt6/) pour l'interface graphique et sur [PyQtGraph](https://www.pyqtgraph.org/) pour les graphes statistiques.\r\n\r\nLes autres d\u00e9pendances sont `requests`, `cryptography` et `python-dateutil`.\r\n\r\n**Note** : Le module `LmSession` est une adaptation du package [sysbus](https://github.com/rene-d/sysbus) pour les Livebox 5,6 & 7. Le support des \u00e9v\u00e9nements a aussi \u00e9t\u00e9 rajout\u00e9.\r\n\r\n### T\u00e9l\u00e9chargement - version 1.4 (24/04/2023)\r\n\r\nDes programmes autonomes construits avec [PyInstaller](https://pyinstaller.org) sont disponibles pour les plateformes Windows & MacOS :\r\n- Windows : [T\u00e9l\u00e9charger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor.exe)\r\n- Windows avec console : [T\u00e9l\u00e9charger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Console.exe)\r\n- MacOS (Intel) : [T\u00e9l\u00e9charger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor.dmg)\r\n- MacOS (Intel) avec console : [T\u00e9l\u00e9charger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Console.dmg)\r\n- MacOS (Silicon) : [T\u00e9l\u00e9charger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Silicon.dmg)\r\n- MacOS (Silicon) avec console : [T\u00e9l\u00e9charger](https://github.com/p-dor/LiveboxMonitor/releases/download/1.4/LiveboxMonitor_Silicon_Console.dmg)\r\n\r\nNouveaut\u00e9s de la version 1.4 et historique des versions : [ici](https://github.com/p-dor/LiveboxMonitor/blob/main/docs/ReleaseHistory.md) ou [ici](https://github.com/p-dor/LiveboxMonitor/releases).\r\n\r\n\r\n### PyPI\r\n\r\nInstallation : \r\n```\r\n pip install LiveboxMonitor\r\n```\r\n\r\nMise \u00e0 jour : \r\n```\r\n pip install --upgrade LiveboxMonitor\r\n```\r\n\r\nLancement : \r\n```\r\n LiveboxMonitor\r\n```\r\n\r\n\r\n### Utilisation directe via les sources\r\n\r\nInstallation : \r\n```\r\n git clone https://github.com/p-dor/LiveboxMonitor.git \r\n cd LiveboxMonitor \r\n pip install -r requirements.txt\r\n```\r\n\r\nLancement : \r\n``` \r\n cd src\\LiveboxMonitor\r\n python3 lbm.py\r\n```\r\n\r\nOu via un virtualenv.\r\n\r\nInstallation : \r\n```\r\n git clone https://github.com/p-dor/LiveboxMonitor.git\r\n cd LiveboxMonitor\r\n virtualenv -p python3 .venv\r\n source .venv/bin/activate\r\n pip install -r requirements.txt\r\n``` \r\n\r\nLancement : \r\n``` \r\n cd src\\LiveboxMonitor\r\n source .venv/bin/activate\r\n python3 lbm.py\r\n```\r\n\r\n\r\n## Configuration minimale <a id=\"minimalconfig\"></a>\r\n\r\n\u00c9tant donn\u00e9 les d\u00e9pendances document\u00e9es de [Python 3.9](https://www.python.org/downloads/release/python-390/), [PyInstaller](https://pyinstaller.org/en/stable/requirements.html) et de [PyQt6](https://www.qt.io/product/qt6/technical-specifications) la configuration minimale requise pour faire tourner cette application est :\r\n- Windows : **Windows 10** ou plus r\u00e9cent.\r\n- MacOS : **10.15 (Catalina)** ou plus r\u00e9cent.\r\n\r\n\r\n## \u00c0 propos de l'auteur <a id=\"author\"></a>\r\n\r\nL'auteur de ce logiciel est un professionnel de l'informatique n'ayant aucun lien avec Orange. Ce logiciel n'est donc en rien un produit d'Orange. \r\nAucune documentation officielle des APIs de la Livebox n'\u00e9tant disponible, l'\u00e9laboration a \u00e9t\u00e9 effectu\u00e9e \u00e0 partir de techniques classiques de r\u00e9tro-ing\u00e9nierie (reverse engineering), et l'ensemble du projet sur le temps libre de l'auteur.\r\n\r\n\r\n## Discussion <a id=\"discussion\"></a>\r\n\r\nUn [fil de discussion](https://lafibre.info/orange-les-news/controler-son-reseau-livebox-5-ou-6/) est actif sur le forum [lafibre.info](https://lafibre.info). Il est possible d'y poster vos commentaires, r\u00e9sultats de tests ou de faire des demandes de fonctionnalit\u00e9s.\r\n\r\n\r\n## Prise en main <a id=\"handling\"></a>\r\n\r\nL'interface se veut intuitive mais il vaut mieux se reporter \u00e0 la documentation pour comprendre certains comportements ou repr\u00e9sentations.\r\nLes points importants \u00e0 comprendre avant de commencer :\r\n- La connexion s'\u00e9tablit avec exactement les m\u00eames informations que pour acc\u00e9der \u00e0 l'interface Web de configuration de la Livebox. Pour l'URL il faut essayer http://livebox.home/, http://livebox/ ou http://192.168.1.1/. Pour l'utilisateur il faut laisser \u00e0 la valeur par d\u00e9faut `admin`. Et pour le mot de passe c'est soit ce que vous avez indiqu\u00e9 vous-m\u00eame soit le mot de passe d'origine. Plus d'informations [ici pour la Livebox 5](https://assistance.orange.fr/livebox-modem/toutes-les-livebox-et-modems/installer-et-utiliser/piloter-et-parametrer-votre-materiel/l-interface-de-configuration/livebox-5-acceder-a-l-interface-de-configuration_292471-827404), ou [ici pour la Livebox 6](https://assistance.orange.fr/livebox-modem/toutes-les-livebox-et-modems/installer-et-utiliser/piloter-et-parametrer-votre-materiel/l-interface-de-configuration/livebox-6-acceder-a-l-interface-de-configuration_363963-897414).\r\n- Il est normal que lors du premier lancement de l'application tous les appareils soient marqu\u00e9s comme inconnus (**INCONNU** en rouge). En effet un des buts de ce programme est d'identifier rapidement des appareils inconnus connect\u00e9s sur le r\u00e9seau gr\u00e2ce \u00e0 une base de noms locale (le fichier `MacAddrTable.txt`). Il faut donc commencer par nommer chaque appareil que vous jugez l\u00e9gitime gr\u00e2ce au bouton `Assigner Nom...` de l'onglet `Infos Appareil`. Cette base locale constituera la r\u00e9f\u00e9rence de confiance de tous les appareils l\u00e9gitimes sur votre r\u00e9seau. Le bouton `Assigner Nom...` vous permettra aussi de facilement assigner le m\u00eame nom que celui qui a \u00e9t\u00e9 donn\u00e9 \u00e0 la Livebox.\r\n- Il est normal que les statistiques r\u00e9seau apparaissent et disparaissent. En effet le programme rafra\u00eechit ces statistiques toutes les 3 secondes par d\u00e9faut (ou toutes les 30 secondes dans certains cas), et si d'un rafra\u00eechissement \u00e0 l'autre il n'y a pas eu de transfert la case devient vide. Ce choix a \u00e9t\u00e9 fait pour permettre de mieux visualiser les cases non-vides, l\u00e0 o\u00f9 il se passe quelque chose.\r\n- Tous les onglets peuvent \u00eatre d\u00e9plac\u00e9s \u00e0 la souris pour \u00eatre mis dans l'ordre qui vous convient. Cet ordre sera restaur\u00e9 au prochain lancement du programme.\r\n- Toutes les colonnes dans le programme sont redimensionnables \u00e0 la souris sauf certaines qui s'\u00e9largissent dynamiquement en fonction de la taille de la fen\u00eatre. Donc, en fonction de la situation, vous pouvez soit redimensionner la colonne soit la fen\u00eatre avec la souris pour ajuster la largeur d'une colonne.\r\n- On peut copier la valeur de n'importe quelle cellule de liste dans le presse-papiers. Pour cela il suffit de cliquer sur la cellule et de taper Ctrl-C.\r\n- Le programme dispose d'une barre de statut en bas de la fen\u00eatre. Elle affiche sur la gauche des t\u00e2ches en cours et sur la droite le nom du profil en cours (voir la section **Profils** ci-dessous). Un clic sur le nom de profil affichera la fen\u00eatre pour en changer.\r\n- Des **tooltips** sont disponibles dans l'interface pour vous aider \u00e0 vous passer de la documentation.\r\n\r\n\r\n## Profils <a id=\"profiles\"></a>\r\nLe programme supporte de pouvoir g\u00e9rer plusieurs Livebox \u00e0 l'aide de profils diff\u00e9rents. Chaque profil doit avoir un nom unique. Par d\u00e9faut un profil principal est cr\u00e9\u00e9 automatiquement, mais il est possible d'en cr\u00e9er d'autres soit au d\u00e9marrage du programme dans la fen\u00eatre de s\u00e9lection de profils soit dans les pr\u00e9f\u00e9rences du programme. \r\nSi plusieurs profils sont configur\u00e9s le nom du profil en cours est affich\u00e9 dans le titre de la fen\u00eatre principale entre crochets. \r\nPlusieurs informations sont associ\u00e9es \u00e0 chaque profil, telle que l'URL de la Livebox, son mot de passe, etc. Le programme associe aussi automatiquement l'adresse physique (MAC) de la Livebox sur laquelle la connexion s'est effectu\u00e9e.\r\n\r\nQue se passe-t-il au lancement du programme ?\r\n- Si la touche `Ctrl` est enfonc\u00e9e le programme affiche un dialogue pour s\u00e9lectionner le profil \u00e0 utiliser.\r\n- Sinon, si un profil par d\u00e9faut est configur\u00e9, il sera s\u00e9lectionn\u00e9.\r\n- Sinon, le programme parcourt la liste des profils et cherche si une Livebox avec la m\u00eame adresse physique que celle associ\u00e9e au profil r\u00e9pond \u00e0 l'URL du profil. Le premier profil qui r\u00e9pond \u00e0 ces crit\u00e8res est s\u00e9lectionn\u00e9.\r\n- Si aucun profil trouv\u00e9, le programme affiche un dialogue pour s\u00e9lectionner le profil \u00e0 utiliser.\r\n\r\nLe dialogue de s\u00e9lection de profils vous pr\u00e9vient si vous tentez d'utiliser un profil pour une Livebox diff\u00e9rente de celle avec lequel il est normalement associ\u00e9. Si vous validez le dialogue, le profil sera mis \u00e0 jour pour \u00eatre associ\u00e9 \u00e0 cette nouvelle Livebox. Le dialogue de s\u00e9lection de profils vous permet aussi de cr\u00e9er un nouveau profil si aucun dans la liste ne convient.\r\n\r\n\r\n## Options de ligne de commande <a id=\"commandline\"></a>\r\n\r\n- `--redir` `-r` \r\nPermet de rediriger une URL configur\u00e9e / utilis\u00e9e par le programme pour se connecter \u00e0 la Livebox ou \u00e0 un r\u00e9p\u00e9teur Wifi.\r\nLe format est `url1=url2`. \r\nExemple : `LiveboxMonitor --redir http://livebox/=http://myproxy:2080` \r\nAvec cette option le programme utilisera plut\u00f4t l'URL 'http://myproxy:2080/' pour se connecter \u00e0 'http://livebox/'. \r\nCette option peut \u00eatre utilis\u00e9e plusieurs fois sur la m\u00eame ligne.\r\n\r\n\r\n## Acc\u00e8s \u00e0 distance <a id=\"remoteaccess\"></a>\r\nIl est possible d'utiliser le programme \u00e0 distance si l'acc\u00e8s \u00e0 distance de la Livebox est activ\u00e9.\r\nDans la configuration de la Livebox, cliquez sur la tuile \"Mon acc\u00e8s \u00e0 distance\". Activez l'acc\u00e8s, configurez un nom, un mot de passe, et un num\u00e9ro de port personnalis\u00e9. Vous pouvez aussi en profiter pour activer un DynDNS pour \u00e9viter de changer l'URL \u00e0 chaque fois que votre IP internet change. \r\n\r\nVotre URL de connexion devient alors quelque chose comme ceci : https://monIP:monPort/ \r\nOu alors si vous avez configur\u00e9 un DynDNS : https://monNomDeDomaine.com:monPort/ \r\n\u00c9videment configurez aussi le nom et le mot de passe de connexion en fonction.\r\n\r\n\r\n## Configuration <a id=\"configuration\"></a>\r\n\r\n### R\u00e9pertoire de configuration\r\n- Si le programme est lanc\u00e9 par son code source le r\u00e9pertoire de configuration est le m\u00eame que celui contenant le fichier source de lancement `lbm.py`.\r\n\r\n- Si le package PyPI (installation avec la commande 'pip') ou les programmes construits avec [PyInstaller](https://pyinstaller.org) sont utilis\u00e9s, le r\u00e9pertoire de configuration se trouve dans les r\u00e9pertoires standards du syst\u00e8me :\r\n - Windows : `%APPDATA%\\LiveboxMonitor`\r\n - MacOS : `~/Library/Application Support/LiveboxMonitor`\r\n\r\nLe programme cr\u00e9\u00e9 automatiquement dans son r\u00e9pertoire de configuration deux fichiers au format JSON :\r\n- `Key.txt` : clef de chiffrement unique g\u00e9n\u00e9r\u00e9e pour crypter tous les mots de passe. Cette clef est elle-m\u00eame crypt\u00e9e avec une clef qui est calcul\u00e9e par le programme \u00e0 partir des caract\u00e9ristiques uniques de votre PC (y compris son nom). Si quelque chose de significatif change sur votre PC (le processeur, l'OS, son nom, etc), cette clef sera r\u00e9g\u00e9n\u00e9r\u00e9e automatiquement et tous vos mots de passe devront \u00eatre ressaisis.\r\n- `Config.txt` : contient tous les param\u00e8tres de l'application.\r\n- `MacAddrTable.txt` : contient la correspondance entre les adresses MAC et les noms d'appareil.\r\n\r\n### Le fichier Config.txt\r\n\r\nCe fichier est g\u00e9r\u00e9 automatiquement par l'application et il ne devrait pas \u00eatre n\u00e9cessaire de l'\u00e9diter. Les r\u00e9glages principaux se font via le bouton `Pr\u00e9f\u00e9rences...` de l'onglet `Actions`. \r\n\u00c0 savoir : \r\n- Les mots de passe y sont stock\u00e9s crypt\u00e9s grace \u00e0 la clef de chiffrement du fichier `Key.txt`.\r\n- La clef `Repeaters` est g\u00e9n\u00e9r\u00e9e automatiquement par le programme si des mots de passe diff\u00e9rents sont utilis\u00e9s pour le ou les r\u00e9p\u00e9teurs Wifi Orange connect\u00e9s. La structure de ce param\u00e8tre est aussi au format JSON, utilise pour clef les adresses MAC des r\u00e9p\u00e9teurs, et r\u00e9f\u00e9rence pour chaque r\u00e9p\u00e9teur les valeurs 'User' & 'Password'.\r\n\r\n### Le fichier MacAddrTable.txt\r\n\r\nCe fichier est g\u00e9r\u00e9 automatiquement par l'application et il ne devrait pas \u00eatre n\u00e9cessaire de l'\u00e9diter.\r\nLes clefs correspondent aux adresses MAC des appareils et les valeurs au nom attribu\u00e9.\r\nTout appareil d\u00e9tect\u00e9 dont l'adresse MAC n'est pas r\u00e9pertori\u00e9e sera affich\u00e9 comme 'INCONNU' en rouge. Cette fonctionnalit\u00e9 est surtout utile pour d\u00e9tecter les nouveaux appareils ou des tentatives d'intrusions.\r\n\r\nPourquoi utiliser une base de noms locale alors que la Livebox stocke aussi des noms ?\r\n- Parce que la Livebox \"oublie\" tout appareil qui ne s'est pas connect\u00e9 depuis plus d'un mois.\r\n- Parce que parfois la Livebox perd des noms de fa\u00e7on impromptue pour certains appareils. C'est le cas par exemple pour le nom des r\u00e9p\u00e9teurs Wifi. \r\nUn fichier de noms local offre la garantie de savoir si un appareil est vraiment inconnu.\r\n\r\n\r\n## Linux <a id=\"linux\"></a>\r\nEn cas d'utilisation d'un virtualenv, si des erreurs de plugin Qt apparaissent, rajoutez ces commandes pour l'installation :\r\n\r\n```\r\n apt install qt6-base-dev\r\n apt install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev\r\n```\r\n\r\nEn cas d'erreurs avec Wayland, il est possible de changer le moteur de rendu de Qt avec la variable d\u2019environnement `QT_QPA_PLATFORM`. \r\nPar exemple : `QT_QPA_PLATFORM=xcb python3 lbm.py` permet d'utiliser X Window directement (qui \u00e9ventuellement sera rendu avec Xwayland mais cela fonctionne).\r\n\r\nUne autre m\u00e9thode consiste \u00e0 supprimer la variable d\u2019environnement `WAYLAND_DISPLAY` uniquement pour l\u2019ex\u00e9cution du programme et pas de fa\u00e7on globale, pour ce faire : `env -u WAYLAND_DISPLAY python3 lbm.py`.\r\n\r\n\r\n## Appareils - Liste des appareils connect\u00e9s <a id=\"devicelist\"></a>\r\n\r\n### Liste\r\nLa liste des appareils affiche les colonnes suivantes :\r\n- **T** : ic\u00f4ne correspondant au type de l'appareil. Ce type peut \u00eatre attribu\u00e9 ou chang\u00e9 via le bouton `Assigner Type...` de l'onglet `Infos Appareil`.\r\n- **Nom** : nom local de l'appareil. Ce nom peut \u00eatre attribu\u00e9, chang\u00e9 ou supprim\u00e9 via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.\r\n- **Nom Livebox** : nom de l'appareil tel que param\u00e9tr\u00e9 dans la Livebox et visible dans l'interface Web de la Livebox. Ce nom peut \u00eatre attribu\u00e9, chang\u00e9 ou supprim\u00e9 via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.\r\n- **MAC** : adresse MAC, aussi appel\u00e9e adresse physique de l'appareil.\r\n- **IP** : adresse IP v4 de l'appareil sur le LAN. Cette adresse s'affiche en caract\u00e8res gras si cette adresse est r\u00e9serv\u00e9e pour cet appareil dans la configuration DHCP de la Livebox. Et elle s'affiche en rouge si l'adresse n'est pas atteignable sur le r\u00e9seau (unreacheable), typiquement lorsque l'appareil n'est pas actif.\r\n- **Acc\u00e8s** : point d'acc\u00e8s de l'appareil sur le r\u00e9seau. D'abord le nom de l'appareil, c'est-\u00e0-dire la Livebox elle-m\u00eame ou le nom d'un des r\u00e9p\u00e9teurs Wifi Orange connect\u00e9s, et ensuite l'interface sur cet appareil. `Eth` signifie une des prises Ethernet suivi du num\u00e9ro de prise. `Wifi` signifie une connexion Wifi suivi par la bande de connexion.\r\n- **A** : indique par une ic\u00f4ne si l'appareil est actif ou non. Par d\u00e9faut la liste est tri\u00e9e pour montrer d'abord les appareils actifs.\r\n- **Wifi** : qualit\u00e9 de la connexion Wifi.\r\n- **E** : indique par une ic\u00f4ne avec un point d'exclamation  lorsqu'un \u00e9v\u00e9nement est re\u00e7u pour cet appareil. La liste d\u00e9taill\u00e9e des \u00e9v\u00e9nements, ainsi que le contenu des \u00e9v\u00e9nements eux-m\u00eames, peuvent \u00eatre consult\u00e9s via l'onglet `\u00c9v\u00e9nements`.\r\n- **Rx** : nombre d'octets re\u00e7us par l'appareil depuis le dernier d\u00e9marrage de la Livebox.\r\n- **Tx** : nombre d'octets envoy\u00e9s par l'appareil depuis le dernier d\u00e9marrage de la Livebox.\r\n- **TauxRx** : taux d'octets re\u00e7us par seconde par l'appareil dans les derni\u00e8res 30 secondes si affich\u00e9 en noir, dans les trois derni\u00e8res secondes si affich\u00e9 en bleu (fr\u00e9quence r\u00e9glable dans les pr\u00e9f\u00e9rences).\r\n- **TauxTx** : taux d'octets envoy\u00e9s par seconde par l'appareil dans les derni\u00e8res 30 secondes si affich\u00e9 en noir, dans les trois derni\u00e8res secondes si affich\u00e9 en bleu (fr\u00e9quence r\u00e9glable dans les pr\u00e9f\u00e9rences).\r\n\r\nLes statistiques d'octets envoy\u00e9s ou re\u00e7us par seconde sont calcul\u00e9es gr\u00e2ce aux statistiques envoy\u00e9es par la Livebox sous forme d'\u00e9v\u00e9nement toutes les 30 secondes par appareil. Cette r\u00e9solution \u00e9tant peu significative le programme utilise une autre interface disponible pour les appareils Wifi uniquement pour obtenir des statistiques toutes les trois secondes (option pour les activer/d\u00e9sactiver dans les pr\u00e9f\u00e9rences, ainsi que la fr\u00e9quence). Ces derni\u00e8res sont affich\u00e9es en bleu. \r\nSi une statistique s'affiche en rouge cela signifie que des erreurs de transfert ont \u00e9t\u00e9 d\u00e9tect\u00e9es par la Livebox.\r\nLes statistiques semblent parfois surprenantes, mais il s'agit d'une interpr\u00e9tation sans filtre de ce que renvoie la Livebox (il ne s'agit pas d'un d\u00e9faut du programme). \r\n**Note** : le trafic TV standard de la box TV UHD n'est pas comptabilis\u00e9 dans les statistiques pour cet appareil. Par contre celui de services VOD tel que Netflix est bien comptabilis\u00e9.\r\n\r\n\r\n### Boutons\r\nL'onglet `Appareils` propose les boutons suivants :\r\n- **`Rafra\u00eechir`** : permet de forcer le rafra\u00eechissement de la liste des appareils, non seulement dans cet onglet mais aussi dans les onglets `Infos Appareil` et `\u00c9v\u00e9nements`. Utile par exemple si le programme est actif alors que l'ordinateur sort de veille : des \u00e9v\u00e9nements ayant probablement \u00e9t\u00e9 rat\u00e9 par le programme, un rafra\u00eechissement permettra de retrouver une vue \u00e0 jour.\r\n- **`Infos Appareil`** : permet de basculer dans l'onglet `Infos Appareil` pour l'appareil s\u00e9lectionn\u00e9 et de voir directement ses informations.\r\n- **`\u00c9v\u00e9nements Appareil`** : permet de basculer dans l'onglet `\u00c9v\u00e9nements` pour l'appareil s\u00e9lectionn\u00e9 et de voir directement les \u00e9v\u00e9nements re\u00e7us le concernant.\r\n- **`IPv6...`** : permet d'avoir le statut d'activation de l'IPv6, l'adresse IPv6 de la Livebox ainsi que son pr\u00e9fixe, et la liste des appareils connect\u00e9s ou non ayant une ou plusieurs IPv6 assign\u00e9es.\r\n- **`DNS...`** : permet d'avoir la liste des noms DNS assign\u00e9s aux appareils. Ces noms DNS peuvent \u00eatre attribu\u00e9s, chang\u00e9s ou supprim\u00e9s via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.\r\n\r\n\r\n## Stats/Infos Livebox - Statistiques de trafic et infos avanc\u00e9es de la Livebox <a id=\"infos\"></a>\r\n\r\n\r\n\r\nLes statistiques de trafic par interface sont affich\u00e9es sous forme de liste en haut \u00e0 gauche.\r\nEt toutes les informations sont accessibles par les boutons, chaque bouton remplissant la liste d'attributs sur la droite. Il est aussi possible d'exporter l'ensemble des informations dans un fichier.\r\n\r\n### Statistiques\r\n\r\nListe permettant de surveiller l'\u00e9tat du trafic :\r\n- **Nom** : nom de l'interface r\u00e9seau. `Fiber` concerne tout le trafic WAN, c'est-\u00e0-dire externe entre la Livebox et internet. `LAN` tout le trafic interne transitant \u00e0 travers la Livebox. Ensuite on dispose des statistiques par interface pr\u00e9cise. Les interfaces `Guest` concernent le trafic du r\u00e9seau Wifi invit\u00e9, s'il est activ\u00e9.\r\n- **Rx** : nombre d'octets re\u00e7us par l'interface. La fen\u00eatre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont d\u00e9tect\u00e9es. Attention ce compteur est circulaire et ne d\u00e9passe pas les 4 Go pour certaines interfaces. En effet pour d'autres, un compteur de plus haute r\u00e9solution est interpr\u00e9t\u00e9 toutes les 30 secondes environ et qui vient remplacer au lancement du programme le compteur de base limit\u00e9 \u00e0 4 Go.\r\n- **Tx** : nombre d'octets envoy\u00e9s par l'interface. La fen\u00eatre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont d\u00e9tect\u00e9es. Attention ce compteur est circulaire et ne d\u00e9passe pas les 4 Go pour certaines interfaces. En effet pour d'autres, un compteur de plus haute r\u00e9solution est interpr\u00e9t\u00e9 toutes les 30 secondes environ et qui vient remplacer au lancement du programme le compteur de base limit\u00e9 \u00e0 4 Go.\r\n- **TauxRx** : taux d'octets re\u00e7us par seconde par l'interface dans les trois derni\u00e8res secondes (fr\u00e9quence r\u00e9glable dans les pr\u00e9f\u00e9rences). S'affiche en rouge si des erreurs de transmission sont d\u00e9tect\u00e9es. \r\n- **TauxTx** : taux d'octets envoy\u00e9s par seconde par l'interface dans les trois derni\u00e8res secondes (fr\u00e9quence r\u00e9glable dans les pr\u00e9f\u00e9rences). S'affiche en rouge si des erreurs de transmission sont d\u00e9tect\u00e9es.\r\n\r\nSi une statistique s'affiche en rouge cela signifie que des erreurs de transfert ont \u00e9t\u00e9 d\u00e9tect\u00e9es par la Livebox.\r\nLes statistiques semblent parfois surprenantes, mais il s'agit d'une interpr\u00e9tation sans filtre de ce que renvoie la Livebox (il ne s'agit pas d'un d\u00e9faut du programme).\r\n**Note** : le trafic TV standard de la box TV UHD n'est pas comptabilis\u00e9 dans ces statistiques. Par contre celui de services VOD tel que Netflix est bien comptabilis\u00e9.\r\n\r\n### Boutons\r\nL'onglet `Stats/Infos Livebox` propose les boutons suivants :\r\n- **`Infos Livebox`** : affiche les informations principales concernant la Livebox, telles que les versions de logiciels, l'adresse IP WAN, les services actifs, l'\u00e9tat de la m\u00e9moire, etc.\r\n- **`Infos Internet`** : affiche le type d'acc\u00e8s internet, les identifiants de connexion, les adresses IPs v4 & v6, la date et heure de la derni\u00e8re connexion, la bande passante de la connexion, la MTU, etc\r\n- **`Infos Wifi`** : affiche les informations g\u00e9n\u00e9rales sur la connectivit\u00e9 Wifi, et l'\u00e9tat de chaque acc\u00e8s y compris pour les acc\u00e8s invit\u00e9s. Pour chaque acc\u00e8s on dispose d'informations d\u00e9taill\u00e9es telles que le canal, le standard, la bande passante, la qualit\u00e9, la bande, le nombre d'appareils connect\u00e9s, etc.\r\n- **`Infos LAN`** : affiche les informations g\u00e9n\u00e9rales sur la connectivit\u00e9 LAN. Il s'agit des informations DHCP de base et pour chaque interface Ethernet on peut identifier si elle est active ou non, la bande passante, etc.\r\n- **`Infos ONT`** : affiche les informations importantes concernant la connexion et le module Fibre (ONT), telles que la bande passante, la qualit\u00e9 du signal, le num\u00e9ro de s\u00e9rie et les versions logicielles, etc. Les champs `Puissance Signal R\u00e9ception`, `Puissance Signal Transmission`, `Temp\u00e9rature`, `Voltage` et `BIAS` affichent des valeurs vertes si elles correspondent aux normes de qualit\u00e9 acceptables pour la connexion, en rouge si elles repr\u00e9sentent un probl\u00e8me. Attention ce bouton n'est **pas disponible pour les Livebox 4**.\r\n\r\n- **`Infos VoIP`** : affiche les informations g\u00e9n\u00e9rales concernant la t\u00e9l\u00e9phonie, telles que le protocole, le num\u00e9ro de t\u00e9l\u00e9phone, la version logicielle de l'interface DECT, etc.\r\n- **`Infos IPTV`** : affiche les informations g\u00e9n\u00e9rales relatives aux services de t\u00e9l\u00e9vision.\r\n- **`Infos USB`** : affiche les informations concernant le ou les ports USBs. Si une clef USB est ins\u00e9r\u00e9e, ou a \u00e9t\u00e9 ins\u00e9r\u00e9e depuis le dernier d\u00e9marrage de la Livebox, ses informations sont affich\u00e9es.\r\n- **`Export...`** : permet d'exporter l'ensemble des informations affich\u00e9es par chacun des boutons dans un fichier texte. Utile pour communiquer ces informations ou faire un suivi pour d\u00e9tecter les changements.\r\n\r\n\r\n## Graphes - Courbes de trafic par interface et par appareil <a id=\"graphs\"></a>\r\n\r\n\r\n\r\nAffiche les graphiques des donn\u00e9es re\u00e7ues et transmises pour chaque interface / appareil s\u00e9lectionn\u00e9 \u00e0 partir de donn\u00e9es stock\u00e9es par la Livebox elle-m\u00eame. Les volumes sont en m\u00e9ga-octets entre deux \u00e9chantillons, en principe toutes les 30 secondes (l'\u00e9chantillonnage et sa fr\u00e9quence sont contr\u00f4l\u00e9s par la Livebox). Les graphes se mettent \u00e0 jour automatiquement \u00e0 la r\u00e9ception de nouveaux \u00e9chantillons sous forme d'\u00e9v\u00e9nements. \r\nIl est possible de naviguer et de zoomer dans les graphiques \u00e0 la souris, puis de revenir \u00e0 la vue normale en cliquant dans le coin en bas \u00e0 gauche. Un clic droit sur un graphe permet d'acc\u00e9der \u00e0 d'autres fonctionnalit\u00e9s telles que l'exportation en diff\u00e9rents formats. Toute la documentation est accessible [ici](https://pyqtgraph.readthedocs.io/en/latest/user_guide/index.html).\r\n\r\n### S\u00e9lection des interfaces et des appareils\r\nIl faut commencer par s\u00e9lectionner les interfaces et/ou les appareils dont on veut obtenir les graphiques, pour cela deux boutons sont disponibles :\r\n- **`Ajouter...`** : affiche un dialogue permettant de s\u00e9lectionner une interface ou un appareil.\r\n\r\n \r\n\r\n Commencer par s\u00e9lectionner le type, interface ou appareil. Puis l'interface ou l'appareil en question, ainsi que la couleur \u00e0 utiliser sur le graphique pour cet objet. La s\u00e9lection n'affiche que des objets pour lesquels des mesures sont potentiellement disponibles. Pour les appareils les noms locaux sont utilis\u00e9s, et par d\u00e9faut l'adresse physique (MAC). Le dialogue affiche en informations compl\u00e9mentaires l'identifiant interne \u00e0 la Livebox de l'objet s\u00e9lectionn\u00e9, le nombre d'\u00e9chantillons stock\u00e9s dans la Livebox pour cet objet (le nombre maximum est fix\u00e9 \u00e0 8680 par la Livebox) et une estimation de la fen\u00eatre de temps correspondante. Cependant cette fen\u00eatre de temps peut \u00eatre erron\u00e9e, car si l'interface ou l'appareil sont d\u00e9connect\u00e9s pendant une p\u00e9riode de temps aucun \u00e9chantillon n'est \u00e9mis durant cette p\u00e9riode. Ce qui veut dire que la p\u00e9riode de temps totale entre le plus ancien \u00e9chantillon et le plus r\u00e9cent peut \u00eatre bien plus longue que cette estimation.\r\n- **`Supprimer`** : permet de supprimer l'interface ou l'appareil s\u00e9lectionn\u00e9.\r\n\r\n### Options des graphiques\r\nDes options sont disponibles pour param\u00e9trer les graphiques :\r\n- **`Fen\u00eatre`** : fen\u00eatre de temps en heure de l'affichage des graphiques, \u00e0 partir du pr\u00e9sent. Une valeur \u00e0 0 affichera l'ensemble des statistiques disponibles dans la Livebox pour les objets s\u00e9lectionn\u00e9s.\r\n- **`Couleur de fond`** : couleur de fond \u00e0 utiliser pour les graphiques de r\u00e9ception et d'\u00e9mission. Un clic droit supprime toute couleur, la couleur par d\u00e9faut sera donc utilis\u00e9e.\r\n\r\n### G\u00e9n\u00e9ration des graphiques\r\nLe bouton **`Appliquer`** permet de charger toutes les informations relatives aux interfaces et appareils s\u00e9lectionn\u00e9s, de dessiner les graphiques correspondants en tenant compte des options ci-dessus, et de sauvegarder la configuration. Celle-ci sera automatiquement recharg\u00e9e au prochain lancement du programme. \r\n\r\nLe bouton **`Export...`** permet d'exporter au format CSV (avec le point-virgule comme s\u00e9parateur) les derni\u00e8res donn\u00e9es charg\u00e9es par le bouton `Appliquer` ainsi que celles re\u00e7ues entre temps via des \u00e9v\u00e9nements.\r\n\r\n\r\n## Infos Appareil - Informations d\u00e9taill\u00e9es pour chaque appareil connu <a id=\"deviceinfos\"></a>\r\n\r\n\r\n\r\nLa liste des appareils connus, sur la gauche, affiche les colonnes suivantes :\r\n- **Nom** : nom local de l'appareil. Ce nom peut \u00eatre attribu\u00e9, chang\u00e9 ou supprim\u00e9 via le bouton `Assigner Nom...`.\r\n- **MAC** : adresse MAC, aussi appel\u00e9e adresse physique de l'appareil.\r\n\r\nLorsqu'un appareil est s\u00e9lectionn\u00e9 dans cette liste ses informations d\u00e9taill\u00e9es s'affichent dans la liste de droite. Attributs notables :\r\n- **Actif** : indique si l'appareil est actif ou non.\r\n- **Authentifi\u00e9** : indique si la connexion Wifi de l'appareil a bien \u00e9t\u00e9 authentifi\u00e9e.\r\n- **Bloqu\u00e9** : indique si vous avez bloqu\u00e9 la connexion de l'appareil \u00e0 la Livebox ou non. Le blocage peut \u00eatre contr\u00f4l\u00e9 avec les boutons `Bloquer` et `D\u00e9bloquer`. Il peut \u00eatre utile de bloquer un appareil inconnu si vous avez des suspicions.\r\n- **Premi\u00e8re Connexion** : date et heure de la premi\u00e8re connexion. Attention cette valeur peut aussi correspondre \u00e0 la date/heure d'un pr\u00e9c\u00e9dent red\u00e9marrage de la Livebox.\r\n- **Derni\u00e8re Connexion** : date et heure de la derni\u00e8re connexion.\r\n- **Dernier Changement** : date et heure du dernier changement d\u00e9tect\u00e9 pour cet appareil.\r\n- **Nom** : nom connu par la Livebox pour cet appareil, avec la source de ce nom entre parenth\u00e8ses. Ainsi plusieurs noms peuvent s'afficher pour des sources diff\u00e9rentes.\r\n- **Type** : type connu par la Livebox pour cet appareil, avec la source de ce type entre parenth\u00e8ses. Ainsi plusieurs types peuvent s'afficher pour des sources diff\u00e9rentes.\r\n- **Adresse IPvX** : adresse IP (v4 ou v6) de l'appareil. Entre parenth\u00e8ses s'affiche si l'adresse est celle active ou non, et atteignable sur le r\u00e9seau (reacheable) ou non (not reacheable). Si l'adresse est r\u00e9serv\u00e9e pour cet appareil dans la configuration DHCP de la Livebox une mention s'affiche (Reserved).\r\n- **Fabricant** : le fabricant de cet appareil, d\u00e9duit \u00e0 partir de son adresse MAC. Le programme utilise l'API du site [macaddress.io](https://macaddress.io/) pour d\u00e9terminer le fabricant. C'est un service gratuit, mais il faut cr\u00e9er un compte et indiquer l'API Key correspondante dans les pr\u00e9f\u00e9rences pour b\u00e9n\u00e9ficier de cette fonctionnalit\u00e9.\r\n- **Force Signal Wifi** et **Taux Bruit Signal Wifi** : donnent des indications sur la qualit\u00e9 de la connexion pour les appareils Wifi.\r\n\r\n### Boutons\r\nL'onglet `Infos Appareil` propose les boutons suivants :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit les informations affich\u00e9es pour l'appareil s\u00e9lectionn\u00e9.\r\n- **`Assigner Nom...`** : permet d'attribuer ou d'effacer le nom local, le nom Livebox et/ou le nom DNS de l'appareil s\u00e9lectionn\u00e9.\r\n\r\n \r\n\r\n D\u00e9cocher la boite pour effacer le nom. Les deux noms peuvent \u00eatre diff\u00e9rents.\r\n- **`Assigner Type...`** : permet d'attribuer ou d'effacer le type de l'appareil s\u00e9lectionn\u00e9.\r\n\r\n \r\n\r\n Il est possible de s\u00e9lectionner un des types standards connus par la Livebox dans le menu, chaque type \u00e9tant affich\u00e9 avec son ic\u00f4ne Livebox correspondante. Lorsqu'un type standard est s\u00e9lectionn\u00e9, son nom connu par la Livebox est automatiquement rempli dans la zone de texte et on peut valider le dialogue. Il reste possible d'assigner manuellement un type non connu par la Livebox en le tapant directement dans la zone de texte. Note : bien que le type \"Djingo Speaker\" soit r\u00e9f\u00e9renc\u00e9 comme standard par la Livebox 5, ce type ne semble pas (encore ?) support\u00e9 par l'interface graphique de la Livebox.\r\n- **`Oublier...`** : permet de demander \u00e0 la Livebox d'oublier d\u00e9finitivement cet appareil. Il dispara\u00eetra donc imm\u00e9diatement de toutes les listes. Attention si l'appareil en question est actif, sa connexion ne sera nullement suspendue, cependant toute son activit\u00e9 restera invisible et ce jusqu'\u00e0 sa prochaine tentative de connexion.\r\n- **`Bloquer`** : permet de bloquer la connexion de l'appareil s\u00e9lectionn\u00e9.\r\n- **`D\u00e9bloquer`** : permet de d\u00e9bloquer la connexion de l'appareil s\u00e9lectionn\u00e9. L'\u00e9tat bloqu\u00e9 ou non s'affiche dans les informations de l'appareil, champs \"Bloqu\u00e9\".\r\n\r\n\r\n## \u00c9v\u00e9nements - Liste des \u00e9v\u00e9nements re\u00e7us pour chaque appareil connu <a id=\"events\"></a>\r\n\r\n\r\n\r\nLa liste des appareils connus, sur la gauche, affiche les colonnes suivantes :\r\n- **Nom** : nom local de l'appareil. Ce nom peut \u00eatre attribu\u00e9, chang\u00e9 ou supprim\u00e9 via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.\r\n- **MAC** : adresse MAC, aussi appel\u00e9e adresse physique de l'appareil.\r\n\r\nLorsqu'un appareil est s\u00e9lectionn\u00e9 dans cette liste tous les \u00e9v\u00e9nements re\u00e7us depuis le lancement du programme pour cet appareil s'affichent dans la liste de droite. La plupart de ces \u00e9v\u00e9nements ont \u00e9t\u00e9 interpr\u00e9t\u00e9s par le programme pour mettre \u00e0 jour l'interface dynamiquement, et cette liste permet d'avoir un historique. La taille de cet historique par appareil est limit\u00e9e aux 100 derni\u00e8res entr\u00e9es (cette limite peut \u00eatre ajust\u00e9e facilement en modifiant la variable `MAX_EVENT_BUFFER_PER_DEVICE` du module `LmEventsTab.py`).\r\n\r\nLa liste des \u00e9v\u00e9nements est compos\u00e9e des colonnes :\r\n- **Heure** : heure de r\u00e9ception de l'\u00e9v\u00e9nement.\r\n- **Raison** : le type d'\u00e9v\u00e9nement g\u00e9n\u00e9r\u00e9 par la Livebox.\r\n- **Attributs** : aper\u00e7u des donn\u00e9es brutes de l'\u00e9v\u00e9nement lui-m\u00eame, au format JSON.\r\n\r\nUn double clic sur un \u00e9v\u00e9nement ou un clic sur le bouton **`Afficher \u00c9v\u00e9nement`** permet d'afficher un dialogue contenant les informations compl\u00e8tes :\r\n- **Raised** : date et heure pr\u00e9cise de r\u00e9ception de l'\u00e9v\u00e9nement.\r\n- **Handler** : gestionnaire de l'\u00e9v\u00e9nement, contenant la plupart du temps la clef de l'appareil qui n'est autre que son adresse MAC.\r\n- **Reason** : le type d'\u00e9v\u00e9nement.\r\n- **Attributes** : donn\u00e9es brutes compl\u00e8tes de l'\u00e9v\u00e9nement lui-m\u00eame, au format JSON tel que g\u00e9n\u00e9r\u00e9 par la Livebox. \r\n\r\n### Notifications automatiques\r\n- Le bouton **`Notifications...`** permet d'acc\u00e9der \u00e0 configuration des notifications automatiques \u00e0 g\u00e9n\u00e9rer (par exemple par email) \u00e0 la d\u00e9tection de certains \u00e9v\u00e9nements.\r\n\r\n \r\n\r\n Vous pouvez cr\u00e9er autant de r\u00e8gles que n\u00e9cessaire. Ce n'est pas grave si plusieurs r\u00e8gles concernent le ou les m\u00eames appareils, le programme ne d\u00e9tecte pas non plus les r\u00e8gles dupliqu\u00e9es. Il suffit qu'au moins une r\u00e8gle soit trouv\u00e9e qui concerne une notification pour un appareil pour que cette notification soit effectu\u00e9e.\r\n La liste affiche la liste des r\u00e8gles configur\u00e9es, avec le ou les appareils concern\u00e9s, les pastilles bleues indiquent les \u00e9v\u00e9nements s\u00e9lectionn\u00e9s pour la notification, les pastilles vertes le ou les types de notifications s\u00e9lectionn\u00e9s (email et/ou fichiers CSV journaliers). Les boutons **`Ajouter`** et **`Supprimer`** permettent de cr\u00e9er une r\u00e8gle ou de supprimer la r\u00e8gle s\u00e9lectionn\u00e9e. \r\n\r\n Param\u00e8tres d'une r\u00e8gle :\r\n - **`Appareil`** : permet de s\u00e9lectionner le ou les appareils pour lesquels recevoir une notification. `Tout appareil` appliquera la r\u00e8gle pour l'ensemble des appareils. `Tout appareil inconnu` appliquera la r\u00e8gle \u00e0 n'importe quel appareil inconnu.\r\n - **`Adresse MAC`** : adresse physique de l'appareil s\u00e9lectionn\u00e9.\r\n - **`\u00c9v\u00e9nements`** : s\u00e9lection des \u00e9v\u00e9nements pour lesquels recevoir une notification. Ajout ou suppression d'appareils, connexion, d\u00e9connexion, ou changement de points d'acc\u00e8s (utile si vous disposez d'un ou plusieurs r\u00e9p\u00e9teurs Wifi Orange).\r\n - **`Actions`** : s\u00e9lection des actions \u00e0 r\u00e9aliser pour notifier. Il est possible de reporter les \u00e9v\u00e9nements dans un fichier CSV journalier, ou d'envoyer les informations de chaque \u00e9v\u00e9nement par email instantan\u00e9.\r\n\r\n Pr\u00e9f\u00e9rences des notifications:\r\n - **`Fr\u00e9quences R\u00e9solution des \u00c9v\u00e9nements`** : les \u00e9v\u00e9nements sont d\u00e9tect\u00e9s instantan\u00e9ment, cependant certains \u00e9v\u00e9nements peuvent s'annuler lorsque g\u00e9n\u00e9r\u00e9s dans une courte fen\u00eatre de temps, tels que la d\u00e9connexion suivie d'une reconnexion dans les 15 secondes d'un appareil donn\u00e9 (arrive fr\u00e9quemment). Pour \u00e9viter des notifications intempestives un temps d'attente de 30 secondes est fortement recommand\u00e9 pour laisser le programme identifier ces situations. Un temps inf\u00e9rieur \u00e0 5 secondes est fortement d\u00e9conseill\u00e9 pour \u00e9viter que le programme ne consomme trop de ressources.\r\n - **`R\u00e9pertoire des fichiers CSV`** : r\u00e9pertoire dans lequel g\u00e9n\u00e9rer les fichiers CSV journaliers. Cocher l'option `D\u00e9faut` pour g\u00e9n\u00e9rer les fichiers dans le [le r\u00e9pertoire de configuration du programme](#configuration). Sinon cliquer sur le bouton `S\u00e9lectionner` pour choisir un r\u00e9pertoire sp\u00e9cifique.\r\n\r\n## DHCP - Contr\u00f4le fin du serveur DHCP <a id=\"dhcp\"></a>\r\n\r\n\r\n\r\n### Baux statiques\r\nLa liste des baux statiques configur\u00e9s est affich\u00e9e sur la gauche. Les deux domaines de r\u00e9seau sont g\u00e9r\u00e9s :\r\n- `Home` : votre r\u00e9seau priv\u00e9, dont vous pouvez configurer sa plage d'IPs.\r\n- `Guest` : le r\u00e9seau Wifi invit\u00e9, qui a sa propre plage d'IPs (non-modifiable).\r\n\r\nLa liste affiche les colonnes suivantes :\r\n- **Nom** : nom local de l'appareil. Ce nom peut \u00eatre attribu\u00e9, chang\u00e9 ou supprim\u00e9 via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.\r\n- **Domaine** : domaine d'assignation, `Home` ou `Guest`.\r\n- **MAC** : adresse MAC, aussi appel\u00e9e adresse physique de l'appareil.\r\n- **IP** : adresse IP assign\u00e9e statiquement \u00e0 l'appareil.\r\n\r\n### Boutons\r\nLes boutons suivants sont propos\u00e9s pour g\u00e9rer la liste des baux :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit la liste des baux statiques.\r\n- **`Ajouter...`** : permet d'ajouter un bail.\r\n\r\n \r\n\r\n La liste des appareils propos\u00e9s est tri\u00e9e et est compos\u00e9e d'un m\u00e9lange des appareils connect\u00e9s et ceux r\u00e9f\u00e9renc\u00e9s dans le fichier local des adresses MAC. L'adresse MAC est directement d\u00e9duite de l'appareil s\u00e9lectionn\u00e9 mais on peut en taper une totalement \u00e0 la main. Choisir le domaine r\u00e9seau entre `Home` ou `Guest`, et une adresse IP libre sera automatiquement propos\u00e9e mais celle ci reste bien s\u00fbr configurable. Attention un m\u00eame appareil ne peut \u00eatre configur\u00e9 que sur un seul domaine, et s'il se connecte sur un domaine alors qu'un bail statique est configur\u00e9 sur l'autre ce bail sera automatiquement supprim\u00e9.\r\n- **`Supprimer`** : supprime le bail s\u00e9lectionn\u00e9.\r\n\r\n### Informations DHCP d\u00e9taill\u00e9es\r\nLa liste sur la droite affiche de nombreux d\u00e9tails sur le serveur DHCP:\r\n- La configuration d\u00e9taill\u00e9e des deux domaines `Home` et `Guest`.\r\n- Des d\u00e9tails sur le DHCPv4 ainsi que toutes les options DHCP envoy\u00e9es et re\u00e7ues.\r\n- Des d\u00e9tails sur le DHCPv6 ainsi que toutes les options DHCP envoy\u00e9es et re\u00e7ues.\r\n\r\n### Boutons\r\nLes boutons suivants sont propos\u00e9s pour g\u00e9rer la liste des baux :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit la liste des informations DHCP.\r\n- **`R\u00e9glages DHCP...`** : permet de configurer le serveur DHCP.\r\n\r\n \r\n\r\n Permet d'activer ou de d\u00e9sactiver le serveur, de changer l'adresse IP de la Livebox, de changer le masque de sous-r\u00e9seau du serveur DHCP ainsi que la plage d'adresse IP pour le domaine `Home`.\r\n\r\n\r\n## NAT/PAT - R\u00e8gles de redirection de port et de protocole <a id=\"natpat\"></a>\r\n\r\n\r\n\r\nCet onglet permet de g\u00e9rer de fa\u00e7on fine les r\u00e8gles de redirection de port et de protocole IPv4, IPv6 et UPnP de la Livebox. De par cette gestion fine il peut arriver que certaines r\u00e8gles, bien que correctement stock\u00e9es et interpr\u00e9t\u00e9es par la Livebox, ne s'affichent pas dans l'interface Web de la Livebox. Ceci est normal et ne repr\u00e9sente pas vraiment de probl\u00e8me.\r\n\r\n### Redirections de port\r\nLa liste des r\u00e8gles de redirection de port, en haut, affiche les colonnes suivantes :\r\n- **A** : ic\u00f4ne indiquant si la r\u00e8gle est active ou non.\r\n- **Type** : type de la r\u00e8gle, entre IPv4, IPv6 et UPnP. Les r\u00e8gles UPnP sont g\u00e9r\u00e9es automatiquement par la Livebox et vous ne devriez normalement pas avoir \u00e0 les modifier.\r\n- **Nom** : nom de la r\u00e8gle.\r\n- **Description** : description de la r\u00e8gle.\r\n- **Protocoles** : liste des protocoles concern\u00e9s par la r\u00e8gle. \r\n- **Port Interne** : port ou plage de ports interne sur lequel le trafic est redirig\u00e9.\r\n- **Port Externe** : port ou plage de ports externe \u00e0 rediriger.\r\n- **Appareil** : appareil (ou son adresse IP) sur lequel le trafic est redirig\u00e9.\r\n- **IP Externes** : liste des adresses IPs externes concern\u00e9es par la r\u00e8gle.\r\n\r\nUn **double clic** sur une r\u00e8gle permet de facilement l'\u00e9diter.\r\n\r\n### Boutons\r\nLes boutons suivants sont propos\u00e9s pour g\u00e9rer la liste des r\u00e8gles :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit la liste des r\u00e8gles de redirection de port.\r\n- **`Activer/D\u00e9sactiver`** : active/d\u00e9sactive la r\u00e8gle s\u00e9lectionn\u00e9e.\r\n- **`Ajouter...`** : permet d'ajouter une r\u00e8gle de redirection de port.\r\n- **`Modifier...`** : permet de modifier la r\u00e8gle de redirection de port s\u00e9lectionn\u00e9e.\r\n\r\n \r\n\r\n- **`Supprimer`** : supprime la r\u00e8gle de redirection de port s\u00e9lectionn\u00e9e.\r\n- **`Tout Supprimer...`** : permet de supprimer toutes les r\u00e8gles de redirection de port. Il est possible de supprimer uniquement une s\u00e9lection de types de r\u00e8gle. Si une ou plusieurs r\u00e8gles posent probl\u00e8me \u00e0 la Livebox (par exemple lorsque leur nom contient des caract\u00e8res sp\u00e9ciaux) ce bouton peut permettre de revenir \u00e0 une situation saine.\r\n- **`Export...`** : permet d'exporter dans un fichier les r\u00e8gles de redirection de port d'un ou plusieurs types choisis.\r\n- **`Import...`** : permet de r\u00e9importer des r\u00e8gles de redirection de port pr\u00e9c\u00e9demment export\u00e9es dans un fichier. Si des r\u00e8gles de m\u00eame nom existent d\u00e9j\u00e0 elles seront \u00e9cras\u00e9es par celles import\u00e9es.\r\n\r\n### Redirections de protocole\r\nLa liste des r\u00e8gles de redirection de protocole, en bas, affiche les colonnes suivantes :\r\n- **A** : ic\u00f4ne indiquant si la r\u00e8gle est active ou non.\r\n- **Type** : type de la r\u00e8gle, entre IPv4 et IPv6.\r\n- **Nom** : nom de la r\u00e8gle.\r\n- **Description** : description de la r\u00e8gle.\r\n- **Protocoles** : liste des protocoles concern\u00e9s par la r\u00e8gle. \r\n- **Appareil** : appareil (ou son adresse IP) sur lequel le trafic est redirig\u00e9.\r\n- **IP Externes** : liste des adresses IPs externes concern\u00e9es par la r\u00e8gle.\r\n\r\nUn **double clic** sur une r\u00e8gle permet de facilement l'\u00e9diter.\r\n\r\n### Boutons\r\nLes boutons suivants sont propos\u00e9s pour g\u00e9rer la liste des r\u00e8gles :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit la liste des r\u00e8gles de redirection de protocole.\r\n- **`Activer/D\u00e9sactiver`** : active/d\u00e9sactive la r\u00e8gle s\u00e9lectionn\u00e9e.\r\n- **`Ajouter...`** : permet d'ajouter une r\u00e8gle de redirection de protocole.\r\n- **`Modifier...`** : permet de modifier la r\u00e8gle de redirection de protocole s\u00e9lectionn\u00e9e.\r\n\r\n \r\n\r\n- **`Supprimer`** : supprime la r\u00e8gle de redirection de protocole s\u00e9lectionn\u00e9e.\r\n- **`Tout Supprimer...`** : permet de supprimer toutes les r\u00e8gles de redirection de protocole. Il est possible de supprimer uniquement une s\u00e9lection de types de r\u00e8gle. Si une ou plusieurs r\u00e8gles posent probl\u00e8me \u00e0 la Livebox (par exemple lorsque leur nom contient des caract\u00e8res sp\u00e9ciaux) ce bouton peut permettre de revenir \u00e0 une situation saine.\r\n- **`Export...`** : permet d'exporter dans un fichier les r\u00e8gles de redirection de protocole d'un ou plusieurs types choisis.\r\n- **`Import...`** : permet de r\u00e9importer des r\u00e8gles de redirection de protocole pr\u00e9c\u00e9demment export\u00e9es dans un fichier. Si des r\u00e8gles de m\u00eame nom existent d\u00e9j\u00e0 elles seront \u00e9cras\u00e9es par celles import\u00e9es.\r\n\r\n\r\n## T\u00e9l\u00e9phone - Liste des appels t\u00e9l\u00e9phoniques / liste des contacts <a id=\"phone\"></a>\r\n\r\n\r\n\r\n### Appels t\u00e9l\u00e9phoniques\r\nLa liste des appels t\u00e9l\u00e9phoniques, sur la gauche, affiche les colonnes suivantes :\r\n- **T** : ic\u00f4ne correspondant au type de l'appel.\r\n -  : appel re\u00e7u.\r\n -  : appel manqu\u00e9. Dans ce cas toute la ligne est indiqu\u00e9e en couleur rouge.\r\n -  : appel \u00e9mis.\r\n -  : appel \u00e9mis mais non abouti.\r\n- **Heure** : date et heure de l'appel.\r\n- **Num\u00e9ro** : num\u00e9ro de t\u00e9l\u00e9phone concern\u00e9.\r\n- **Contact** : le nom du contact d\u00e9termin\u00e9 par la Livebox en fonction de la liste des contacts au moment de l'appel. Si la Livebox n'a m\u00e9moris\u00e9 aucun nom, alors le programme essai d'en trouver un dynamiquement \u00e0 partir de la liste des contacts enregistr\u00e9s par correspondance avec le num\u00e9ro de t\u00e9l\u00e9phone.\r\n- **Dur\u00e9e** : dur\u00e9e de l'appel.\r\n\r\nUn **double clic** sur un appel permet de facilement cr\u00e9er ou \u00e9diter le contact correspondant.\r\n\r\n### Boutons\r\nLes boutons suivants sont propos\u00e9s pour g\u00e9rer la liste des appels :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit la liste des appels.\r\n- **`Supprimer`** : supprime l'appel s\u00e9lectionn\u00e9.\r\n- **`Tout Supprimer...`** : supprime tous les appels.\r\n\r\n### Contacts\r\nLa liste des contacts, sur la droite, affiche les colonnes suivantes :\r\n- **Nom** : nom du contact, au format nom + pr\u00e9nom.\r\n- **Portable** : num\u00e9ro de t\u00e9l\u00e9phone portable.\r\n- **Domicile** : num\u00e9ro de t\u00e9l\u00e9phone fixe.\r\n- **Travail** : num\u00e9ro de t\u00e9l\u00e9phone professionnel.\r\n- **Sonnerie** : type de sonnerie s\u00e9lectionn\u00e9 parmi les 7 support\u00e9s par la Livebox.\r\n\r\nUn **double clic** sur un contact permet de facilement l'\u00e9diter. \r\n**Attention** : la Livebox supporte un maximum de 255 contacts.\r\n\r\n### Boutons\r\nLes boutons suivants sont propos\u00e9s pour g\u00e9rer la liste des contacts :\r\n- **`Rafra\u00eechir`** : rafra\u00eechit la liste des contacts.\r\n- **`Ajouter...`** : permet de rajouter un contact. Attention aucun test de doublon n'est effectu\u00e9.\r\n\r\n \r\n\r\n- **`Modifier...`** : pour \u00e9diter le contact s\u00e9lectionn\u00e9.\r\n- **`Supprimer`** : supprime le contact s\u00e9lectionn\u00e9.\r\n- **`Tout Supprimer...`** : supprime tous les contacts.\r\n- **`Sonnerie`** : permet de tester le t\u00e9l\u00e9phone. Sur la gauche du bouton on peut s\u00e9lectionner un des 7 types de sonnerie propos\u00e9s par la Livebox, sinon le type par d\u00e9faut est utilis\u00e9.\r\n- **`Export...`** : permet d'exporter l'ensemble des contacts dans un fichier au [format VCF](https://en.wikipedia.org/wiki/VCard). Tr\u00e8s utile pour les sauvegarder.\r\n- **`Import...`** : permet d'importer un ou plusieurs fichiers au [format VCF](https://en.wikipedia.org/wiki/VCard). Attention aucun test de doublon n'est effectu\u00e9. Si la limite du nombre de contacts maximum support\u00e9 (255) est atteint l'import est interrompu.\r\n\r\n\r\n## Actions - Boutons d'actions et de contr\u00f4le <a id=\"actions\"></a>\r\n\r\n\r\n\r\nCet onglet permet une liste d'actions par cat\u00e9gorie.\r\n\r\nLes actions concernant le **Wifi** :\r\n- **`Wifi ON`** : permet d'activer l'interface Wifi de la Livebox.\r\n- **`Wifi OFF`** : permet de d\u00e9sactiver l'interface Wifi de la Livebox.\r\n- **`Wifi Invit\u00e9 ON`** : permet d'activer l'interface Wifi invit\u00e9 de la Livebox.\r\n- **`Wifi Invit\u00e9 OFF`** : permet de d\u00e9sactiver l'interface Wifi invit\u00e9 de la Livebox.\r\n- **`Planificateur Wifi ON`** : permet d'activer le planificateur Wifi de la Livebox. Ce planificateur doit \u00eatre configur\u00e9 depuis l'interface Web de la Livebox.\r\n- **`Planificateur Wifi OFF`** : permet de d\u00e9sactiver le planificateur Wifi de la Livebox.\r\n- **`\u00c9tat Global Wifi...`** : permet d'afficher l'\u00e9tat global du Wifi, en incluant l'\u00e9tat Wifi de tous les r\u00e9p\u00e9teurs Wifi Orange potentiellement connect\u00e9s.\r\n\r\n \r\n\r\nLes actions concernant les **Red\u00e9marrages** :\r\n- **`Red\u00e9marrer la Livebox...`** : permet de forcer un red\u00e9marrage de la Livebox.\r\n- **`Historique Red\u00e9marrages...`** : permet d'afficher l'historique des derniers red\u00e9marrages.\r\n\r\n \r\n\r\n Cet historique est particuli\u00e8rement utile pour d\u00e9tecter les red\u00e9marrages forc\u00e9s par Orange pour mettre \u00e0 jour le logiciel de la Livebox.\r\n La liste affiche les colonnes suivantes :\r\n - **Date Red\u00e9marrage** : date et heure du d\u00e9marrage.\r\n - **Raison Red\u00e9marrage** : la raison de ce d\u00e9marrage. Typiquement \"NMC\" indique un d\u00e9marrage forc\u00e9 par logiciel et \"Unsupported chipset\" un red\u00e9marrage caus\u00e9 par une coupure de courant ou l'interrupteur de la Livebox.\r\n - **Date Arr\u00eat** : la date et heure de l'arr\u00eat.\r\n - **Raison Arr\u00eat** : la raison de cet arr\u00eat. Typiquement vide pour une coupure de courant, \"Upgrade\" pour une mise \u00e0 jour logiciel et \"GUI_Reboot\" pour un red\u00e9marrage demand\u00e9 depuis l'interface Web ou LiveboxMonitor.\r\n\r\nLes actions concernant le **Pare-feu** :\r\n- **`Niveaux de pare-feu...`** : permet de r\u00e9gler les niveaux des pare-feux IPv4 et IPv6.\r\n\r\n \r\n- **`R\u00e9ponses aux pings...`** : permet de r\u00e9gler les r\u00e9ponses aux requ\u00eates de ping IPv4 et IPv6.\r\n\r\n \r\n\r\nLes actions concernant les **R\u00e9glages** :\r\n- **`Pr\u00e9f\u00e9rences...`** : permet d'afficher l'\u00e9cran des pr\u00e9f\u00e9rences du programme.\r\n\r\n \r\n\r\n Voir la section **Profils*** ci-dessus pour plus de d\u00e9tail sur leur fonctionnement. \r\n \r\n Pour chaque **profil** il est possible de configurer :\r\n - `Nom` : nom du profil.\r\n - `URL Livebox` : adresse de la Livebox. La valeur par d\u00e9faut est `http://livebox.home/`.\r\n - `Utilisateur` : login pour l'ouverture de session. Par d\u00e9faut `admin`. Le mot de passe est demand\u00e9 automatiquement lors de l'utilisation du profil s'il n'est pas renseign\u00e9 ou s'il est erron\u00e9.\r\n - `Filtrage Appareils` : active le filtrage des appareils afin de ne pas montrer certains appareils \"fant\u00f4mes\" d\u00e9tect\u00e9s par la Livebox. Quand ce param\u00e8tre est activ\u00e9 le programme affiche les m\u00eames appareils que l'interface Web de la Livebox. Ce param\u00e8tre est activ\u00e9 par d\u00e9faut.\r\n - `Fichier Table MacAddr` : nom du fichier de stockage des noms d'appareils. Par d\u00e9faut `MacAddrTable.txt`. Voire `Le fichier MacAddrTable.txt` de la section `Configuration` pour plus d'explications.\r\n - `D\u00e9faut` : indique qu'il s'agit du profil par d\u00e9faut \u00e0 utiliser au lancement du programme. Il ne peut y avoir qu'un seul profil par d\u00e9faut. \r\n\r\n Les **pr\u00e9f\u00e9rences** g\u00e9n\u00e9rales permettent de r\u00e9gler :\r\n - `Langage` : langue utilis\u00e9e par l'application, \u00e0 choisir entre Fran\u00e7ais (d\u00e9faut) et Anglais.\r\n - `Tooltips` : active ou non les tooltips.\r\n - `Fr\u00e9quence Stats` : Fr\u00e9quence de rafra\u00eechissement, en secondes, de toutes les statistiques. Par d\u00e9faut 3 secondes.\r\n - `API Key macaddress.io` : le programme utilise l'API du site [macaddress.io](https://macaddress.io/) pour d\u00e9terminer le fabricant d'un appareil \u00e0 partir de son adresse MAC (champ **Fabricant** dans les informations d\u00e9taill\u00e9es par appareil). C'est un service gratuit, mais il faut cr\u00e9er un compte et indiquer ici l'API Key correspondante pour b\u00e9n\u00e9ficier de cette fonctionnalit\u00e9.\r\n - `Indicatif T\u00e9l\u00e9phonique` : indicatif t\u00e9l\u00e9phonique local, utile pour faire correspondre les appels t\u00e9l\u00e9phoniques avec les num\u00e9ros de contacts. Par d\u00e9faut le code de la France est utilis\u00e9, c'est-\u00e0-dire 33.\r\n - `Hauteur Ent\u00eates` : hauteur en pixels des ent\u00eates de liste, par d\u00e9faut 25.\r\n - `Taille Police Ent\u00eates` : taille de la police de caract\u00e8res des ent\u00eates de liste. Une valeur \u00e0 z\u00e9ro signifie d'utiliser la taille syst\u00e8me. Par d\u00e9faut ce param\u00e8tre est \u00e0 z\u00e9ro.\r\n - `Hauteur Lignes` : hauteur en pixels des lignes de liste, par d\u00e9faut 30.\r\n - `Taille Police Lignes` : taille de la police de caract\u00e8res des lignes de liste. Une valeur \u00e0 z\u00e9ro signifie d'utiliser la taille syst\u00e8me. Par d\u00e9faut ce param\u00e8tre est \u00e0 z\u00e9ro.\r\n - `Statistiques temps r\u00e9el des appareils wifi` : active ou non les statistiques en temps r\u00e9el pour les appareils wifi. Celles ci s'affichent en bleu dans l'onglet `Appareils` et viennent recouvrir les statistiques standards qui s'affichent en noir toutes les 30 secondes.\r\n - `Utiliser le style d'interface graphique natif` : par d\u00e9faut le style \"Fusion\" est utilis\u00e9 sur toutes les plateformes. Cette option permet sur les plateformes Windows et MacOS d'utiliser un style graphique plus natif. Cette option n'a aucun effet sur les plateformes Linux. \r\n\r\n- **`Changer de profil...`** : affiche un dialogue permettant de changer le profil en cours et de relancer le programme.\r\n\r\n- **`R\u00e9glages Email...`** : permet de configurer l'envoi d'emails automatique, par exemple pour les notifications.\r\n\r\n \r\n \r\n Il est possible de configurer :\r\n - `Adresse Origine` : adresse email d'origine des messages.\r\n - `Adresse Destination` : adresse email de destination des messages.\r\n - `Pr\u00e9fixe Sujet` : pr\u00e9fixe rajout\u00e9 aux sujets des messages envoy\u00e9s.\r\n - `Serveur SMTP` : serveur SMTP de votre fournisseur de messagerie.\r\n - `Port` : port SMTP \u00e0 utiliser. 465 est recommand\u00e9 pour SSL, 587 pour tout autre protocole.\r\n - `Utiliser TLS` : utilisation du protocole d'encryption TLS (recommand\u00e9).\r\n - `Utiliser SSL` : utilisation du protocole d'encryption SSL.\r\n - `Authentification` : \u00e0 s\u00e9lectionner si le serveur n\u00e9cessite de s'authentifier.\r\n - `Utilisateur` : votre nom d'utilisateur pour s'authentifier.\r\n - `Mot de passe` : votre mot de passe pour s'authentifier. \r\n\r\n Le bouton `Test Envoi` permet d'envoyer un message de test avec les r\u00e9glages courants sans les sauvegarder. \r\n\r\n La configuration pour le serveur d'Orange est tr\u00e8s simple :\r\n - Adresse origine / utilisateur -> mettre votre adresse@orange.fr\r\n - Adresse destination -> la destination souhait\u00e9e\r\n - Serveur SMTP -> smtp.orange.fr\r\n - Port -> 587\r\n - Cocher \"Utiliser TLS\" et \"Authentification\".\r\n - Mot de passe -> votre mot de passe Orange. \r\n\r\n Pour gmail c'est un peu plus compliqu\u00e9 :\r\n - Il faut d'abord r\u00e9gler son compte gmail pour cr\u00e9er un mot de passe d\u00e9di\u00e9 pour le programme.\r\n - Aller sur son compte, onglet \"S\u00e9curit\u00e9\" -> [ici](https://myaccount.google.com/security)\r\n - V\u00e9rifier que la \"validation en deux \u00e9tapes\" est activ\u00e9e, si ce n'est pas le cas, il faut le faire.\r\n - Cliquer \"Validation en deux \u00e9tapes\" et aller sur \"Mots de passe d'application\" en bas.\r\n - Cr\u00e9er un nouveau mot de passe pour l'application 'LiveboxMonitor' et notez le mot de passe (sans les espaces).\r\n - Retourner dans LiveboxMonitor, r\u00e9glage email.\r\n - Dans les champs Adresse origine / utilisateur -> mettre votre adresse@gmail.com\r\n - Adresse destination -> la destination souhait\u00e9e\r\n - Serveur SMTP -> smtp.gmail.com\r\n - Port -> 587\r\n - Cocher \"Utiliser TLS\" et \"Authentification\"\r\n - Mot de passe -> le mot de passe cr\u00e9\u00e9 ci dessus. \r\n\r\nLes actions techniques de **D\u00e9bogage** :\r\n- **`JSON Liste Appareils...`** : permet d'afficher la r\u00e9ponse brute JSON de la Livebox concernant la liste des appareils connus. Utile pour avoir plus d'informations ou pour le d\u00e9bogage.\r\n- **`JSON Topologie...`** : permet d'afficher la r\u00e9ponse brute JSON de la Livebox concernant la topologie de connexion des appareils connus. Utile pour avoir plus d'informations ou pour le d\u00e9bogage.\r\n- **`Niveau de log...`** : permet de changer le niveau de logs dans la console. Ce niveau est stock\u00e9 dans la configuration du programme et sera donc conserv\u00e9 au prochain lancement du programme.\r\n- **`G\u00e9n\u00e9rer documentation APIs...`** : permet de g\u00e9n\u00e9rer dans des fichiers texte l'ensemble de la documentation accessible sur les APIs de la Livebox, par module. Le programme g\u00e9n\u00e8re un fichier par module connu, un fichier \"_ALL_MODULES_\" contenant l'ensemble des modules en un seul fichier, et un fichier \"_PROCESSES_\" qui permet d'avoir la liste des t\u00e2ches tournant sur la Livebox. Certains fichiers ne contiennent qu'une erreur \"Permission denied\" : c'est normal, ces modules sont prot\u00e9g\u00e9s et donc non accessibles (mais qui sait dans une prochaine version du firmeware ?). Les param\u00e8tres de fonction indiqu\u00e9s entre parenth\u00e8ses sont optionnels. Par d\u00e9faut le programme g\u00e9n\u00e8re l'ensemble des instances trouv\u00e9es par type de ressources (ou \"object\") ainsi que toutes les valeurs trouv\u00e9es par param\u00e8tres, mais ces valeurs sont filtr\u00e9es si on maintient la touche `Ctrl` en cliquant sur le bouton. Cela permet de partager librement ces fichiers sans divulguer d'informations sp\u00e9cifiques \u00e0 sa configuration, cependant avoir la liste des instances reste crucial pour une documentation vraiment compl\u00e8te. \r\n\r\nAutres actions :\r\n- **Quitter l'application** : pour quitter l'application. Strictement \u00e9quivalent \u00e0 fermer la fen\u00eatre de l'application.\r\n- Un clic sur le lien GitHub de l'application ouvrira la page correspondante sur votre navigateur.\r\n\r\n\r\n## Onglets r\u00e9p\u00e9teurs Wifi <a id=\"repeaters\"></a>\r\n\r\n\r\n\r\nLe programme cr\u00e9\u00e9 dynamiquement un onglet par r\u00e9p\u00e9teur connect\u00e9. Si le r\u00e9p\u00e9teur a un nom local, celui-ci est utilis\u00e9 dans l'onglet, sinon le nom par d\u00e9faut est de type \"RW #\" suivit du num\u00e9ro de r\u00e9p\u00e9teur dans l'ordre de d\u00e9tection.\r\nLes r\u00e9p\u00e9teurs font aussi parti des appareils connus, ils sont donc visibles dans l'onglet `Appareils` et leur nom peut \u00eatre chang\u00e9 via le bouton `Assigner Nom...` de l'onglet `Infos Appareil`.\r\n\r\nUne ic\u00f4ne dans le nom de l'onglet permet de conna\u00eetre l'\u00e9tat de la connexion avec le r\u00e9p\u00e9teur :\r\n-  : le r\u00e9p\u00e9teur est inactif ou n'a pas d'adresse IP attribu\u00e9e.\r\n-  : le r\u00e9p\u00e9teur est actif mais aucune session n'est ouverte. Si cet \u00e9tat subsiste vous pouvez essayer de forcer la cr\u00e9ation d'une session en cliquant sur le bouton `R\u00e9authentifier...`.\r\n-  : le r\u00e9p\u00e9teur est actif et une session a \u00e9t\u00e9 cr\u00e9\u00e9e pour communiquer avec lui.\r\n\r\nLes statistiques de trafic par interface sont affich\u00e9es sous forme de liste en haut \u00e0 gauche.\r\nEt toutes les informations d\u00e9taill\u00e9es sont accessibles via la barre de boutons en bas, chaque bouton remplissant la liste d'attributs sur la droite. Il est aussi possible d'exporter l'ensemble des informations dans un fichier. Enfin, une s\u00e9rie d'actions est possible via les boutons sur la gauche.\r\n\r\n### Statistiques\r\n\r\nListe permettant de surveiller l'\u00e9tat du trafic g\u00e9r\u00e9 par le r\u00e9p\u00e9teur :\r\n- **Nom** : nom de l'interface r\u00e9seau. `LAN` concerne tout le trafic entre le r\u00e9p\u00e9teur et la Livebox. Ensuite on dispose des statistiques par interface pr\u00e9cise (les deux prises Ethernet ainsi que les deux bandes Wifi).\r\n- **Rx** : nombre d'octets re\u00e7us par l'interface. La fen\u00eatre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont d\u00e9tect\u00e9es. Attention ce compteur est circulaire et ne d\u00e9passe pas les 4 Go.\r\n- **Tx** : nombre d'octets envoy\u00e9s par l'interface. La fen\u00eatre de temps de ce total n'est pas connue. S'affiche en rouge si des erreurs de transmission sont d\u00e9tect\u00e9es. Attention ce compteur est circulaire et ne d\u00e9passe pas les 4 Go.\r\n- **TauxRx** : taux d'octets re\u00e7us par seconde par l'interface dans les trois derni\u00e8res secondes (fr\u00e9quence r\u00e9glable dans les pr\u00e9f\u00e9rences).\r\n- **TauxTx** : taux d'octets envoy\u00e9s par seconde par l'interface dans les trois derni\u00e8res secondes (fr\u00e9quence r\u00e9glable dans les pr\u00e9f\u00e9rences).\r\n\r\nSi une statistique s'affiche en rouge cela signifie que des erreurs de transfert ont \u00e9t\u00e9 d\u00e9tect\u00e9es par le r\u00e9p\u00e9teur.\r\nLes statistiques semblent parfois surprenantes, mais il s'agit d'une interpr\u00e9tation sans filtre de ce que renvoie le r\u00e9p\u00e9teur (il ne s'agit pas d'un d\u00e9faut du programme).\r\n\r\n### Actions - Boutons d'actions et de contr\u00f4le\r\n\r\nLes actions concernant le **Wifi** :\r\n- **`Wifi ON`** : permet d'activer l'interface Wifi du r\u00e9p\u00e9teur.\r\n- **`Wifi OFF`** : permet de d\u00e9sactiver l'interface Wifi du r\u00e9p\u00e9teur.\r\n- **`Planificateur Wifi ON`** : permet d'activer le planificateur Wifi du r\u00e9p\u00e9teur. Ce planificateur doit \u00eatre configur\u00e9 depuis l'interface Web du r\u00e9p\u00e9teur.\r\n- **`Planificateur Wifi OFF`** : permet de d\u00e9sactiver le planificateur Wifi du r\u00e9p\u00e9teur.\r\n\r\nL'\u00e9tat global du Wifi peut \u00eatre consult\u00e9 via le bouton `\u00c9tat Global Wifi...` de l'onglet `Actions`.\r\n\r\nLes actions concernant les **Red\u00e9marrages** :\r\n- **`Red\u00e9marrer le R\u00e9p\u00e9teur...`** : permet de forcer un red\u00e9marrage du r\u00e9p\u00e9teur.\r\n- **`Historique Red\u00e9marrages...`** : permet d'afficher l'historique des derniers red\u00e9marrages.\r\n\r\n \r\n\r\n Cet historique est particuli\u00e8rement utile pour d\u00e9tecter les red\u00e9marrages forc\u00e9s par Orange pour mettre \u00e0 jour le logiciel du r\u00e9p\u00e9teur.\r\n La liste affiche les colonnes suivantes :\r\n - **Date Red\u00e9marrage** : date et heure du d\u00e9marrage.\r\n - **Raison Red\u00e9marrage** : la raison de ce d\u00e9marrage. Typiquement \"NMC\" ou \"POR\" indique un d\u00e9marrage forc\u00e9 par logiciel et \"Unsupported chipset\" un red\u00e9marrage caus\u00e9 par une coupure de courant ou l'interrupteur du r\u00e9p\u00e9teur.\r\n - **Date Arr\u00eat** : la date et heure de l'extinction.\r\n - **Raison Arr\u00eat** : la raison de cette extinction. Typiquement vide pour une coupure de courant, \"Upgrade\" pour une mise \u00e0 jour logiciel et \"WebUI reboot\" pour un red\u00e9marrage demand\u00e9 depuis l'interface Web ou LiveboxMonitor.\r\n\r\nLes actions diverses :\r\n- **R\u00e9authentifier...** : pour forcer la cr\u00e9ation d'une nouvelle session avec le r\u00e9p\u00e9teur. Si vous laissez trop longtemps le programme tourner sans visualiser les statistiques du r\u00e9p\u00e9teur ni effectuer la moindre action, la session sera automatiquement lib\u00e9r\u00e9e par le r\u00e9p\u00e9teur. Dans ce cas des erreurs vont se produire en effectuant des actions : ce bouton permettra de recr\u00e9er la session, permettant de reprendre les actions sans erreur.\r\n\r\n### Boutons\r\nLes onglets de r\u00e9p\u00e9teur Wifi proposent les boutons suivants :\r\n- **`Informations R\u00e9p\u00e9teur`** : affiche les informations principales concernant le r\u00e9p\u00e9teur, telles que les versions de logiciels, le nom du mod\u00e8le, l'heure de l'horloge interne, etc.\r\n- **`Informations Wifi`** : affiche les informations g\u00e9n\u00e9rales sur la connectivit\u00e9 Wifi, et l'\u00e9tat de chaque acc\u00e8s. Pour chaque acc\u00e8s on dispose d'informations d\u00e9taill\u00e9es telles que le canal, le standard, la bande passante, la qualit\u00e9, la bande, le nombre d'appareils connect\u00e9s, etc.\r\n- **`Informations LAN`** : affiche les informations g\u00e9n\u00e9rales sur la connectivit\u00e9 LAN. Pour chaque interface Ethernet on peut identifier si elle est active ou non, la bande passante, etc.\r\n- **`Export...`** : permet d'exporter l'ensemble des informations affich\u00e9es par chacun des boutons dans un fichier texte. Utile pour communiquer ces informations ou faire un suivi pour d\u00e9tecter les changements.\r\n\r\n\r\n## Gestion et personnalisation des ic\u00f4nes d'appareil <a id=\"icons\"></a>\r\n\r\nToutes les ic\u00f4nes d'appareil sont initialement stock\u00e9es par la Livebox et le programme va les chercher une \u00e0 une, ce qui peut provoquer une certaine latence (par exemple lorsque l'on clique une premi\u00e8re fois sur le bouton `Assigner Type...` pour changer le type d'un appareil).\r\nPour \u00e9viter cette latence, le programme stocke dans un cache local toutes les ic\u00f4nes t\u00e9l\u00e9charg\u00e9es de la Livebox pour pouvoir les retrouver plus rapidement au prochain lancement. Ce cache est contenu dans un r\u00e9pertoire appel\u00e9 `lbcache_` suivie de la version du firmware de la Livebox (ce qui fait que plusieurs caches peuvent \u00eatre maintenu si vous acc\u00e9dez \u00e0 plusieurs Livebox de versions diff\u00e9rentes).\r\nCe r\u00e9pertoire est cr\u00e9\u00e9 automatiquement dans [le r\u00e9pertoire de configuration du programme](#configuration).\r\n\r\nIl est aussi possible de modifier ces ic\u00f4nes, et aussi de cr\u00e9er de nouveaux types d'appareils avec leur propre ic\u00f4ne.\r\nUne page d'explication d\u00e9di\u00e9e \u00e0 ces possibilit\u00e9s est disponible [ici](https://github.com/p-dor/LiveboxMonitor/blob/main/docs/CustomIcons.md).\r\n\r\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2022-24 Pierre Dor Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "Advanced graphical user interface to control a Livebox 4, 5, 6 or 7",
"version": "1.4.8",
"project_urls": {
"changelog": "https://github.com/p-dor/LiveboxMonitor/releases",
"documentation": "https://p-dor.github.io/LiveboxMonitor",
"homepage": "https://github.com/p-dor/LiveboxMonitor",
"issues": "https://github.com/p-dor/LiveboxMonitor/issues",
"source": "https://github.com/p-dor/LiveboxMonitor"
},
"split_keywords": [
"livebox",
" sysbus",
" ui",
" monitoring",
" traffic"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c1038edd52f0bb186e871b38b0bc26d13caa4c5387398a882b2f52362a0053fd",
"md5": "d97aee562cc6e17c0647c5625d7b7cfa",
"sha256": "9987049d3220b18ded08c151fca38a0c058fe0c8df316919a53484c7c3cf7516"
},
"downloads": -1,
"filename": "LiveboxMonitor-1.4.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d97aee562cc6e17c0647c5625d7b7cfa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 182084,
"upload_time": "2024-07-06T15:29:17",
"upload_time_iso_8601": "2024-07-06T15:29:17.800206Z",
"url": "https://files.pythonhosted.org/packages/c1/03/8edd52f0bb186e871b38b0bc26d13caa4c5387398a882b2f52362a0053fd/LiveboxMonitor-1.4.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bfc9d325558c87e80ea26e046e9fd2e331e028ff0a51c51ec9f4359dae9c284f",
"md5": "a91b132bc9413c107f3893c874754ed6",
"sha256": "efd0218185397bfcb92ca3a1869ce09e809a1288f0361787e1a48ea6041cd04e"
},
"downloads": -1,
"filename": "liveboxmonitor-1.4.8.tar.gz",
"has_sig": false,
"md5_digest": "a91b132bc9413c107f3893c874754ed6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 206875,
"upload_time": "2024-07-06T15:29:19",
"upload_time_iso_8601": "2024-07-06T15:29:19.578733Z",
"url": "https://files.pythonhosted.org/packages/bf/c9/d325558c87e80ea26e046e9fd2e331e028ff0a51c51ec9f4359dae9c284f/liveboxmonitor-1.4.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-06 15:29:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "p-dor",
"github_project": "LiveboxMonitor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "PyQt6",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "python-dateutil",
"specs": []
},
{
"name": "cryptography",
"specs": []
},
{
"name": "pyqtgraph",
"specs": []
}
],
"lcname": "liveboxmonitor"
}
