Mit diesem Script können die aktuell verfügbaren Tatort Folgen (alle Seiten von https://www.daserste.de/unterhaltung/krimi/tatort/videos/index.html) gesichert werden. Zusätzlich zum Download der Folgen werden sie, sofern möglich, mittels der API von TVDB benannt. Mit entsprechenden Änderungen im Script an den Pfaden kann das Tool natürlich auch für jede andere Serie verwendet werden. Dafür müssen GANZE_FOLGEN_URL sowie TVDB_SERIES_ID entsprechend angepasst werden.
Hierbei handelt es sich keinesfalls um ein 100% stabiles Archivierungstool, die Fehlerbehandlung ist minimal, die Anpassung auf die ARD Mediathek nur sehr eingeschränkt und nicht abgesichert gegen große Änderungen an der Website.
In der aktuellen Version sucht der Download die best mögliche Videoqualität bis FullHD ("best[height<=?1080]"). Zur Zeit wird noch keine 4k Version der Folgen von der ARD ausgeliefert.
Vor Start des Scripts müssen die Abhängigkeiten aus dem requirements.txt File installiert werden. Dafür pip install -r requirements.txt ausführen.
Danach kann das Script ausgeführt werden oder als crontab hinterlegt werden. Beispielsweise für eine Ausführung jede Nacht um 23:45h und gesicherten logs:
45 23 * * * python3 /tatort-dl.py >> /tatort-dl.log 2>&1
Zur Ausführung wird ein .env File im gleichen Verzeichnis benötigt. In diesem .env File werden relevante Variablen hinterlegt:
TVDB_USER_NAME=""
TVDB_USER_KEY=""
TVDB_API_KEY=""
SAVE_PATH=""
ARCHIV_FILE=""
benötigt wird ein API Zugang zu TVDB (siehe https://thetvdb.com/api-information) zur Zuordnung.
Egebnis der Benennung ist dann zb s2018e02_Odenthal-66-Kopper zur
- Identifikation der Folge 02
- aus dem Jahr 2018
- mit Kommisarin Odenthal
- der 66te Folge mit ihr als Kommisarin
- mit Titel Kopper
Gespeichert werden die Dateien in Ordnern gemäß der Season im konfigurierbaren SAFE_PATH.
Das Beispiel erzeugt $SAVE_PATH/Season2018/s2018e02_Odenthal-66-Kopper.mp4.
damit das Script zb per cron periodisch ausgeführt werden kann und dabei nicht jede Folge mehrfach heruntergeladen wird, werden die Folgen die bereits vollständig heruntergeladen wurden, in einem Archiv File gelistet. Dieses File kann beliebig angegeben werden mittels ARCHIV_FILE im .env File.