update readme

1 files changed, 33 insertions, 18 deletions

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&region_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/).