ard-plus-dl

Ein kleines Skript bzw. Tool zum herunterladen von Videos bei ARD Plus.

Anforderungen

• Shell/Bash (z.B. macOS Terminal)
• jq
• yt-dlp
• Gnu-Tools: curl, grep, awk, echo, cut, sed, base64, tr
• ARD Plus Mitgliedschaft (14 Tage kostenlos)

Benutzung

Skript downloaden und ausführbar machen: chmod 755 ard-plus-dl.sh

Anschließend das Skript aufrufen und drei Parameter mitgeben: ./ard-plus-dl.sh <url> <username> <password>

• Gegen den Wind (Serie): https://www.ardplus.de/details/a0T0100000064DB-gegen-den-wind
• Lola rennt (Film): https://www.ardplus.de/details/a0S01000000EWYi-lola-rennt

Das Skript erkennt automatisch, ob es sich um einen Film oder eine Serie handelt. Filme werden unmittelbar geladen. Im Falle einer Serie werden alle gefundenen Staffeln aufgelistet und zur Auswahl angeboten.

Vor den drei Parametern kann optional noch "--automatic" angegeben werden: Falls dieses Flag übergeben wird, erfolgt der Download automatisch ohne Rückfrage; bei Serien werden dann automatisch alle Staffeln heruntergeladen. Falls der Download abbrechen oder z.B. eine Staffel nicht geladen werden sollte, kann das Skript einfach erneut gestartet werden; es werden nur die fehlenden Episoden heruntergeladen.

Die <url> ist die Übersichtsseite eines Films oder einer Serie bei ARD Plus, zum Beispiel Filme und Serien werden automatisch mit mehreren Tonspuren geladen (z.B. deutsch & englisch), sofern verfügbar. Auch die Untertitel werden berücksichtigt.

Es können zusätzlich zu Filmen und Serien auch ganze Tatort Ausgaben pro Stadt geladen werden, z.B. alle Folgen aus Bremen mit der URL: https://www.ardplus.de/kategorie/tatort-bremen

Die Zieldateien werden sinnvoll benannt, z.B.: S01E01 - Schönes Wochenende.mp4 oder Lola rennt (1998).mp4

Docker

Ein fertiges Docker Image kann über das vorhandene Dockerfile gebaut und benutzt werden.

1. Checkout:

git clone https://github.com/marco79cgn/ard-plus-dl.git

2. Build Docker image:

docker build -t ard-plus-dl .

3. Download content:

docker run --rm -it -v $(pwd)/:/data ard-plus-dl download 'https://www.ardplus.de/details/a0T01000003LeBR-vorstadtweiber' "username" "password"

Dabei wird das aktuelle Host Verzeichnis $(pwd) genutzt, aus dem der Befehl ausgeführt wird. Dort landen auch die Downloads. Wichtig: Unter Windows gibt es keinen $(pwd) Befehl. Hier muss das lokale Verzeichnis mit Backslashes gemountet werden, z.B.

docker run --rm -it -v C:\Users\marco\movies:/data ard-plus-dl download 'https://www.ardplus.de/details/a0T01000003LeBR-vorstadtweiber' "username" "password"

Optional:

Statt selbst ein Docker image zu bauen kann auch das existierende aus diesem Github Repository benutzt werden: ghcr.io/marco79cgn/ard-plus-dl.

In diesem Fall muss nichts selbst installiert oder gebaut werden. Es reicht dieser Befehl:

docker run --rm -it -v $(pwd)/:/data ghcr.io/marco79cgn/ard-plus-dl download '<url>' "username" "password"