A Python script to help you select the movies you want to record with your Freebox

Go to file

djib e637100d79 Fix Freebox version		2019-10-15 10:43:45 +02:00
pyfbx@69ae89806d	Fetch the list of available Channels from the Freebox API	2019-10-08 23:32:04 +02:00
.gitignore	Display all movies with rating and summary	2019-09-24 00:10:50 +02:00
.gitmodules	Fetch the list of available Channels from the Freebox API	2019-10-08 23:32:04 +02:00
FreeboxMoviePlanner.py	Speed improvement when creating Fbx object	2019-10-15 02:40:45 +02:00
Pipfile	Added Pipenv	2019-10-15 00:50:37 +02:00
Pipfile.lock	Added Pipenv	2019-10-15 00:50:37 +02:00
Readme.md	Fix Freebox version	2019-10-15 10:43:45 +02:00
config.template.json	Update config.template.json	2019-10-15 10:17:22 +02:00
screenshot.png	Add screenshot	2019-10-15 01:01:04 +02:00

Readme.md

FreeboxMoviePlanner

A few words in English

A Python script to help you select the movies you want to record with your Freebox, provided by Free, a french ISP. As such, the rest of this Readme will be in French.

Introduction

FreeMoviePlanner est un outil qui vous facilite la plannification d'enregistrements avec votre Freebox.

Concrètement, l'outil effectue les opérations suivantes :

Récupérer les film de la semaine à partir du planning Télé 7 Jours
Retirer les chaînes auxquelles vous n'avez pas accès
Trouver les notes des films sur TMDb (The Movie Database)
Exclure les films en dessous d'une certaine note (paramétrable)
Afficher les résumés des films et vous demander de sélectionner ceux qui vous intéressent.
Planifier les enregistrements sur votre Freebox.
Vous prévenir si des conflits sont identifiés pour que vous les résolviez depuis l'interface de votre Freebox.

Installation

Pour utiliser FreeboxMoviePlanner il vous faut Python, ainsi que les 3 packages suivants (à installer par exemple avec pip install [nom du packet] :

beautifulsoup4
tmdbsimple
zeroconf

Il vous faut ensuite récupérer FreeboxMoviePlanner. Le plus simple étant en clonant le dépôt git.

Ensuite, il vous faut créer un fichier de conf config.json. Vous pouvez copier-coller config.template.json et l'adapter à vos besoins. Vous pourrez y renseigner la marge avant et après chaque enregistrement, ou la note en dessous de laquelle les films ne s'afficheront pas.

Pour pouvoir récupérer les notes sur TMDb, vous aurez besoin d'ouvrir un compte sur leur site et de demander une clef API, à renseigner dans le fichier de config.

Enfin, il vous faudra obtenir un token d'authentification après de votre Freebox pour que le programme puisse s'y connecter. Pour ce faire, dans un shell Python, tapez les commandes suivantes :

from pyfbx import Fbx
f=Fbx()
f.register("FreeboxMoviePlanner", "FreeboxMoviePlanner", "N'importe quoi qui identifie votre PC")

Pour que la commande d'import fonctionne, vous devez lancer le shell Python depuis le répertoire pyfbx de l'outil.

L'affichage de votre boîtier Freebox vous demandera alors de valider cette demande d'authentification. Vous devez donc physiquement valider l'accès à partir de votre box (sur la V6, il s'agit de presser la flèche de droite).
Une fois cette accès validé, notez précieusement le résultat qui s'affiche dans le shell Python (un chaine de 64 caractères). Cette chaine est à inscrire dans votre fichier de configuration au paramètre "pyfbx-session-token".

L'installation et le paramétrage devraient être terminés.

Exécution

Pour lancer le programme, exécuter simplement: python3 FreeboxMoviePlanner.py. Sous Linux, vous devriez aussi pouvoir double-cliquer sur le fichier pour l'exécuter.

L'outil devrait vous afficher rapidement le petit texte Working the magic, please wait… puis, après environ une minute (ou plus si votre réseau est lent), le détail des films.