Ce programme interroge les serveurs de télévision de rattrapage et télécharge les émissions souhaitées et les enregistre sur un disque selon une organisation reconnue par des programmes comme PLEX ou EMBY. Les métadonnées (titre des émissions, desciption, vignettes) sont placées de façon à être directement reconnues par Emby (à tester dans Plex).
./aspiratv -provider=artetv -destination=$HOME/Videos/DL download "La minute vieille"
./aspiratvCette commande vérifie les serveurs et télécharge les épisodes qui ne le sont pas encore.
Les contenus mis à disposition par les diffuseurs sont soumis aux droits d'auteur. Ne les utilisez pas en dehors du cadre privé.
Aspiratv ne fait que garder une copie de l’œuvre sur votre disque dur, comme vous l'auriez fait avec votre enregistreur vidéo, votre box TV ou une clé USB branchée sur votre TV. Cette opération est seulement rendue plus simple qu'en gérant manuellement les enregistrements.
Le fonctionnement de ce programme n'est pas garanti. Notamment, les fournisseurs de contenus sont susceptibles de changer leurs APIs ou interdire leur utilisation sans pré-avis.
- FFMPEG: ffmpeg est utilisé pour convertir le flux vidéo en fichiers mp4. l'exécutable doit être disponible dans votre système. Page de téléchargement pour Windows: https://ffmpeg.zeranoe.com/builds/
Les binaires pour Windows, Linux et FreeBSD sont directement disponibles sur la page releases. Les binaires n'ont pas de dépendance autre que FFMPEG et n'ont pas besoin d'être installés.
- Télécharger les binaires correspondant à votre système sur la page de la dernière release de le répertoire de votre choix.
- Puis décompresser l'archive
tar -czvf aspiratv_0.4.0_Linux_x86_64.tar.gz
Usage of ./aspiratv:
-config string
Configuration file name. (default "config.json")
-debug
Debug mode.
-destination string
Provider to be used with download command. Possible values : artetv,francetv,gulli
-force
Force media download.
-headless
Headless mode. Progression bars are not displayed.
-log string
Give the log file name. When empty, no log.
-max-aged int
Retrieve media younger than MaxAgedDays.
-max-tasks int
Maximum concurrent downloads at a time. (default 8)
-provider string
Provider to be used with download command. Possible values : artetv,francetv,gulli
-write-nfo
Write NFO file for KODI,Emby,Plex... (default true)
Le programme fonctionne selon deux modilités :
Dans ce mode, le fichiers de configuration config.json placé dans le même répertoire que le programe est lu pour pour interroger les différents serveur.
L'option -headless désactive les barres de progressions et produit une log sur la console.
Note: L'option -server a été supprimée. Pour interroger automatiquement les serveur, ajouter une ligne dans crontab, ou une tâche planifiée dans windows.
L'option -config indique le fichier de configuration à utiliser.
./aspiratv -provider=francetv -destination=$HOME/Videos/DL download "Les Dalton"Cette commande cherchera les épisodes de la série "Les Dalton" sur france télévisions, et les téléchargera dans le répertoire ~/Video/DL
Ajoute au fichier de log des informations utiles au débugage.
Télécharge toutes les émissions correspondant à la liste de recherche, même si elles ont été déjà téléchargées.
L'option -log redirige les messages d'erreur dans le fichier indiqué.
Le fichier config.json contient les paramètres et la liste des émissions que l'on souhaite télécharger :
{
"Destinations": {
"Documentaires": "${HOME}/Videos/Documentaires",
"Jeunesse": "${HOME}/Videos/Jeunesse",
"Séries": "${HOME}/Videos/Series",
"News": "${HOME}/Videos/News"
},
"Providers": {
"artetv": {
"Enabled": false
},
"gulli":{
"Enabled": true,
},
"francetv":{
"Enabled": true
}
},
"WatchList": [
{
"Show": "Doctor Who",
"Title": "",
"Pitch": "",
"Provider": "francetv",
"Destination": "Séries"
},
{
"Show": "Oggy et les cafards",
"Pitch": "",
"Provider": "gulli",
"Destination": "Jeunesse"
},
]
}Défini les répertoires de destination des fichiers. A noter que les variables d'environnement peuvent être utilisées.
Donne la liste des critères de recherche pour sélectionner les émissions à télécharger. L'ensemble des critères non vides doit être satisfait. Ils sont évalués dans l'ordre suivant :
- Provider: code du fournisseur de contenu
- Show : nom de l'émission
- Title: titre de l'émission ou de l'épisode
- Pitch: description de l'émission Le contenu du critère doit être contenu dans le champ correspondant obtenu sur le serveur de la télévision.
- Destination: code du répertoire où les fichiers doivent être téléchargés, dont la définition est placée dans la section Destinations
Chaque provider peut traiter spécifiquement les recherches.
Un provider est un package du logiciel permettant d'implémenter les différents connecteurs. Les connecteurs disponibles sont :
Ce connecteur permet de surveiller les programmes en replay des chaînes France 2, France 3, France 4, France 5, France Ô, et La 1ère.
Ce connecteur permet de surveiller les programmes de la chaîne Arte
Les playlists Arte peuvent être surveillées pour que les nouveaux épisodes soit téléchargés dès leur disponibilité.
Ce connecteur permet de surveiller les programmes de la chaîne Gulli. Attention Gulli tronque le nom des shows. Il convient de paramétrer les recherches avec les noms tronqués.
Créez une médiathèque de type "TV". Les réglages par défaut conviennent bien. Les données pourront être complétés si la série est connue des sites tesl de ImDB,Fanart...
Pour obtenir un résultat acceptable, il faut configurer une librairie de type "Séries TV" en utilisant l'agent "Personal Media Shows" afin que plex utilise les titres et les imagettes téléchargées depuis le serveur de la télévision. Veillez à ce que l'agent "Local Media Assets (TV)" soit placé en tête de liste des agents pour les Séries / Personal Media Shows (voir cette page) .
Vous devez avoir un compilateur pour le langage GO.