From 3cf478a58d81a37cc49a9055ba72582dd2d74365 Mon Sep 17 00:00:00 2001 From: garret Date: Mon, 26 Aug 2024 16:13:21 +0100 Subject: add useful information back to the readme --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 46 insertions(+), 4 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 1a59bfc..31b8601 100644 --- a/README.md +++ b/README.md @@ -2,12 +2,54 @@ yt-dlp-rajiko is an improved [radiko.jp](https://radiko.jp) extractor plugin for yt-dlp. -[Please see the website for more information, including installation and usage instructions](https://427738.xyz/yt-dlp-rajiko/). +## Installation -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/). +[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` + +Requires yt-dlp 2023.06.22 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 +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) + - anywhere else listed in [the yt-dlp + documentation](https://github.com/yt-dlp/yt-dlp#installing-plugins). + +You'll have to create those folders if they don't already exist. More information about yt-dlp plugins is available from [yt-dlp's documentation](https://github.com/yt-dlp/yt-dlp#plugins). -[詳しくは公式サイトをご覧ください](https://427738.xyz/yt-dlp-rajiko/index.ja.html) +## 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' + +You can somewhat automate downloading programmes by using the search +page. + + # 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' + +Just copying from the browser URL bar should work with no changes. + +---- + +[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/). -サイトが無くなった場合は、おそらく[Internet ArchiveのWayback Machineにアーカイブされています](https://web.archive.org/web/*/https://427738.xyz/yt-dlp-rajiko/index.ja.html)。 +[日本語訳は公式サイトをご覧ください。](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)。 -- cgit v1.2.3-70-g09d2 From 8040cd476aea513884a8897efb2f0253ed34d6db Mon Sep 17 00:00:00 2001 From: garret1317 Date: Sat, 17 May 2025 22:22:19 +0100 Subject: bump yt-dlp version requirement --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index 31b8601..35906ab 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ yt-dlp-rajiko is an improved [radiko.jp](https://radiko.jp) extractor plugin for [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` -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 -- cgit v1.2.3-70-g09d2 From e9790a7589dd9b2b4ebb2c27763ff56ba37e4647 Mon Sep 17 00:00:00 2001 From: garret1317 Date: Sun, 18 May 2025 12:49:37 +0100 Subject: update readme --- README.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 35906ab..7519d82 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,8 @@ yt-dlp-rajiko is an improved [radiko.jp](https://radiko.jp) extractor plugin for yt-dlp. +[日本語訳はこちら](https://427738.xyz/yt-dlp-rajiko/index.ja.html) + ## Installation [Download the Python wheel](https://427738.xyz/yt-dlp-rajiko/dl/yt_dlp_rajiko-latest.whl) or `pip install @@ -46,10 +48,12 @@ page. Just copying from the browser URL bar should work with no changes. +## notes about this repository + +Generally you should use the release versions. +`master` branch usually works, but should be considered experimental and may have bugs + ---- [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/). - -[日本語訳は公式サイトをご覧ください。](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)。 -- cgit v1.2.3-70-g09d2 From 438bf8f69595db9b33d81b0c820c0989f68c2f57 Mon Sep 17 00:00:00 2001 From: garret1317 Date: Sat, 24 May 2025 21:08:08 +0100 Subject: update readme --- README.md | 51 +++++++++++++++++++++++++++++++++------------------ 1 file changed, 33 insertions(+), 18 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 7519d82..e93f475 100644 --- a/README.md +++ b/README.md @@ -30,30 +30,45 @@ 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. + +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)) + +(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/)** ## 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 - ----- - -[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/). -- cgit v1.2.3-70-g09d2 From 73006bef2d0718607fb2926ce1ebd51281e2e7d5 Mon Sep 17 00:00:00 2001 From: garret1317 Date: Sun, 22 Jun 2025 00:32:24 +0100 Subject: update readme --- README.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index e93f475..1546867 100644 --- a/README.md +++ b/README.md @@ -2,24 +2,21 @@ yt-dlp-rajiko is an improved [radiko.jp](https://radiko.jp) extractor plugin for yt-dlp. -[日本語訳はこちら](https://427738.xyz/yt-dlp-rajiko/index.ja.html) - ## 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 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` (like this) - anywhere else listed in [the yt-dlp documentation](https://github.com/yt-dlp/yt-dlp#installing-plugins). @@ -66,6 +63,13 @@ As a general rule, just copying from the browser URL bar should work with no cha **[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. -- cgit v1.2.3-70-g09d2 From f0067f1e256446727fdcf0eabeffea471ea87cfc Mon Sep 17 00:00:00 2001 From: garret1317 Date: Sun, 14 Sep 2025 21:07:09 +0100 Subject: update readme to link to plugin bundle --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 1546867..af01297 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ 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 yt-dlp-rajiko` +[Download the plugin bundle](https://427738.xyz/yt-dlp-rajiko/dl/yt_dlp_rajiko-latest.bundle.zip) or `pip install yt-dlp-rajiko` Requires yt-dlp 2025.02.19 or above. @@ -12,7 +12,7 @@ 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 wheel, and place it in one of these locations: +Otherwise, download the plugin bundle, and place it in one of these locations: - `~/.config/yt-dlp/plugins/` (on Linux and Mac) - `%appdata%/yt-dlp/plugins/` (on Windows) @@ -21,6 +21,7 @@ Otherwise, download the wheel, and place it in one of these locations: documentation](https://github.com/yt-dlp/yt-dlp#installing-plugins). You'll have to create those folders if they don't already exist. +There is no need to unzip the plugin bundle. More information about yt-dlp plugins is available from [yt-dlp's documentation](https://github.com/yt-dlp/yt-dlp#plugins). -- cgit v1.2.3-70-g09d2