Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fbanning/ardaudiothek-dl

A simple Julia script to download audio files from ARD Audiothek
https://github.com/fbanning/ardaudiothek-dl

Last synced: about 1 month ago
JSON representation

A simple Julia script to download audio files from ARD Audiothek

Awesome Lists containing this project

README

        

# ardaudiothek-dl

This is a simple [Julia](julialang.org) script to download audio files from [ARD Audiothek](https://www.ardaudiothek.de/).

**Usual disclaimer:**
There's no guarantee here that this thing works as you would expect it to.
In fact, I myself wouldn't even expect it to work for the foreseeable future (or even right now for that matter but that's a different topic).
APIs and websites change all the time and public broadcasting companies aren't exactly known for their forward-looking decision-making when it comes to digitalisation.
So if there's something broken or if you're missing anything, feel free to fix it yourself or (preferrably) submit a bug report or PR to fix it together.

Having said that: Have fun! :)

## Usage

1. Clone the repository.
2. Run as [script](#script) or [package](#package).
3. Audio files are saved in the current working directory and have the format `# - t.mp3` where `#` is the episode number (if one exists) and `t` is the title of the file.

### Script

Run `julia ardaudiothek-dl-script.jl $ID` from your shell where `$ID` is the ARD Audiothek identifier of the audio file in question.
It is also possible to pass in multiple identifiers delimited by a single whitespace (e.g. `julia ardaudiothek-dl-script.jl 123 456`).

(Hint: The identifier can easily be retrieved by hovering over the file names on the ARD Audiothek website and looking at their URLs.)

### Package

Open Julia in the ardaudiothek-dl environment (remember to run `]instantiate` on first run) and then `include("ardaudiothek-dl.jl")`.
Finally invoke `download_from_id(id)` as many times as you want where `id` is the ARD Audiothek identifier of the audio file in question.

## License

See [LICENSE](LICENSE) file.