mediathek-dl
Mit diesem python tool kannst du mehrere Medien auf einmal aus den Mediatheken (Arte, ARD, 3SAT....) herunterladen. Damit ist es eine Alternative auf der Kommandozeile zur Website mediathekviewweb.de und bringt schließt damit ein paar Lücken:
- läuft auf der Komandozeile, kann also auch direkt auf einem Web- oder Fileserver etc. eingesetzt werden.
- kann viele Medien auf einmal runterladen, so können beispielsweise Mehrteiler und Serien bequem heruntergeladen werden.
- speichert die Dateien unter ihrem korrekten Titelnamen ab, für Mehrteiler/Serien auch in einem Format das z.B. von Emby gelesen werden kann.
- kann die Downloadbefehle auch über
ssh curl/wget
ausführen und muss damit nichtmal auf dem server selbst installiert werden - unbeliebige Ergebnisse können über frei wählbare Stichworte auch ausgeblendet werden, z.B. die "Hörfassung"
Derzeitiges Hauptproblem: Die Daten werden derzeit über den MediathekViewWeb Feed ausgelesen, leider wird dort nur der Download zur höchsten Qualität angegben.
Installation
1.a) Clone this repository
git clone https://github.com/ezzra/mediathek-dl
1.b) OR download the zip and unpack it
https://github.com/ezzra/mediathek-dl/archive/master.zip
2.a) open the folder and create an environment using pipenv
(if you have installed)
pipenv install
then run mediathek-dl
from your command line using this environment
pipenv run python mediathek-dl -h
2.b) OR open the folder and install the requirements using pip
pip3 install -r requirements.txt
then run mediathek-dl
from your command line
python3 mediathek-dl -h
Usage
Easiest way to make mediathek-dl
work is just
python3 mediathek-dl 'The War'
This will download ALL the media files that are found on mediathekviewweb.de with this searchstring. Normally that would be too much, check in the Repo how to improve your searchstring. For our example we could use:
python3 mediathek-dl '!arte The War Geschichte' -t
This will show you all 14 parts of the documentary miniseries "The War" and nothing else. The -t
or --test
here lets you check first for your results. You can check it also more comfy using the search on mediathekviewweb.de.
However, this command will start downloading the miniseries
python3 mediathek-dl '!arte The War Geschichte'
\
and it will create a folder structure like
The War/Season 01/The War - s14e01 - Ein notwendiger Krieg.mp4
Checkout the help page for more functionality (reducing the result by negative searchstring, various output formats, ...)
positional arguments:
search_string the search string for the medias you want to download
target_folder folder where the media will be stored
optional arguments:
-h, --help show this help message and exit
-o {save,wget,ssh,test,curl}, --output {save,wget,ssh,test,curl}
output format
--ssh SSH if output is ssh, you need to give your user@localhost
server address
-b, --blindness show videos with "Hörfassung" in title (disabled by
default)
-n NOT_SEARCH, --not_search NOT_SEARCH
words you want to exclude from result, for example
"Hörfassung" (separate multiple by commata)
-v, --verbose show verbose output
-t, --test just show list of titles