aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorgarret <garret@airmail.cc>2024-04-01 21:04:25 +0100
committergarret <garret@airmail.cc>2024-04-01 21:04:37 +0100
commit69fff170663d6e2d258edca7503b2e7897227a76 (patch)
tree5362080058fe183cf474b1bf6a81785f67189a69 /README.md
parentd6ddd166722459c177980b27a80c56fe61c0f4c1 (diff)
downloadyt-dlp-rajiko-69fff170663d6e2d258edca7503b2e7897227a76.tar.gz
yt-dlp-rajiko-69fff170663d6e2d258edca7503b2e7897227a76.tar.bz2
yt-dlp-rajiko-69fff170663d6e2d258edca7503b2e7897227a76.zip
moving to a place under my sole control
information remains available on the website, which has been saved on the internet archive wayback machine
Diffstat (limited to 'README.md')
-rw-r--r--README.md99
1 files changed, 6 insertions, 93 deletions
diff --git a/README.md b/README.md
index f5023f1..db59ebc 100644
--- a/README.md
+++ b/README.md
@@ -1,100 +1,13 @@
-This repository contains a plugin package for [yt-dlp](https://github.com/yt-dlp/yt-dlp#readme).
-See [yt-dlp plugins](https://github.com/yt-dlp/yt-dlp#plugins) for more details.
-
# yt-dlp-rajiko
-yt-dlp-rajiko is an improved [radiko](https://radiko.jp) extractor for yt-dlp.
-
-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).
-
-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.
-
-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.
-
-```sh
-# all programmes related to 角松敏生
-yt-dlp 'https://radiko.jp/#!/search/live?key=角松敏生&filter=past&start_day=&end_day=&region_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=&region_id=&area_id=JP27&cul_area_id=JP27&page_idx=0'
-```
-Those example URLs were directly copied from the browser URL bar.
-
-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.
-
-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 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. 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".
+yt-dlp-rajiko is an improved [radiko.jp](https://radiko.jp) extractor plugin for yt-dlp.
-## Acknowledgements
+[Please see the website for more information, including installation and usage instructions](https://427738.xyz/yt-dlp-rajiko/).
+If the website is down, an archived copy may be available on [the Internet Archive's Wayback Machine](https://web.archive.org/web/*/https://427738.xyz/yt-dlp-rajiko/).
-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 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).
+More information about yt-dlp plugins is available from [yt-dlp's documentation](https://github.com/yt-dlp/yt-dlp#plugins).
-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).
+[詳しくは公式サイトまで](https://427738.xyz/yt-dlp-rajiko/)
-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.
+サイトが無くなった場合[Internet ArchiveのWayback Machineにアーカイブがある](https://web.archive.org/web/*/https://427738.xyz/yt-dlp-rajiko/)場合があります。