freebox-tools utilise l’API de Freeboxos disponible sur la plupart des boxes de l’opérateur français free.
Introduction
Certaines versions de la Freebox proposent une interface web (accessible avec http://mafreebox.freebox.fr) permettant de contrôler presque toutes les fonctionnalités de la box.
L’usage le plus simple que l’on peut faire avec ce type de script est comme le propose l’article cité de redémarrer via la ligne de commande.
La dernière version est disponible ici.
- Le code source,
- La documentation,
- Télécharger la dernière version complète disponible (fichier
freebox-tools-YYYY-MM-DD.tar.gz
) ,
L’installation se fait l’aide de :
tar -zxf freebox-tools-*.tar.gz
cd freebox-tools/
sudo ./freebox-tools-install.sh
Que permet de faire cet outil ?
Après avoir effectué l’appairage avec votre Freebox voici une liste non exhaustive des fonctionnalités disponibles :
- Redémarrer votre Freebox :
freebox --restart
- Redémarrer vos boîtiers CPL (Freeplug, mais aussi Netgear et autre) :
freebox-reset-plugs
- Voir rapidement l’état de votre connexion :
freebox --connection # Résultat au format JSON
freebox --connection-text # Affichage alternatif
- Jouer avec le cadran de la Freebox :
freebox-lcd --help
- Changer la configuration du contrôle parental :
freebox-internet-access --list
- Accéder à toute la configuration de votre Freebox, dans la mesure où cela est disponible sur l’API de Freeboxos (Attention documentation en anglais uniquement) et faire vos propres commandes adaptés à vos besoins.
freebox --help
Les commandes vers votre Freebox sont disponibles depuis votre réseau local, comme depuis internet. La configuration initiale devra se obligatoire se faire depuis le réseau de votre Freebox.
Compatibilité avec les autres systèmes
Linux classiques
Aucun souci, freebox-tools est prévu pour les environnements de type Linux-Mint, Ubuntu, Raspberry Pi OS…
L’installation intégrée utilisation yum
ou apt-get
pour installer les dépendances requises.
Windows
Le script devrait tourner sous Windows sous certaines conditions précisées dans le fichier README.md.
Linux embarqués
Les Linux embarqués sont souvent minimalistes, vous aurez peut-être besoin d’ajouter les paquets bash
, curl
et jq
.
-
Des pistes pour les Linux embarqués
Pour
bash
etjq
, vous pouvez télécharger les binaires depuis http://ftp-archive.freebsd.org/pub/FreeBSD-Archive/ports/.Par exemple :
wget http://ftp-archive.freebsd.org/pub/FreeBSD-Archive/ports/i386/packages-8.2-release/ftp/curl-7.21.3.tbz wget ftp://ftp.beastie.tdk.net/pub/FreeBSD/ports/i386/packages-8.2-release/shells/bash-4.1.9.tbz
Et ensuite :
cd / tar -xzf DOWNLOAD_PATH/curl-7.21.3.tbz tar -xzf DOWNLOAD_PATH/bash-4.1.9.tbz
Vous devez adapter l’URL à votre architecture cible ainsi qu’a la version de Linux.
Pour
jq
vous devrez utiliser :
Difficile de vous donner une solution clé en main, puisque cela dépendra de votre cible qui est par définition ésotérique 😄
Références
- Également inspiré de freeboxos-bash-api
ᦿ