kmmndr / reboot-fbx

Reboot Freebox
GNU General Public License v3.0
4 stars 3 forks source link
api bash curl freebox jq

reboot-fbx

This script will reboot the modem of the french isp Free.

Ce script sert à redémarrer la freebox.

Elements requis

Il faut être client Free et posséder une Freebox compatible. Il a été testé avec la freebox mini 4k.

Le programme nécéssite les applications suivantes:

Installation

Un fichier Makefile permet d'installer rapidement l'outil. Par défaut, l'installation s'effectue avec le prefixe /usr/local/. Il est possible de modifier ce comportement en renseignant la variable d'environnement PREFIX.

# installation par defaut dans /usr/local/bin/reboot-fbx
make install

# installation dans ~/.local/bin/reboot-fbx
make -e PREFIX=~/.local install

Utilisation

L'utilisation est très simple, il suffit de démarrer une première fois le programme, d'aller appuyer sur les boutons de la freebox pour autoriser l'application à y accéder.

Le premier démarrage s'arrêtera là en indiquant un message d'erreur mentionnant que les permissions sont insuffisantes.

$ reboot-fbx
reboot-fbx
api_version: 6.0
waiting............
Error: You must grant reboot permission

Ensuite, aller dans l'interface de configuration mafreebox, dans la rubrique Paramètre de la Freebox>Gestion des accès, puis dans l'onglet Applications et ajouter à l'application la permission Modification des réglages de la Freebox.

Les prochains démarrages du programme redémarreront la Freebox.

$ reboot-fbx
api_version: 6.0
waiting.
Reboot initiated

Par défaut, la configuration est enregistrée dans le fichier ~/reboot-fbx.conf, dans le dossier utilisateur. Il est possible de changer ce comportement en renseignant la variable d'environnement CONFIG.

Connexion https

Il est désormais possible de se connecter à la Freebox via une connection https. Pour utiliser ce protocole, il suffira de définir une variable d'environnement FREEBOX_BASE_URL comme ci-dessous. Ce comportement sera peut-être adopté par défaut lors d'une prochaine version.

env FREEBOX_BASE_URL=https://mafreebox.freebox.fr reboot-fbx

Puisqu'il s'agit d'un certificat auto-signé, il sera enregistré dans ~/.reboot-fbx.cert lors de la première connexion. Ce fichier servira de référence pour les prochaines connexions.