A Python script to help you select the movies you want to record with your Freebox
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
djib 4965e64627 Fix bad key name in config.template.json 3 years ago
pyfbx@69ae89806d Fetch the list of available Channels from the Freebox API 3 years ago
.gitignore Display all movies with rating and summary 3 years ago
.gitmodules Fetch the list of available Channels from the Freebox API 3 years ago
FreeboxMoviePlanner.py Speed improvement when creating Fbx object 3 years ago
Pipfile Added Pipenv 3 years ago
Pipfile.lock Added Pipenv 3 years ago
Readme.md Fix Freebox version 3 years ago
config.template.json Fix bad key name in config.template.json 3 years ago
screenshot.png Add screenshot 3 years ago

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.

FreeboxMoviePlanner en action

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.