diff options
| -rw-r--r-- | README.md | 98 |
1 files changed, 67 insertions, 31 deletions
@@ -3,62 +3,98 @@ See [yt-dlp plugins](https://github.com/yt-dlp/yt-dlp#plugins) for more details. # yt-dlp-rajiko -This plugin adds an improved [radiko](https://radiko.jp) extractor to yt-dlp. +yt-dlp-rajiko is an improved [radiko](https://radiko.jp) extractor for yt-dlp. -It bypasses radiko's geo-block using the same technique as the [rajiko](https://github.com/jackyzy823/rajiko/) browser extension by jackyzy823 (from which this plugin gets its name). You can read their write-up (in Chinese) [here](https://jackyzy823.github.io/tech/battle-with-radiko.html). +It bypasses radiko's geo-block by impersonating the mobile app. +This the same technique as the [rajiko](https://github.com/jackyzy823/rajiko/) browser extension by jackyzy823 (from which this plugin takes its name). -More metadata is extracted for timefree programmes, including tracklists (as chapters). -Only the station metadata is extracted for live streams, not the programme that's airing at the time. +Timefree programmes have more better metadata, including tracklists (as chapters). +Only the station metadata is extracted for the live streams, not the programme that's airing at the time. -You should use `-N` (multi-threaded download) to increase download speed for timefree programmes. +Some effort is made to support share links and radiko embeds, but they don't recieve regular testing/[dogfooding](https://en.wikipedia.org/wiki/Eating_your_own_dog_food). + +If you find a problem or have a question, please open a github issue. + +yt-dlp-rajikoはyt-dlpで、radiko(ラジコ)の生配信とタイムフリー番組をダウンロードできるyt-dlpプラギンです。 + +スマホアプリをなりすまして、地域制限が完全にバイパスできます。 この方法は[jackyzy823の「rajiko」というブラウザ拡張機能](https://github.com/jackyzy823/rajiko)と同じです。 +jackyzy823の中国語での記事は[こちら](https://jackyzy823.github.io/tech/battle-with-radiko.html)で読める。 + +もし問題や質問があれば、イシューを提出してください。 +申し訳ありませんが、私には日本語が難しいので、できれば、イシューは英語で書いてください。 + +## Installation + +Requires yt-dlp `2023.06.22` or above. + +You can install this package with pip: +``` +python3 -m pip install -U https://github.com/garret1317/yt-dlp-rajiko/archive/master.zip +``` +but i don't update the version number ever, so i'm not sure how well that'll work when updates happen. + +See [installing yt-dlp plugins](https://github.com/yt-dlp/yt-dlp#installing-plugins) for other ways this plugin package can be installed. + +## Usage + +simply +```sh +# timefree download +yt-dlp 'https://radiko.jp/#!/ts/INT/20240308230000' +# live recording +yt-dlp 'https://radiko.jp/#!/live/RN1' +``` + +**Pro Tip:** You should use `-N` (multi-threaded download) to increase download speed. You can somewhat automate downloading programmes by using the search page. -For instance, if I wanted all episodes of JET STREAM from K-MIX, i'd search for `jet stream` with the region set to Shizuoka (`JP22`). I'd also filter for just timefree, to avoid needlessly extracting yet-to-air programmes. -Personally, I have a shell script with a load of search URLs that are piped to yt-dlp. I run this script when I want to download new episodes of the programmes I listen to. +```sh +# all programmes related to 角松敏生 +yt-dlp 'https://radiko.jp/#!/search/live?key=角松敏生&filter=past&start_day=&end_day=®ion_id=all&area_id=JP26&cul_area_id=JP26&page_idx=0' +# specific programme, limited to certain region +yt-dlp 'https://radiko.jp/#!/search/live?key=world%20jazz%20warehouse&filter=past&start_day=&end_day=®ion_id=&area_id=JP27&cul_area_id=JP27&page_idx=0' +``` +Those example URLs were directly copied from the browser URL bar. -An effort is made to support share links and radiko embeds. However, I don't use these features often myself, so they don't recieve regular testing. Issues are welcome. +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. -This extractor uses an API key obtained by reverse-engineering the radiko mobile app. As such, I've been advised that it would be risky to merge it into yt-dlp proper. +I recommend: + +- filtering for `タイムフリー` (timefree), so you don't get episodes that haven't aired yet. +- using a download archive +- `--playlist-reverse` - the search is ordered oldest-first, so reverse it to get newest first + - `--break-on-existing` (with `--break-per-input`) - and then you can stop once you've got the latest, skipping older episodes you've already got + +to avoid scraping any more than necessary. (faster for you, less load on radiko, everyone wins) + +Once you've written your command, you can put it into a shell/batch/etc script, so you can run it after the programme(s) you're interested in have aired. ## Extractor args You can choose which device's streams to extract with the `device` extractor arg. -For instance, `--extractor-args radikotimefree:device=pc_html5` would extract the website's streams. +For instance, `--extractor-args radikotimefree:device=pc_html5` would extract the streams the website uses. + +There is no benefit to using this. It only exists to make development/investigation easier. Known devices: - `pc_html5` - the website. has every stream provider. -- `aSmartPhone5`, `aSmartPhone6`, `aSmartPhone6a`, `aSmartPhone7a`, `aSmartPhone7`, `pc_1` - old mobile apps, + old website. "happy path" streams. +- `aSmartPhone5`, `aSmartPhone6`, `aSmartPhone6a`, `aSmartPhone7a`, `aSmartPhone7`, `pc_1` - old mobile apps, + old website. the "happy path". - `MobileWebTrial` - current mobile site. - `aSmartPhone8` - current mobile app. - `xExternalWebStations` - embedded players on stations' websites. same streams as `aSmartPhone8`, though the api response isn't exactly the same. The default is `aSmartPhone7a` as its streams are always the "happy path". -Ideally you shouldn't need to use this, it's just to make investigating new devices easier. - -## Installation - -Requires yt-dlp `2023.01.02` or above. - -You can install this package with pip: -``` -python3 -m pip install -U https://github.com/garret1317/yt-dlp-rajiko/archive/master.zip -``` -but i don't update the version number ever, so i'm not sure how well that'll work when you need to update - -See [installing yt-dlp plugins](https://github.com/yt-dlp/yt-dlp#installing-plugins) for the other methods this plugin package can be installed. - ## Acknowledgements The mobile spoofing code is based heavily on the [rajiko](https://github.com/jackyzy823/rajiko/) browser extension by jackyzy823, released under the Unlicense. -In particular, the fake phone details and GPS coordinate generation code was copied almost verbatim, with just a few changes for python syntax. -And of course, the mobile API key itself, without which this extractor would not have been possible, was originally obtained by jackyzy823. +In particular, the fake phone details and GPS coordinate generation code have been copied almost verbatim. +And of course, the mobile API key was (to the best of my knowledge) originally obtained by jackyzy823. You can read their write-up (in Chinese) [here](https://jackyzy823.github.io/tech/battle-with-radiko.html). -The authentication code, and some parts of the metadata extraction, were adapted from [yt-dlp's radiko extractor](https://github.com/yt-dlp/yt-dlp/blob/d1795f4a6af99c976c9d3ea2dabe5cf4f8965d3c/yt_dlp/extractor/radiko.py), which was primarily authored by Lesmiscore (also released under the Unlicense). +The authentication code, and some parts of the metadata extraction, have been adapted from [yt-dlp's radiko extractor](https://github.com/yt-dlp/yt-dlp/blob/d1795f4a6af99c976c9d3ea2dabe5cf4f8965d3c/yt_dlp/extractor/radiko.py), which was primarily authored by Lesmiscore (also released under the Unlicense). ----- - -すみません、日本語はまだあまり上手ではありません。だから、このREADMEは英語で書きました。 +This extractor uses an API key obtained by reverse-engineering the radiko mobile app. As such, I've been advised that it would be risky to merge it into yt-dlp proper. |