Cette article est la compilation de nombreux de mes articles qui traitaient d’un bout du sujet

Les manipulation décrites ont été testé sur mon Dockstar mais peuvent être adaptées sans grand efforts sur tout autre machine Linux.

Cette article met en œuvre différentes briques logiciels et différents scripts :

• Flexget : Surveille un flux RSS listant la disponibilité des épisodes de série, si la série est configurée, télécharge le fichier .torrent correspondant et le place dans un répertoire surveillé par Transmission
• Transmission : télécharge la série via le protocole P2P bittorent
• Scripts Transmission : un ensemble de scripts qui limitent la bande passante dès lors qu’un PC du LAN est allumé (pour ne pas perturber la navigation sur Internet), déplacent le fichier vidéo de la série dans une répertoire particulier dès lors que le téléchargement par Transmission est terminé (et que le ratio de partage est atteint)
• Periscope : Scrute à intervalle régulier le répertoire où sont placé les téléchargements terminés et cherche sur divers sites la disponibilité de sous-titres, auquel cas le fichier de sous titre est téléchargé et renommé automatiquement avec le même nom que le fichier vidéo
• Script de rangement : ce script scrute à son tour le répertoire où sont placé les téléchargements terminés et si sont présents à la fois le fichier vidéo et le fichier de sous-titre il les déplace dans un répertoire où la série peut être visionné (répertoire accessible par un HTPC ou par une Freebox)

Enfin avertissement d’usage : Télécharger c’est mal, cet article est une démonstration des possibilités de Linux et non pas une incitation à commettre un crime…

Flexget : téléchargement des fichiers torrent à partir d’un flux RSS

Installation

Dépendances : Flexget est un programme python distribué sous la forme d’un paquet egg installable via la commande easy_install du paquet python-setuptools :

sudo aptitude install python2.6 python-setuptools

(Cette installation est assez gourmande en espace disque presque 17Mo sur mon Dockstar)

Comme indiqué l’installation de Flexget est ensuite simple car packagé sous la forme d’un egg :

sudo easy_install flexget

Les paquets egg s’assurent de l’installation des dépendance (en terme de librairies Python). Lors de l’installation de PyYAML j’ai eu cette erreur qui ne semble pas avoir de conséquences :

libyaml is not found or a compiler error: forcing --without-libyaml
(if libyaml is installed correctly, you may need to
specify the option --include-dirs or uncomment and
modify the parameter include_dirs in setup.cfg)
zip_safe flag not set; analyzing archive contents...
Adding PyYAML 3.09 to easy-install.pth file

Configuration

Par défaut Flexget va chercher sa configuration dans un fichier config.yml dans un répertoire .flexget du répertoire  home de l’utilisateur le lançant, on créé donc ce fichier :

mkdir ~/.flexget
cd ~/.flexget
touch config.yml

Vient ensuite la configuration proprement dite de Flexget et partie la plus compliquée (enfin le temps de comprendre la syntaxe de la configuration Flexget).

Pour vous aider vous pouvez :

• lire le paragraphe Configuration de mon article Téléchargement automatisé de séries avec Flexget
• lire, parcourir, étudier le site de Flexget et plus particulièrement les pages series, How to configure settings per series, How to configure settings with groups et series cookbook
• vous inspirer du squelette de mon fichier qui fonctionne parfaitement (l’envoi de mail se fait en utilisant le serveur SMTP de Free qui ne nécessite pas d’authentification si c’est votre FAI)

presets:
  global:
    email:
      from: adresse@free.fr
      to:
        - adresse@free.fr
      smtp_host: smtp.free.fr
feeds:
  Series_torrent:
    rss: http://showrss.karmorra.info/xxx
    series:
       settings:
         hdtv:
           timeframe: 3 hours
           quality: hdtv
         720p:
           timeframe: 3 hours
           quality: 720p
       hdtv:
         - Nom série 1
         - Nom série 2
       720p:
         - Nom série téléchargée en HD
    download: /data/downloads/torrents/watch/

Transmission : téléchargement de la série

Flexget télécharge le fichier .torrent correspondant à un épisode de série, Transmission se charge de télécharger l’épisode.

Installation

sudo aptitude install transmission-daemon transmission-cli

(place occupé sur mon système : 1 692 ko)

Le paquet transmission-cli n’est utile que pour les scripts périphériques à Transmission (déplacement des torrents terminés, économie de bande passante)

Pour ma configuration j’utilise l’arborescence de répertoire suivante :

download/
    torrents/
        complete/
        downloading/
        seeding/
        watch/

• watch : répertoire configuré dans Flexget dans lequel les fichiers .torrent vont être déposés, Transmission est configuré pour surveiller ce répertoire et démarrer automatiquement le téléchargement correspondant
• downloading : répertoire ou sont situés les fichiers en cours de téléchargement (fichier avec une extension part pour partial)
• seeding : fichier complet mais pour lesquels le ratio de partage n’a pas encore été atteint
• complete : répertoire où sont déposés in-fine les fichiers complétement téléchargés (et ayant atteint le bon ratio de partage). Ce répertoire est ensuite scruté pour la recherche des sous-titres

Changement de l’utilisateur démarrant Transmission (optionnel)

Stopper Transmission :

sudo /etc/init.d/transmission-daemon stop

Éditer le fichier default du script d’init :

sudo vim /etc/default/transmission-daemon

Mettre la ligne OPTIONS en commentaire :

#OPTIONS="--config-dir $CONFIG_DIR"

Éditer le script d’init

sudo vim /etc/init.d/transmission-daemon

Changer l’utilisateur démarrant le service en modifiant la ligne USER :

USER=mon_utilisateur #debian-transmission

Copier le fichier de configuration vers le HOME de notre utilisateur (et mettre à jour les droits) :

mkdir -p $HOME/.config/transmission-daemon
sudo cp /etc/transmission-daemon/settings.json $HOME/.config/transmission-daemon/
sudo chown mon_utilisateur:mon_utilisateur $HOME/.config/transmission-daemon/ -R

Configuration de Transmission

La configuration de Transmission doit se faire lorsque ce dernier ne fonctionne pas, il faut donc arrêter le démon si cela n’est pas déjà fait :

sudo /etc/init.d/transmission-daemon stop

On édite ensuite le fichier settings.json qui contient tous les paramètres de Transmission, selon si vous avez réalisé la configuration du paragraphe ci-dessus ce fichier se situe dans votre $HOME dans .config/transmission-deamon sinon il est dans /etc/transmission-deamon

Je ne reprendrais pas ici l’explication des différents paramètres voir pour cela mon article Installer et configurer Transmission en tant que démon

Paramétrage d’une Blocklist personnalisée

Une blocklist est une liste d’adresse IP avec qui on ne souhaite pas partager les fichiers en cours de téléchargement. Pour mettre à jour cette liste ou en utiliser une personnalisée se référer à mon article utiliser des listes de blocage personnalisées (blocklist) avec le démon Transmission

Déplacement des téléchargements terminés

Par défaut une fois les téléchargements terminés Transmission partage indéfiniment le fichier, ce comportement peut être modifié par script voir mon article Déplacer/enlever les téléchargements terminés de Transmission (démon)

Limitation automatique de la bande passante

Lorsque Transmission télécharge il prendra par défaut toute la bande passante, pénalisant les autres usage d’Internet sur le réseau.

Il est possible de définir des vitesses maximales de téléchargement afin de limiter ce comportement, voir il est possible de définir 2 vitesses maximales et de les planifier en fonction des jours / heures.

Mais encore mieux grâce a un petit script qui s’exécute à intervalle régulier le basculement de la vitesse maximal à la vitesse modéré se fait automatiquement dès lors qu’un PC du réseau est allumé, pour en savoir plus voir mon article Limiter l’usage de la bande passante par Transmission automatiquement

Periscope : recherche des sous-titres

Périscope permet de télécharger les sous-titres associés à un fichier vidéo. Il se base sur divers sites fournissant des sous titres (dont OpenSubtitles.org)

Personnellement je l’installe depuis les sources ainsi :

Installation de subversion pour récupérer le dernier code source et des dépendances de Périscope :

sudo aptitude install subversion python-setuptools python-beautifulsoup python-xdg

Téléchargement du code source :

svn checkout http://periscope.googlecode.com/svn/trunk/ periscope-svn

Installation :

cd periscope-svn
sudo python setup.py install

Bonus : mon plugin sous-titres.eu (pour l’installer copier le fichier dans le répertoire plugins des sources et ajouter la ligne « from SousTitresEu import SousTitresEu » dans le fichier __init__.py du répertoire plugins puis compiler)

Configuration de la langue via le fichier ~/.config/periscope

[DEFAULT]
 lang = fr
 plugins =

Plus de détails :Téléchargement automatique des sous-titres de série avec Periscope et Installer Periscope depuis les sources + activation / désactivation des plugins

Script de déplacement des fichiers

Dernière étape, on a le fichier vidéo (téléchargé via Flexget et Transmission) et le fichier de sous-titre (téléchargé par Periscope), tous deux portent le même nom (merci Periscope) maitenant on veut pouvoir les ranger, c’est à dire les déplacer vers un autre espace disque où ils pourront être visionnées.

Ce répertoire est très spécifique à l’installation de chacun je vais ici décrire la mienne, à vous de l’adapter à votre architecture.

Donc dans mon cas c’est mon dockstar qui réalise toutes les opération de téléchargement, les séries sont ensuite déplacé vers le Freebox Server pour celle en HD et vers mon mediacenter pour les séries SD.

Mon mediacenter est une machine Linux le plus simple est donc de monter le répertoire de destination via sshfs.

Préparation déplacement de fichier via sshfs

Sur la machine cible le client openssh (paquet openssh-client) devra être installé.

Sur la machine source (Dockstar) ayant réalisée les téléchargements et sur laquelle le script va tourner on crée ce qu’il faut pour établir une connexion SSH sans mot de passe (donc scriptable)

Création des clés :

ssh-keygen -t rsa -b 2048

Ce qui donne :

Generating public/private rsa key pair.
 Enter file in which to save the key (/home/mon_user/.ssh/id_rsa):
 Enter passphrase (empty for no passphrase):
 Enter same passphrase again:
 Your identification has been saved in /home/mon_user/.ssh/id_rsa.
 Your public key has been saved in /home/mon_user/.ssh/id_rsa.pub.
 The key fingerprint is:
 bb:3c:91:f4:6f:cb:da:b1:32:7b:08:f8:4b:33:35:44 mon_user@mon_dockstar
 The key's randomart image is:
 +--[ RSA 2048]----+
 |          E      |
 |         .       |
 |          .      |
 |        ..       |
 |       oSoo      |
 |      . +o..     |
 |       .=o o.    |
 |       oo++o+o   |
 |        +ooB=.   |
 +-----------------+

Copie de la clé  publique sur la mahcine cible (le mediacenter) :

ssh-copy-id -i /home/mon_user/.ssh/id_rsa.pub mon_user_distant@IP_machine_distante

Ce qui donne :

Now try logging into the machine, with "ssh 'mon_user_distant@IP_machine_distante'", and check in:
.ssh/authorized_keys
to make sure we haven't added extra keys that you weren't expecting.

On obéit au recommandation ci-dessus et on se connecte en SSH sur la machine cible (mediacenter) et on ajoute l’ordinateur distant à liste des known_host, puis on se déconnecte.

On installe ensuite le paquet sshfs (2 879 ko sur mon Dockstar)

sudo aptitude install sshfs

Préparation du répertoire devant accueillir le montage via sshfs et gestion des droits utilisateur :

sudo mkdir /mnt/sweetbox
sudo chown mon_user:mon_user /mnt/sweetbox
sudo adduser mon_user fuse
sudo chown root:fuse /dev/fuse

Et on reboot, on peut ensuite (toujours du Dockstar) tester le montage sshfs :

sshfs mon_user_distant@IP_mediacenter:/chemin/cible/vers/les/series /mnt/sweetbox/

Pour démonter :

fusermount -u /mnt/sweetbox

Script de déplacement des fichiers

Voici le script de déplacement des fichier de série proprement dit (voir les explication après le script) :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

#!/bin/bash
 
SERIESNONTRIE=/data/downloads/torrents/complete
SERIES_SD_PATH=/mnt/sweetbox
SERIES_HD_PATH=/mnt/freebox
 
cd $(dirname "${0}")
 
FREEBOX_MOUNTED=false
function chechAndMountFreebox {
  if [ $FREEBOX_MOUNTED == false ]; then
    echo "Montage du répertoire contenant les séries de la Freebox"
    curlftpfs ftp://192.168.1.254/Disque%20dur/Vidéos/Séries /mnt/freebox/ -o user=freebox:password,uid=1000,gid=1000,umask=003
    FREEBOX_MOUNTED=true
  fi
}
 
SWEETBOX_MOUNTED=false
function chechAndMountSweetbox {
  if [ $SWEETBOX_MOUNTED == false ]; then
    echo "Montage du répertoire contenant les séries de Sweetbox"
    ./wakeonlan.sh "adresse MAC" "Adresse IP"
    sshfs user_distant@adresse_ip:/chemin/cible/vers/les/series /mnt/sweetbox/
    SWEETBOX_MOUNTED=true
  fi
}
 
#pour tous les éléments présents dans le repertoire à trier 
for F in $SERIESNONTRIE/*
do
  # si c'est un fichier
  if [ -f "$F" ]; then
    extension=`echo ${F##*.} | tr "[:upper:]" "[:lower:]"`
    if [ $extension == "avi" ] ; then
      SERIES_PATH=$SERIES_SD_PATH
      chechAndMountSweetbox
    elif [ $extension == "mkv" ] ; then
      SERIES_PATH=$SERIES_HD_PATH
      chechAndMountFreebox
    else
      continue
    fi
 
    # on deduit le nom de la serie à partir du nom du fichier
    serie=`basename "$F" | sed 's/\([a-zA-Z.]*\.S[0-9]\{2\}\)E[0-9]\{2\}.*/\1/'`
 
    # si il existe un fichier srt portant le meme nom dans le meme repertoire
    if [ -f "${F%.*}.srt" ]; then
 
      # on deplace les 2 fichiers dans un repertoire portant le nom de la serie et de la saison
      echo Deplacement de "${F%.*}.*" dans $SERIES_PATH/$serie
 
      # si le repertoire destination n'existe pas
      if [ ! -d "$SERIES_PATH/$serie" ]; then
        # on le crée
        echo Creation du repertoire $SERIES_PATH/$serie
        mkdir -p "$SERIES_PATH/$serie/Vus"
      fi
 
      mv ${F%.*}.srt $SERIES_PATH/$serie
      mv ${F%.*}.$extension $SERIES_PATH/$serie
    fi
  fi
done
 
if [ $FREEBOX_MOUNTED == true ]; then
  echo "Démontage du répertoire contenant les séries de la Freebox"
  sudo umount /mnt/freebox/
fi
if [ $SWEETBOX_MOUNTED == true ]; then
  echo "Démontage du répertoire contenant les séries de Sweetbox"
  fusermount -u /mnt/sweetbox
  ./shutdown.sh "mon_user_distant" "IP distante"
fi

Le principe de ce script est le suivant, on parcours tous les fichiers présents dans le répertoire où sont stocké les téléchargements terminés (download/torrents/complete/)  (ligne 29)

Ligne 37 : Si le fichier à l’extension .mkv c’est une série en HD on va donc potentiellement le déplacer vers la Freebox.

On verifie donc que le disque dur de la Freebox est bien monté (via un booléen) sinon on le fait (voir mon article Monter le disque dur du Freebox Server (v6) en ligne de commande) (ligne 39 et fonction en ligne 9-16)

Ligne 34 : Si le fichier à l’extension .avi c’est une série en SD on va donc potentiellement le déplacer vers le mediacenter (sweetbox) via sshfs.

Je fais alors appel à mon script de démarrage via WakeOnLan qui démarre la machine dont on passe l’adresse IP et MAC en paramètre si elle ne l’est pas déjà, sinon on flag le fait que le mediacenter était déjà allumé pour ne pas l’éteindre à la fin (voir Allumer / éteindre un PC sous Linux à distance (scripts)). Puis on monte le répertoire de destination. (ligne 36 et fonction en ligne 18-27)

Ligne 48 : on vérifie si on a un fichier de sous-titre, si oui on est OK pour déplacer les 2 fichiers (lignes 60-61) vers le chemin cible déterminé en fonction du type du fichier vidéo en cours de traitement (lignes 35 et 38)

Les séries sont rangé dans le répertoire cible dans un sous répertoire du nom de la série (ligne 45) que l’on crée le cas échéant (lignes 54-58)

Lignes 66-74 : Puis on range comme c’était avant notre arrivé, on démonte les point de montage et on n’éteint le mediacenter si ce dernier n’était pas allumé avant le script (voir Allumer / éteindre un PC sous Linux à distance (scripts))

Planification

Dans cette article de nombreux scripts ont été mis en œuvre il faut les planifier via CRON, en voici un exemple :

MAILTO=""
 LANG=fr_FR.UTF-8
 PATH=/usr/bin:/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/sbin
 ##########################################################
 #minute (0-59),                                          #
 #|  hour (0-23),                                         #
 #|  |  day of the month (1-31),                          #
 #|  |  |  month of the year (1-12),                      #
 #|  |  |  |  day of the week (0-6 with 0=Sunday)         #
 #|  |  |  |  |       commands                            #
 ##########################################################
 
##### Opérations pour Transmission
# téléchargement d'une blocklist personnalisé une fois par semaine
0 0 * * 0 $HOME/bin/blocklist_transmission.sh > $HOME/tmp/maintenance/blocklist.log
# Toutes les 3h on vérifie s'il n'y a pas une téléchargement terminé à déplacer
30 */3 * * * $HOME/bin/remove_completed_torrents.sh
# Toutes les minutes on vérifie s'il n'y a pas un PC qui s'allume sur le réseau pour basculer en vitesse lente
*/1 * * * * $HOME/bin/alt_speed_transmission.sh
 
##### Téléchargement des séries, on enchaine flexget, periscope et le déplacement des fichier toutes les 3h (les 3 scripts étant espacé de 20 minutes)
0 */3 * * * flexget -v --cron > $HOME/tmp/flexget.log
20 */3 * * * periscope /data/downloads/torrents/complete/
40 */3 * * * $HOME/bin/move_tv_show.sh

Sources:

Flexget :

• Plugins/transmission – FlexGet : Plugin pour Transmission (pas utilisé)

Transmission :

• Transmission : Site officiel
• Transmission : Liste de plugins sur le site officiel
• EditConfigFiles – Transmission : Description des option du fichier settings.json sur le site officiel
• Papillon-butineur: Blocklists avec Transmission : script de téléchargement des blocklists
• Updated: Transmission Installation/Configuration on Ubuntu Server – 1000umbrellas.com : Exemple de configuration et manipulations à effectuer sur les répertoires accueillant les torrents si vous laissez Transmission tourner avec l’utilisateur debian-transmission
• devINSIDE :: Blog :: Installer et configurer le package transmission-daemon sous debian : configuration de base + interaction avec un Vhost apache (intérêt ?)
• Installation Transmission daemon sur Ubuntu Server « Realpeace’s Blog : installation et configuration + quelques clients Transmission
• HaHadopi » Transmission-daemon sur sa seedbox : installation et configuration
• Configurer Transmission pour l’access a distance (CLI) | Shtark.fr : installation et configuration
• Plugins/transmission – FlexGet : Plugin Flexget
• Updated: How to Automatically Move and Remove Transmission-Daemon Downloads – 1000umbrellas.com: Source du script de suppression des torrent terminés

TVNamer (pas utilisé encore) :

• HowTo : Renommer un épisode de série automatiquement avec TVNamer | Hellnino’s Blog
• TVNamer Installation/Configuration – 1000umbrellas.com
• Using TVNamer to Move Completed TV Torrent Downloads – 1000umbrellas.com
• dbr/tvnamer – GitHub

SSHFS :

• sshfs – Documentation Ubuntu Francophone
• How to Mount a Remote Folder using SSH on Ubuntu – How-To Geek : indique l’astuce pour monter un système de fichier distant sans le sudo

On va donc tout d’abord voir comment installer Periscope depuis les sources, puis ensuite voir quelles modifications apporter aux sources pour corriger quelques désagréments.

En pré-requis il faut tout d’abord désinstaller Periscope si vous l’avez préalablement installé depuis le package :

sudo aptitude purge python-periscope

Installation depuis les sources

Pour installer Periscope depuis les sources il faut les télécharger avec la commande svn qui fait partie du partie du paquet subversion, on installe donc ce dernier :

sudo aptitude install subversion

Puis on télécharge les sources :

svn checkout http://periscope.googlecode.com/svn/trunk/ periscope-svn

Cette commande va créer un répertoire periscope-svn dans le répertoire courant et y télécharger tous les fichiers sources de Periscope.

On installe ensuite les dépendances de Periscope :

sudo aptitude install python-setuptools python-beautifulsoup python-xdg

Puis on installe Periscope :

cd periscope-svn
sudo python setup.py install

Désinstallation de Periscope (installé via les sources)

Lorsque l’on a installé Periscope via les sources, il n’y a pas de commande permettant de la désinstaller automatiquement, il faut il aller à la main :

sudo rm -rf /usr/local/lib/python2.6/dist-packages/periscope-dev-py2.6.egg/EGG-INFO/scripts/periscope
sudo rm -rf /usr/local/lib/python2.6/dist-packages/periscope-dev-py2.6.egg/periscope
sudo rm /usr/local/bin/periscope

Activation / désactivation des plugins

En désactivant certains plugins de Periscope on peut résoudre 2 des « problèmes » remontés lors de l’article précédent :

• Certains plugins ne fonctionnent pas bien et remontent des erreurs (exemple plugin podnapisi)
• L’empilement des plugins, fait que le temps d’exécution est relativement long

Pour cela il suffit d’éditer le fichier source suivant :  periscope/plugins/__init__.py

Qui contient initialement ceci :

from OpenSubtitles import OpenSubtitles
from SubtitleSource import SubtitleSource
from SubScene import SubScene
from Subtitulos import Subtitulos
from Addic7ed import Addic7ed
from Podnapisi import Podnapisi

On peut dès lors supprimer un plugin en commentant la ligne avec un # et en réinstallant Periscope depuis les sources (sudo python setup.py install)

Sources :

image par adam.hyland

Sur mon serveur cette fonction est occupé par Subdl (cf. Subdl – Téléchargement automatique des sous-titres, Corriger subdl, script de téléchargement automatique de sous-titres) mais ce dernier n’est plus maintenu (voir n’existe plus)

De plus Periscope offre l’avantage d’être multi-sources (OpenSubtitles.org, SubtitleSource.org, Subscene.com, Subtitulos.es et Addic7ed.com) là où Subdl ne va chercher que sur OpenSubtitles.org

Installation

Selon le Wiki de Periscope lorsque l’on est sous Ubuntu, pour l’installer il suffit d’ajouter le PPA correspondant puis de l’installer

sudo add-apt-repository ppa:patrick-dessalle/ppa
sudo aptitude update
sudo aptitude install python-periscope

Malheureusement ce projet aussi semble un peu à l’abandon (malgré quelques interventions du développeur dans ses sources en Mai) et vous aurez donc le message d’erreur suivant :

Impossible de trouver un paquet dont le nom ou la description correspond à « python-periscope »

De plus si on regarde le PPA on constate que le package python-periscope ne compile plus depuis 10 semaines dû à un problème de dépendance avec le module beautifulSoup

Edit 25/08/2010 : Le développeur Patrick Dessalle (qui au passage parle français), indique dans le commentaire ci dessous que le package est réparé (je n’ai pas testé)

Bref on va devoir y aller à la main, on télécharge donc le package ici et on l’installe par un simple :

sudo dpkg -i python-periscope_0.1.9-2_all.deb

Utilisation

L’utilisation de Periscope est ensuite très simple, il suffit de lancer la commande suivante :

periscope -l [langage] [liste fichiers vidéos ou répertoire contenant des vidéos]

Pour le langage on prendra « fr » pour le français et « en » pour l’anglais, il est possible de spécifier plusieurs langue le sous-titre choisi sera en priorité celui de la première langue.

On pourra sinon renseigner le langage pas défaut dans le fichier de configuration ~/.config/periscope/config

[DEFAULT]
lang = fr

Periscope est construit sur un mécanisme de plugins, un par site sur lequel on souhaite faire des recherches.

Si le sous-titre est disponible sur plusieurs site, sera gardé celui trouvé en premier c’est à dire celui du premier plugin appelé, c’est à à dire dans l’ordre suivant :

OpenSubtitles.org, SubtitleSource.org, Subscene.com, Subtitulos.es et Addic7ed.com

Pour chaque fichier vidéo trouvé Periscope récupère du nom du fichier le nom de la série, la saison, le numéro d’épisode et la team ayant mis à disposition la vidéo.

Pour chaque plugin il fait ensuite une requête sur le site du plugin pour avoir la page correspondant à la série / saison / épisode, il récupère la page HTML, analyse le code source de cette dernière afin de trouver les liens de téléchargement et ajoute ces derniers dans une file d’attente.

Periscope analyse ensuite les liens trouvé afin de déterminer le meilleur en fonction de la/les langues voulues, il réalise le téléchargement, décompresse l’archive le cas échéant et renomme le fichier de sous titres pour qu’il ait le même nom que la vidéo.

Évidemment il y a des différences selon les plugins mais le principe général reste celui-ci

Lors de la recherche Periscope indique sur la sortie standard les actions qu’il réalise et la sortie est plutôt verbeuse voyez plutôt pour un répertoire ne contenant qu’une seule vidéo :

WARNING:root:/home/[mon user]/Vidéos/Fichier.srt mimetype is 'None' which is not a supported video format (('video/x-msvideo', 'video/quicktime', 'video/x-matroska', 'video/mp4'))
INFO:root:Searching subtitles for /home/[mon user]/Vidéos/Fichier_xxx.avi with langs ['fr']
INFO:root:Searching on OpenSubtitles
INFO:root:Searching on SubtitleSource
INFO:root:Searching on SubScene
INFO:root:Searching on Addic7ed
WARNING:root:Ooops, you found a missing language in the config file of Addic7ed: Spanish. Send a bug report to have it added.
INFO:root:Addic7ed writing 1 items to queue
INFO:root:SubtitleSource writing 0 items to queue
INFO:root:SubScene writing 0 items to queue
ERROR:root:Open subtitles could not be contacted for login
INFO:root:OpenSubtitles writing 0 items to queue
INFO:root:Trying to download subtitle: http://www.addic7ed.com/....
INFO:root:**************************************************
INFO:root:Downloaded 1 subtitles
INFO:root:fr - /home/{mon user]/Vidéos/Fichier_xxx.srt
INFO:root:**************************************************

On peux constater 2 lignes de Warning :

• Le première indique qu’un des fichiers trouvés n’est pas de type vidéo
• La deuxième indique qu’une langue non référencée à été trouvé. En effet Periscope maintient dans le code source de chacun des plugins une liste de correspondance entre les langues utilisé par le site et la liste des langues utilisées par Periscope (par exemple « fr » dans Periscope peut correspondre à « fre » sur un des sites)

Conclusion

• Periscope offre un alternative intéressante à subdl car il est multi-site.

MAIS :

• Il scan tous les sous-répertoire  du répertoire d’entrée (y compris les répertoires caché commençant par . par exemple .Trash)
• Il est verbeux, par exemple si vous avez des fichiers autre que des vidéos dans le répertoire on aura une ligne de Warning par fichier
• Les sites utilisés sont peu alimenté en sous-titres Français
• Certains plugins ne fonctionnent pas bien et remontent des erreurs (exemple plugin podnapisi)
• L’empilement des plugins, fait que le temps d’exécution est relativement long

Dans un prochain article, nous verrons comment installer Periscope depuis les sources, afin de modifier 2-3 pour palier à certains de ces problèmes, enfin je suis en train d’écrire un plugin pour le site sous-titres.eu qui est une référence en matière de sous-titres Français.

Sources :

periscope – Project Hosting on Google Code

Periscope, le script pour trouver et charger directement les sous titres en VO de vos films et séries | Ubuntu And Us

Un script pour trouver directement des sous titres en VO pour vos films et séries

Xnoccio.com – » Descarga masiva de subtítulos con Periscope

Right Click Movies To Download Subtitles In Ubuntu ~ Web Upd8

Image par MATEUS_27:24&25 sous CC BY-NC

Bien que de moins en moins performant (pour des raisons de non disponibilité des sous-titres sur opensubtitle.org), ce script faire une première partie du travail.

Mais depuis plusieurs mois il ne fonctionne plus.

Pas de correction à attendre de l’auteur le script n’est plus maintenu et le site n’existe même plus (je peux héberger le script si vous êtes intéressés)

Ce problème provient du fait qu’opensubtitle.org à changé l’adresse web de son API, il faut donc corriger le script.

Dans le répertoire où vous avez installé / décompressé subdl, éditer le fichier subdl (qui est un script Python),  localiser la ligne suivante :

osdb_server = "http://www.opensubtitles.org/xml-rpc"

Et la modifier ainsi :

osdb_server = "http://api.opensubtitles.org/xml-rpc"

Remarque : cette correction supprime le problème systématique dû au changment d’URL de l’API opensubtitle.org, mais ce service reste très instable et pas très performant.

Sur 17 épisodes d’une même série (série de l’année 2009-2010, ayant fait parler d’elle), l’appel de subdl via :

ls *.avi | xargs -t -I {} python bin/subdl/subdl --lang=fre --existing=bypass {} #

m’a donnée :

• 11 erreurs « Error in XMLRPC SearchSubtitles call: [Errno 104] Connection reset by peer »
• 2 erreurs « Error in XMLRPC SearchSubtitles call: <ProtocolError for api.opensubtitles.org/xml-rpc: 503 Service Not Available> »
• 3 sous-titre non trouvés

Lors de la première exécution et

• 3 erreurs « Error in XMLRPC SearchSubtitles call: [Errno 104] Connection reset by peer »
• 14 sous-titre non trouvés

Lors de la deuxième exécution

Sources :

Fixing subdl 1.0.2

Image par aussiegall sous CC

Mais il existe une autre configuration optionnelle mais bien pratique, celle consistant à recevoir un email dès que flexget télécharge un nouveau fichier torrent/épisode.

L’email reçu aura le format suivant :

Sujet :

[FlexGet] <nom du flux> : 2 new entries downloaded

Corps du mail :

Hi,
 
FlexGet has just downloaded 2 new entries for feed <nom du flux> :
 
- Serie A 5x21 (HDTV-LOL) [VTV] (<adresse du torrent>) => ~/downloads/torrentfiles (Serie.A.S05E21.HDTV.XviD-LOL.[VTV].torrent)
 
- Serie B S02E07 HDTV XviD-LOL (<adresse du torrent>) => ~/downloads/torrentfiles (Serie.B.S02E07.HDTV.XviD-LOL.torrent)

La configuration de l’email se fait très simplement en ajoutant/créant une section preset global :

presets:
  global:
    email:
      from: [adresse email expediteur]
      to:
        - [adresse email destinataire 1]
        - [adresse email destinataire 2]
      smtp_host: [serveur SMTP]

Cette configuration est la configuration minimal pour un serveur SMTP ne gérant pas d’authentification comme celui de Free.fr (cf. Utiliser le serveur SMTP de Free avec sSMTP)

Pour gmail il faudra :

presets:
  global:
    email:
      from: [user gmail]@gmail.com
      to:
        - [adresse email destinataire 1]
        - [adresse email destinataire 2]
      smtp_host: smtp.gmail.com
      smtp_port: 587
      smtp_login: true
      smtp_username: [user gmail]
      smtp_password: [mot de passe gmail]
      smtp_tls: true

Sources :

Wiki Flexget : http://flexget.com/wiki/Plugins/email

Images par Mzelle Biscotte sous CC BY-SA

<Avertissement>

Cet article démontre la faisabilité d’automatiser le téléchargement de séries et explique la mise en œuvre de Flexget.

Il n’est en aucune façon une incitation au téléchargement.

</Avertissement>

Cet article est la mise à jour de l’article Flexget : téléchargement automatique de torrents, il se propose de décrire l’installation et la configuration de flexget pour surveiller un flux RSS et y télécharger le fichier torrent associé à une/des séries paramétré(s).

Ce mécanisme associé avec un client torrent permettant la surveillance d’un répertoire pour le démarrage automatique des téléchargement, permet d’automatiser la récupération de série télé au fur et à mesure de leur diffusion.

Présentation de Flexget

Flexget se base sur divers  sources de données, le script traite cette source, filtre son contenu et produit une sortie.

Flexget est entièrement configurable via un fichier de configuration où l’on défini le/les plugins à utiliser pour la source, le traitement et la sortie

Pour exemple voici quelques plugins (liste complète des plugins flexget) :

• Plugins sources : csv, html, rss, etc.
• Plugins de filtre : serie, imdb, etc.
• Plugins de sortie : dowload, deluge, email, etc.

Dans la cas du sujet de cet article, les plugins utilisés pour télécharger un fichier torrent seront :

rss, serie, download, email

Installation de Flexget

En version 0.9 l’installation se résumait à une simple décompression d’une archive zip, depuis la version 1.0, il est fournis un package egg qui contient le programme mais qui gère aussi les dépendances.

Pour prendre en charge les packages python egg, il faut que le programme easy_install soit installé pour cela :

sudo aptitude install python-setuptools

On télécharge la dernière version du fichier egg sur le site Flexget puis on l’installe :

sudo easy_install FlexGet-1.0r1197-py2.6.egg

On peut simplement tester que l’installation s’est correctement effectuée par :

flexget -V

Qui devrait donner la version installée :

FlexGet 1.0r1197

Configuration

Par défaut flexget charge sa configuration d’un fichier config.yml dans le répertoire .flexget du répertoire home de l’utilisateur l’exécutant.

Il est tout fait possible de réaliser cette configuration dans un autre fichier, mais dès lors il faudra indique le nom et chemin de ce fichier dans la ligne de commande.

Le fichier de configuration doit respecter le formalisme du langage YAML (lien Wikipédia), où la hiérarchisation des données se fait via des doubles espaces, en aucun façon un fichier yml doit avoir des tabulation.

(Pour faciliter l’édition de ce genre de fichier on pourra utiliser VIM avec le paramétrage indiqué ici Afficher les caractères invisibles dans VIM)

Lors du passage à la version 1.0 de Flexget, le format du fichier de configuration à été complétement revu.

Prenons un exemple simple :

feeds:
  Series_torrent:
    rss: [URL flux RSS]
    series:
      - Une belle Serie
      - Une autre serie
    download: ~/downloads/torrentfiles

La configuration doit contenir au moins un conteneur feed qui possède en son sein autant de flux (RSS ou autre) que voulu

Chaque flux est nommé via un texte libre (ici Serie_torrent) et contient la définition/configuration des plugins à utiliser par le flux.

Chaque flux utilise couramment 3 plugins :

• 1 plugin source : rss pour lequel on indique l’adresse du flux RSS
• 1 plugin filtre : serie, ce plugin analyse le contenu de la source (le flux RRS) et ne retient dans ce flux que les entrées dont le nom correspond à une des séries indiqués (ici « une belle serie » et « une autre serie »)
• 1 plugin de sortie : download, ce plugin télécharge le fichier torrent associé avec les séries filtrés dans le répertoire indiqué

Le plugin serie, est très puissant :

• Il gère le multiple format de nom que peut avoir une série : « Une belle Serie » ou « Une.belle.Serie » ou « une belle serie »
• Il gère les repost d’un épisode, il compris si le nom change, ainsi si l’épisode « Une.belle.Serie.S01E10.LOL » à été téléchargé et que quelques heures plus tard, l’épisode est reposté par une autre team « Une.belle.Serie.S01E10.titre.de.l’episode.VQM » ce dernier ne sera pas re-téléchargé
• Il gère les repost pour cause de proper/repack (c’est à dire qu’un épisode est re-posté car la première version avait un problème) en re-téléchargeant l’épisode
• Il existe des options pour ne télécharger préférentiellement les épisode répondant à une qualité donné.

Voir les autres caractéristiques ici : http://flexget.com/wiki/Plugins/series

Autre exemple utilisant la notion de qualité de l’épisode :

feeds:
  Series_torrent:
    rss: [URL flux RSS]
    series:
      Series_qualite:
        - Une belle Serie
            timeframe: 3 hours
            quality: hdtv
        - Une autre Serie
            timeframe: 3 hours
            quality: hdtv
    download: ~/downloads/torrentfiles

La qualité est définie par le mot clé quality qui peut prendre les valeurs suivantes :

1080p, 1080, 720p, 720, hr, dvd, hdtv, pdtv, dsr, dsrip

Le mot-clé timeframe indique que lorsqu’un nouvel épisode est trouvé et que celui-ci ne satisfait pas aux critères de qualité, on ne le télécharge pas tout de suite mais on attend le temps spécifié afin de s’assurer qu’un nouveau post avec la qualité voulu arrive.

Il faut définir ces options pour chaque séries, à moins d’utiliser la notion de groupe :

feeds:
  Series_torrent:
    rss: [URL flux RSS]
    series:
      settings:
        Series_qualite:
          timeframe: 3 hours
          quality: hdtv
      Series_qualite:
        - Une belle Serie
        - Une autre Serie
    download: ~/downloads/torrentfiles

On utilise ici les options de qualités et la notion de groupe.

Less options timeframe et quality sont définies dans un groupe que l’on peut nommer comme on le souhaite (ici Serie_qualite) l, lui-même défini dans un « noeud » settings

Le nom du groupe est ensuite réutilisé pour définir les séries sur lesquelles les option doivent s’appliquer.

On peut ainsi définir plusieurs groupes pour des séries différentes :

feeds:
  Series_torrent:
    rss: [URL flux RSS]
    series:
      settings:
        Series_hdtv:
          timeframe: 3 hours
          quality: hdtv
        Series_1080:
          timeframe: 3 hours
          quality: 1080p
      Series_1080:
        - Une belle Serie
      Series_hdtv:
        - Une autre serie
    download: ~/downloads/torrentfiles

Nous avons ici 2 groupes pour 2 niveaux de qualité (hdtv et 1080p), la série « Une belle serie » sera donc téléchargée en favorisant le niveau de qualité 1080p tandis que la série « une autre serie » elle sera téléchargée en qualité hdtv.

Toujours plus compliqué, si on dispose de plusieurs sources de données il faudra redéfinir les groupes dans chacun des flux, sauf si on utilise la notion de preset :

presets:
  tv:
    download: ~/downloads/torrentfiles
    series:
      settings:
        Serie_hdtv:
          timeframe: 4 hours
          quality: hdtv
      Serie_hdtv:
        - Dexter
        - Dollhouse
 
feeds:
  Series_flux_1:
    rss: [URL du flux RSS n°1]
    preset: tv
 
  Series_flux_2:
    rss: [URL du flux RSS n°2]
    preset: tv

Test

Lorsque l’on a fait son fichier de configuration il faut le tester, pour cela il existe un mode test :

flexget -c [fichier YML] --test -v

L’option « -c » est facultative si vous avez fait votre configuration dans le fichier /.flexget/config.yml

L’option « -v » indique à flexget qu’il doit afficher le détail des opérations qu’il réalise (pratique pour comprendre son fonctionnement, ses choix, débugger sa configuration)

La sortie de cette commande sera du type :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

2010-03-15 22:08 INFO     manager                       Test mode,  creating a copy from database ...
2010-03-15 22:08 INFO     manager                       Test database  created
2010-03-15 22:08 INFO     feed          Series_torrent  Produced 20  entries.
...
+ filter   seen         Rejected Serie A S06E17 PROPER  HDTV XviD-2HD
+ filter   seen         Rejected Serie B S06E07 HDTV XviD-FQM
...
+ filter   series       Rejected Serie A  S06E17 HDTV  XviD-XII (already downloaded)
+ filter   series       Rejected Serie B S06E01 HDTV XviD-P0W4 (already  downloaded)
...
+ filter   series       Accepted Serie A  S06E20 HDTV XviD-2HD (quality met, timeframe unnecessary)
+ filter   series       Accepted Serie A  S06E21 HDTV XviD-2HD (quality met, timeframe unnecessary)
...
2010-03-15 22:08 INFO     feed          Series_torrent  Accepted: 0  (Rejected: 18 Undecided: 2 Failed: 0)
...
2010-03-15 22:08 INFO     download      Series_torrent  Would download: Serie A S06E20 HDTV XviD-2HD
2010-03-15 22:08 INFO     download      Series_torrent  Would download: Serie A S06E21 HDTV XviD-2HD
...
2010-03-15 22:08 INFO     download      Series_torrent  Would write: Serie A S06E20 HDTV XviD-2HD
2010-03-15 22:08 INFO     download      Series_torrent  Would write: Serie A S06E21 HDTV XviD-2HD
...
+ undecided              Serie C S04E19 HDTV XviD-LOL
+ undecided              Serie C S04E18 HDTV XviD-LOL
...
2010-03-15 22:08 INFO     manager                       Removed test  database

Ligne 1-2 : on voit que l’on est en test puisque flexget créé une base de données de test (dans il stock les séries déjà téléchargés, entre autre)

Ligne  3 : le nombre d’entrées (épisodes) détecté dans le flux

Ligne 5-6 : les entrées rejetées car déjà présente lors du lancement de flexget précédent

Ligne 8-9 : les entrées rejetés car l’épisode à déjà été téléchargé (repost d’un épisode par une autre team)

Lignes 11-12 : les entrées acceptées

Lignes 14 : récapitulatif des traitements

Lignes 16-17, 19-20 : Les 2 entrées acceptées, sont téléchargées et le fichiers est écrit sur le disque

Lignes 22-23 : des entrées/épisodes trouvés dans le flux RSS, mais la série correspondante n’est pas configurée

Linge 25 : purge de la base de test.

Exécution et plannification

Le moyen le plus efficace d’utiliser flexget est de le plannifier via Cron :

flexget -c [fichier YML] --cron

L’option « –cron » indique que l’on est dans le cas d’une utilisation en batch, ce qui pour conséquence de désactiver l’affichage des logs sur la sortie standard, de les rediriger vers un fichier de log et de diminuer la verbosité de ces dernières.

Attention lors de la plannification cron à mettre un interval d’exécution du job en adéquation avec le paramétrage du timeframe.

Si votre tache s’exécute toutes les 3 heures mais que votre timeframe est de 4 heures

Exécution 1 : un épisode ne satisfait pas le niveau de qualité, flexget doit attendre 4 heure avant de s’en satisfaire.

L’exécution  suivante (n°2) arrive 3h après, si l’épisode de bonne qualité n’existe toujours pas, flexget ne fait rien.

L’exécution  suivante (n°3) arrive 3h après, soit 6h après la première, c’est uniquement à ce moment que flexget téléchargera l’épisode de qualité moindre.

En soi ce n’est pas grave mais le paramétrage n’est pas optimal, on préférera mettre un timeframe de 3 ou 6h.

Utilisation conjointe avec un client Torrent

Flexget se contente de télécharger le fichier torrent, mais il ne télécharge par la vidéo, pour ce faire il suffit d’avoir un client torrent prenant en charge la surveillance d’un répertoire.

En paramétrant le client torrent pour qu’il surveille le répertoire dans lequel flexget télécharge les fichier torrent, le téléchargement démarre de façon automatique.

Dans Deluge ce paramétrage se fait en renseignant le paramètre « autoadd .torrent files from » :

Cf. Configuration du client torrent Deluge via l’interface WebUI

Remarque :

Flexget dispose d’un plugin deluge permettant de piloter directement Deluge de façon assez puissante, je n’ai pas encore pris le temps de m’y pencher..

Méthode certifiée Hadopi proof

L’utilisation des protocoles P2P, dont fait partie Bittorrent n’est pas du tout Hadopi compatible (mais bon Hadopi n’est pas encore arrivé), par contre les newsgroups eux le sont (pour l’instant)

Et fort heureusement Flexget dispose d’un plugin sabnzbd qui peut piloter SABnzbd, un client de newsgroup.

Bref à garder sous coude pour dans quelques mois (peut être)

Sources :

Le wiki de flexget : http://flexget.com/wiki

Sample FlexGet config.yml file for Deluge

Automating Home Entertainment • Niamu by Brendon Walsh

How to Configure FlexGet to Automatically Download TV Torrents on Ubuntu 10.04 Lucid Lynx Server – 1000umbrellas.com

Image par nrkbeta

Toujours dans la série de l’automatisation des taches, voici comment faire pour récupérer de façon automatique les sous-titres des différents épisode d’une série.

Le tout évidemment sans aucune intervention ni interface graphique.

Pour cela j’ai utilisé un script python Subdl.

Ce script prend en paramètre le nom du fichier dont on veut trouver les sous-titre, calcul une clé hash identifiant ce fichier et fait une requête sur le site  openSubtitle.

Si plusieurs fichiers de sous-titres sont trouvé pour la langue voulu, subdl télécharge celui qui à la meilleur note.

Subdl renomme aussi le fichier de sous-titres pour lui donner le même nom que le fichier vidéo correspondant.

Installation

Vu qu’il s’agit d’un script l’installation est super simple, il suffit de télécharger l’archive contenant le script :

wget http://www.cubewano.org/subdl/downloads/1.0.2/subdl-1.0.2.tar.gz

Comme on peut le constater cette version date de plus d’un an mais elle fonctionne parfaitement.

On extrait ensuite le script :

tar -xvf subdl-1.0.2.tar.gz

Et voila.

Utilisation

Subdl à besoin de 2 paramètres :

• la langue pour laquelle on cherche des sous-titres
• le fichier dont on cherche les sous-titres

On ajoutera un paramètre supplémentaire indiquant le comportement à adopter si le fichier de sous-titres existe déjà (on passe)

Ce qui donne :

python subdl --lang=fre --existing=bypass mon_fichier.avi

Bonus :

Voici une ligne de commande qui lance la recherche des sous-titres sur tous les fichier avi d’un répertoire :

ls *.avi | xargs -t -I {} python ~/subdl/subdl --lang=fre --existing=bypass {} 

Alternative

Il existe un autre outil ligne de commande pour télécharger de façon automatique des sous-titres en utilisant les service de openSubtitle.org, il s’agit de Subdownloader.

Ce dernier est plus complet puisqu’il propose une interface graphique en plus de la ligne de commande, il est disponible sous forme de paquet Debian installant ainsi toutes les dépendances nécessaires.

(Rque : il est aussi disponible sous Windows et Mac !!)

Bref il est plus complet mais aussi beaucoup plus lourd (gros).

Avertissement :

Le but de ce post est de montrer comment il est possible d’automatiser le téléchargement de torrents. Ce n’est en aucun cas l’apologie du piratage.

Cet avertissement effectué passons à la description du problème.

Comment faire pour automatiser le téléchargement de séries via un flux RSS ?

Au moment où j’ai mis ce système en place la version de Deluge utilisé ne permettait pas de s’abonner à un flux RSS. J’ai donc dû trouver une alternative qui à l’usage se révèle non seulement efficace mais aussi supérieure.

Cette alternative s’appelle Flexget.

La phrase d’introduction du site de Flexget décrit bien son usage et son rôle :

« FlexGet is a program aimed to automate downloading or processing content (torrents, podcasts, etc.) from different sources like RSS-feeds, html-pages, various sites and more. « 

Soit grosso-modo en Français :

« Flexget est un programme ayant pour rôle d’automatiser le téléchargement ou le traitement de contenus (torrents, podcasts) à partir de différentes source comme les flux RSS, les pages HTML, de nombreux sites et plus encore »

Bref ce qu’il nous faut pour répondre à la problématique posée.

Flexget va à partir d’un flux RSS nous informant en quasi temps réél de la mise à disposition d’un torrent, télécharger ce même torrent.

Là où il surpasse les clients torrent ayant la capacité à s’abonner à ces même flux RSS, c’est qu’on pourra lui indiquer ses préférence (en terme de qualité de release) et qu’il ne téléchargera qu’un seul torrent pour un même épisode d’une même saison d’une série donnée.

En pré-requis il nous faut un flux RSS nous informant de la mise à disposition d’un torrent. Dnas le but de ne pas trop inciter au priatage je n’indiquerais volontairement pas ici où trouver ce genre de site…

Installation de flexget

Flexget à besoin du package permettant à Python de parser le YAML et de feedparser permettant de parser les flux RSS, on installera donc  :

sudo aptitude install python-yaml python-feedparser

Téléchargement de la dernière version de flexget (la 0.9.3.2 dans mon cas) :

wget http://download.flexget.com/0.9/FlexGet_0.9.3.2.zip

Dézippage de l’archive téléchargée :

unzip FlexGet_0.9.3.2.zip

Et voila flexget est installé, reste à le paramétrer.

Paramétrage de flexget

Le paramétrage se fait dans un fichier yml, ce dernier peut avoir le nom que l’on veut et être placé où l’on veut, dans mon cas ce fichier de configuration se nomme configFlexget.yml et est placé dans le répertoire de flexget (lui même dans le home de mon user).

Ouvrir le fichier et copier une configuration ressemblant à ceci :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

global:
  download: ~/downloads/torrentfiles
 
settings:
  series:
    timeframe:
      enough: hdtv
 
feeds:
  Serie1:
    rss: http://xxxxx.net/serie1.xml
    series:
      - Serie1
 
   Serie2:
    rss: http://xxxxx.net/serie2.xml
    series:
      - Serie2

Point important :

Le YML (ou YAML) est un language structuré (comme le XML) mais il est beaucoup moins verbeux (pas de balise ouvrante et fermante)

En contrepartie la hierarchie des éléments est réalisé via l’indentation à base d’espace (surtout pas de tabulation).

Il convient donc d’être très rigoureux sur l’edition des fichiers yml.

La section global permet comme son nom l’indique le paramètrage global de flexget quelque soit le plugin utilisé par la suite, elle sert uniquement à définir le répertoire où les téléchargements vont êtres stockés.

La ruse consiste ici à mettre le même chemin que celui paramétré dans Deluge paramètre « Auto Add folder » (cf. mon article Installation d’un client torrent – Deluge), ainsi flexget télécharge les torrents et Deluge commence automatiquement le téléchargement.

Section settings, on met ici le paramétrage spécifique au plugins utilisés, dans le ca présent pour le plugin series il existe 2 paramètrages :

• timeframe \ hour : pas utilisé encore mais ça ne devrait pas tarder. Cela permet d’indiquer à flexget qu’il faut attendre un certain temps entre la mise à disposition d’un torrent et son téléchargement. L’utilité : attendre qu’une nouvelle release soit disponible.
• timeframe \enough : ce paramètre est l’une des force de Flexget, il indique quelle qualité de release est suffisante. Les valeurs possibles sont 1080p, 1080, 720p, 720, hr, dvd, hdtv, dsr, dsrip. Ainsi quand on a pas de télé HD il est inutile de télécharger du 1080p.

Vient ensuite la section de paramétrages de chacune des séries où l’on indique le nom de la série (Serie1) et le flux RSS associé.

Le paramètre feeds \ Serie1 \ series, qui a dans mon cas Series1 comme valeur, permet d’indiquer quelle est la série à télécharger dans le cas d’un flux recensant plusieurs séries.

Et voila concernant mon paramétrage, il ne faut pas hésiter à aller sur le site de Flexget pour voir les nombreuses possibilités de ce logiciel (téléchargement de comics, génération de flux RSS) et plus particulièrement les autres paramétrage du plugin serie

Pour tester votr fichier de configuration :

./flexget.py -c /home/svc/bin/flexget/configFlexGet.yml --check

Exécution de flexget

Pour exécuter flexget il suffit de faire :

./flexget.py -c ~/flexget/configFlexGet.yml

On peut alors evidemment ajouter cette ligne de commande dans une tache Cron….