diff --git a/README.md b/README.md
index 500ebd3..3533246 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,10 @@ Local stats dashboard — watch time, anime library, vocabulary growth, mining t
 ### Integrations
 
 <table>
+  <tr>
+    <td><b>YouTube</b></td>
+    <td>App-owned subtitle picker with downloaded/native track selection and local fallback generation</td>
+  </tr>
   <tr>
     <td><b>AniList</b></td>
     <td>Automatic episode tracking and progress sync</td>
diff --git a/changes/2026-03-23-immersion-youtube.md b/changes/2026-03-23-immersion-youtube.md
index 32c8d2e..b4ed4d5 100644
--- a/changes/2026-03-23-immersion-youtube.md
+++ b/changes/2026-03-23-immersion-youtube.md
@@ -4,3 +4,4 @@ area: launcher
 - Added an app-owned YouTube subtitle flow that pauses mpv, lets the overlay picker choose tracks, and injects downloaded subtitle files before playback resumes.
 - Added absPlayer-style YouTube timedtext parsing/conversion so downloaded subtitle tracks load as parsed cues for the sidebar, tokenization, and mining flows.
 - Added yt-dlp metadata probing so YouTube playback and immersion tracking keep canonical video and channel metadata.
+- Hardened the YouTube picker against duplicate submissions and tightened YouTube URL detection so follow-up runtime flows only treat real YouTube hosts as YouTube playback.
diff --git a/docs-site/usage.md b/docs-site/usage.md
index 7c938f3..a4a7693 100644
--- a/docs-site/usage.md
+++ b/docs-site/usage.md
@@ -228,12 +228,13 @@ If you also use Yomitan in a browser, configure that browser profile separately;
 ### YouTube Playback
 
 `subminer` accepts direct URLs (for example, YouTube links) and `ytsearch:` targets.
-For YouTube playback, SubMiner now generates or downloads subtitle tracks before mpv starts, then launches mpv with the resolved subtitle files attached.
+For YouTube playback, SubMiner now resolves subtitle tracks before mpv starts playback: it pauses at startup, opens an overlay subtitle picker, resolves the selected tracks, then resumes with the downloaded subtitle files attached.
 
 Notes:
 
 - Install `yt-dlp` so mpv can resolve YouTube streams and subtitle tracks reliably.
-- For YouTube URLs, `subminer` now generates any missing subtitles before mpv launch.
+- For YouTube URLs, the overlay picker lets you choose the primary and optional secondary subtitle tracks before playback resumes.
+- For YouTube URLs, `subminer` generates only the missing tracks after probing YouTube's native/manual subtitle inventory.
 - It probes manual/native YouTube subtitle tracks first, then falls back to local `whisper.cpp` only for missing tracks.
 - Primary subtitle target languages come from `youtubeSubgen.primarySubLanguages` (defaults to `["ja","jpn"]`).
 - Secondary target languages come from `secondarySub.secondarySubLanguages` (defaults to English if unset).