56 lines
2.9 KiB
Markdown
56 lines
2.9 KiB
Markdown
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*](https://www.programme-television.org/?bouquet=free)
|
||
* Retirer les chaînes auxquelles vous n'avez pas accès
|
||
* Trouver les notes des films sur [*TMDb*](https://www.themoviedb.org/) (*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
|
||
---
|
||
### À partir de l'exécutable
|
||
[Téléchargez](https://djib.fr/djib/FreeboxMoviePlanner/releases) le fichier qui correspond à votre système d'exploitation (Linux ou Windows) dans le répertoire `dist` ainsi que le fichier `config.template.json`.
|
||
|
||
### À partir des sources
|
||
Pour utiliser **FreeboxMoviePlanner** à partir des sources, 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 le code du projet, le plus simple étant en clonant le dépôt git.
|
||
```bash
|
||
git clone --recurse-submodules https://djib.fr/djib/FreeboxMoviePlanner.git
|
||
```
|
||
|
||
Configuration
|
||
---
|
||
Ensuite, il vous faut créer un fichier de conf `config.json`. Vous pouvez tout simplement renommer le fichier `config.template.json`.
|
||
|
||
Dans ce fichier vous devrez renseigner une clef API TMDb. Pour cela vous aurez besoin d'ouvrir un compte sur leur site et de [demander une clef API](https://www.themoviedb.org/settings/api).
|
||
|
||
Le fichier de config vous permet aussi de configurer la marge avant et après chaque enregistrement, ou la note en dessous de laquelle les films ne s'afficheront pas.
|
||
|
||
Exécution
|
||
---
|
||
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.
|
||
|
||
À la première exécution, l'outil vous demandera aussi d'autoriser le script sur votre Freebox (*Please go to your Freebox and accept the authentication.*)
|
||
À ce moment, 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).
|