diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 69 |
1 files changed, 46 insertions, 23 deletions
@@ -4,20 +4,19 @@ yt-dlp-rajiko is an improved [radiko.jp](https://radiko.jp) extractor plugin for ## Installation -[Download the Python wheel](https://427738.xyz/yt-dlp-rajiko/dl/yt_dlp_rajiko-latest.whl) or `pip install ---extra-index-url https://427738.xyz/yt-dlp-rajiko/pip/ yt-dlp-rajiko` +[Download the Python wheel](https://427738.xyz/yt-dlp-rajiko/dl/yt_dlp_rajiko-latest.whl) or `pip install yt-dlp-rajiko` -Requires yt-dlp 2023.06.22 or above. +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 --index-url -https://427738.xyz/yt-dlp-rajiko/pip/ yt-dlp yt-dlp-rajiko` to install +yt-dlp with `pipx`, use `pipx inject yt-dlp yt-dlp-rajiko` to install the plugin in yt-dlp's environment. Otherwise, download the wheel, 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` (<a href="https://427738.xyz/yt-dlp-rajiko/i/installation-pluginsfolder.png">like this</a>) - anywhere else listed in [the yt-dlp documentation](https://github.com/yt-dlp/yt-dlp#installing-plugins). @@ -28,28 +27,52 @@ More information about yt-dlp plugins is available from [yt-dlp's documentation] ## Usage 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' +``` - # 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) -You can somewhat automate downloading programmes by using the search -page. +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. - # all programmes related to Toshiki Kadomatsu - yt-dlp 'https://radiko.jp/#!/search/live?key=角松敏生&filter=past®ion_id=all' - # specific programme from Osaka - yt-dlp 'https://radiko.jp/#!/search/live?key=world%20jazz%20warehouse&filter=past&area_id=JP27' +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'` -Just copying from the browser URL bar should work with no changes. +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 /persons/ URLs are the only place where that option works, as the information just isn't available for normal search results. -[Please see the website for more information](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/). +As a general rule, just copying from the browser URL bar should work with no changes. (if it doesn't, [let me know!](https://github.com/garret1317/yt-dlp-rajiko/issues)) -[日本語訳は公式サイトをご覧ください。](https://427738.xyz/yt-dlp-rajiko/index.ja.html) -サイトが無くなった場合は、多分[Internet ArchiveのWayback Machineにアーカイブされています](https://web.archive.org/web/*/https://427738.xyz/yt-dlp-rajiko/index.ja.html)。 +(Apparently on Windows it won't work unless you use "double quotes", but on Linux it won't work unless you use 'single quotes'. If the command doesnt work with one quote type then try the other.) + +**[You can find more usage tips on the website](https://427738.xyz/yt-dlp-rajiko/)** + +## How do I get help? + +[Open an issue on github](https://github.com/garret1317/yt-dlp-rajiko/issues) or [send a message via the "hate mail" form](https://427738.xyz/hate-mail.html). +You can also ping me [in the yt-dlp discord server](https://discord.gg/H5MNcFW63r), username `garret1317`. + +Please try to include a verbose log if you're reporting a problem, it helps with diagnosing the issue. + +## notes about this repository + +this is just where the source code and bug tracker live. most of the info is on the website. + +Generally you should use the release versions. +`master` branch usually works, but should be considered experimental and may have bugs |