Download audio from ARD audiothek.
Find a file
2025-08-28 22:22:42 +02:00
graphql feat(main): Add support for new urn-styled URLs 2025-08-28 22:18:29 +02:00
rename_templates feat(main): add support for rename templates 2025-06-09 15:26:05 +02:00
screenshots docs(main): Add screenshot 2025-08-28 22:22:42 +02:00
.gitignore fallback to url if downloadurl is empty 2024-05-17 21:36:48 +02:00
audiothek.py feat(main): Add support for new urn-styled URLs 2025-08-28 22:18:29 +02:00
LICENSE Initial commit 2023-01-06 22:06:09 +01:00
README.md docs(main): Add screenshot 2025-08-28 22:22:42 +02:00
requirements.in feat(main): add support for rename templates 2025-06-09 15:26:05 +02:00

This script can download mp3s and covers from ARD audiothek. This project is a Fork.

Installation

git clone "https://github.com/Schluggi/audiothek-downloader.git"
cd audiothek-downloader
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.in

Usage

python3 audiothek.py \
--url 'https://www.ardaudiothek.de/sendung/grimms-maerchen-und-verbrechen/urn:ard:show:b739e5e19ba7f23c/' \
--directory ./output \
--group-episodes \ 
--square-images

Screenshots

tree-view.png

Supported URL-Types

Here is the information refactored into a Markdown table:

URL-Type Description Example URL
show (Sendung) A single show, e.g. a podcast or radio show https://www.ardaudiothek.de/sendung/grimms-maerchen-und-verbrechen/urn:ard:show:b739e5e19ba7f23c/
publication (Episode) A single episode of a show https://www.ardaudiothek.de/episode/urn:ard:publication:87d9866e81da85d0/

Arguments

Argument Short Type Default Required Description
--url -u str - Yes Insert Audiothek URL (e.g. https://www.ardaudiothek.de/sendung/...)
--directory -f str output No Directory to save all MP3s
--square-images -s bool False No Download images in 1:1 aspect ratio instead of widescreen
--group-episodes -g bool False No Group episodes into their own subdirectories