yt-dlp-rajiko

what is it

how do i install it

Download the plugin bundle or pip install yt-dlp-rajiko

Requires yt-dlp 2025.02.19 or above.

Use the pip command if you installed yt-dlp with pip. If you installed yt-dlp with pipx, use pipx inject yt-dlp yt-dlp-rajiko to install the plugin in yt-dlp's environment.

Otherwise, download the bundle, and place it in one of these locations:

• ~/.config/yt-dlp/plugins/ (on Linux and Mac)
• %appdata%\yt-dlp\plugins\ (on Windows)
• a yt-dlp-plugins folder next to your yt-dlp.exe (like this)
• anywhere else listed in the yt-dlp documentation.

You'll have to create those folders if they don't already exist.
There is no need to extract the zip file.

Here are the SHA256 checksums for the latest release:

4a288b04fb8e4102b15074644330ae189f7fb53af8bfd5827eb19cff6cd695e8  yt_dlp_rajiko-1.9.tar.gz
5800258edec65a4b5230679cee55fc186f05ed6e89c89a63acc698ce245dbb16  yt_dlp_rajiko-1.9.bundle.zip
106085f72608562f09bfb2319a1437922aca2d7df4f94af37ade4832b50b0ab1  yt_dlp_rajiko-1.9-py3-none-any.whl

If you're using pip/pipx, these should be verified automatically when you install.

source code + release notes

The source code is available via github, or the source tarball that the build generates.

If you'd like to be notified of new releases, you can subscribe by RSS: https://427738.xyz/yt-dlp-rajiko/CHANGELOG.xml
You can read that feed in your browser as well.

If you'd prefer to be notified by email, you can use an RSS to email service. I've tested Feedrabbit and found it to work, but other options are available. Alternatively, shoot me a message with your email address and I'll work something out.

how do i use it

simply:
# timefree download
yt-dlp 'https://radiko.jp/#!/ts/INT/20240308230000'
# live recording
yt-dlp 'https://radiko.jp/#!/live/CCL'
# live shorthand
yt-dlp 'https://radiko.jp/#FMT'

You can semi-automatically grab the latest episodes of programmes by using the search page, like this:
# single-station programme yt-dlp
'https://radiko.jp/#!/search/live?key=World Jazz Warehouse&filter=past'
# area filtering also works
yt-dlp 'https://radiko.jp/#!/search/live?key=tokyo speakeasy&filter=past&area_id=JP13'
(though of course you still need to be there to press the button)

If you can reliably get it in the search, you can somewhat-automate downloading it. If there's a programme that airs on multiple stations, the best way to filter down to the station you want is to use the search's 地域 (region) filter.

You can also get programmes that a person has appeared in, using the links from those little boxes on the side:
yt-dlp 'https://radiko.jp/persons/3363'


you can limit it to the "key station" only, like so:
yt-dlp 'https://radiko.jp/persons/33635' --extractor-args rajiko:key-station-only.

This is meant as an alternative to the region filter, for networked programmes where the same thing airs on multiple stations. Currently this is the only place where that option works, as the information just isn't available for normal search results.

As a general rule, just copying from the browser URL bar should work with no changes. (if it doesn't, let me know!)

Apparently on Windows it won't work unless you use "double quotes", but on Linux it won't work unless you use 'single quotes'. I've tried to put some code in here to change it to "double quotes" if you're on windows, but idk if it actually works. If the command doesnt work with one quote type then try the other.

recommended settings

yt-dlp's default settings aren't ideal for yt-dlp-rajiko. These are the settings I use to make it better.

TL;DR: -N 30 --embed-metadata --embed-thumbnail -o "%(title)s %(timestamp+32400>%Y-%m-%d_%H%M)s [%(id)s].%(ext)s" (put that in an alias)
+ --download-archive "archive" --break-on-existing --break-per-input if using the search page

Metadata

yt-dlp's default settings don't expose any metadata except the title.

Add the argument --embed-metadata to your command. This will embed the show name, description, station name and airdate into the file, as tags that should be picked up by a decent media player. It also embeds the tracklist of songs played, as timestamped chapters.

You can also add --embed-thumbnail to add the show image as cover art, which your media player can display.

I use an output template to add the airdate into the filename as well:
-o "%(title)s %(timestamp+32400>%Y-%m-%d_%H%M)s [%(id)s].%(ext)s" -> World Jazz Warehouse 2024-05-19_2300 [CCL-20240519230000].m4a
+32400 is the JST time offset (+9h) in seconds, since yt-dlp's timestamps are all in UTC.

Sample mediainfo output

Efficiency

You can use -N (multi-threaded download) to increase download speed. I use about 10. Normally you should use a smaller amount, but radiko (and NHK) seem to need more. I think it's because the audio fragments are such small filesize, the speed can only ramp up so much before it finishes. But if you put a good amount of threads you can take advantage of your full connection.

If you're using search queries, you should:

• filter for タイムフリー (timefree), so you don't get episodes that haven't aired yet.
• use --download-archive, so episodes you've already downloaded don't get downloaded again
• Use --break-on-existing and --break-per-input, and then you can stop once you've got the latest episode, skipping scraping older episodes entirely.

That way you can avoid scraping any more than necessary. (faster for you, less load on radiko, everyone wins)

This section used to recommend --playlist-reverse for search, as the search results were returned oldest-first. This is no longer the case- the API has started returning results newest-first (October 2024).

putting it all together

It would be a pain to type/paste all those arguments onto the command every time. You can make an alias in your yt-dlp config, so you can just type one short thing and get all of the settings.

Make a config file in one of the supported locations, and add --alias rdk 'PASTE THE ARGUMENTS HERE' to it. Then when you want to download from radiko, do yt-dlp 'url' --rdk and it'll all "just work™". Unfortunately site-specific config isn't possible (yet?), so you will have to remember to add that --rdk every time.

If you're going to be using the search pages regularly, you should put your command into a shell/batch/etc script. That way you can just run it after the programme(s) you're interested in have aired, with no extra faff.

Extractor arguments

You can configure yt-dlp-rajiko with extractor arguments. Mostly these are just for development purposes, or disabling workarounds if you have some special setup.

• device - this specifies the streams you get. Defaults are aSmartPhone7a for live and 7-day timefree, pc_html5 for 30-day timefree. here is a list of known devices
  
• key_station_only - returns only results from the "key station". Meant for networked programmes, so you don't end up downloading e.g. 36 variants of the same thing. Currently only works with radiko.jp/persons/ URLs.
  
• no_stream_blacklist - disables skipping of streams that don't work with FFmpeg. For example if you use a different downloader
  
• no_as_live_chunks - disables the "chunking" workaround for downloading as-live formats quickly.
  

You can set the flags like this:
--extractor-args rajiko:key-station-only
or, when it's an argument that needs an input, like this:
--extractor-args rajiko:device=pc_html5

Setting multiple at a time is a bit more complicated. The full syntax is described in the yt-dlp documentation.

how do i get help

Open an issue on github or send a message via the form.
You can also ping me in the yt-dlp discord server, username garret1317.

Please try to include a verbose log if you're reporting a problem, it helps with diagnosing the issue.

misc notes/writings

You can find various notes/jottings on a dedicated page. These were formerly hosted on the github wiki.

acknowledgements

The mobile spoofing code is almost entirely copied from the rajiko browser extension by jackyzy823, released under the Unlicense. You can read his write-up (in Chinese) here.

The authentication code, and some parts of the metadata extraction, have been adapted from yt-dlp's radiko extractor, which was primarily authored by Lesmiscore (also released under the Unlicense).