Skip to content

Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.

docs(players): fix header option names

Samir Hossainsd7943e1fac50
diff --git a/docs/players.md b/docs/players.md
index 1160f7f..558bdd2 100644
--- a/docs/players.md
+++ b/docs/players.md
@@ -21,9 +21,9 @@ detected player and saves the chosen player as the next default unless
| Player | Invocation | Notes |
|---|---|---|
-| mpv | `mpv --autofit=WxH --geometry=50%:50% --idle=no --keep-open=no [--referrer=..] [--user-agent=..] [--sub-file=..] <url>` | Window sized to the terminal. Flatpak mpv is launched via `flatpak run`. |
+| mpv | `mpv --autofit=WxH --geometry=50%:50% --idle=no --keep-open=no [--http-header-fields=..] [--sub-file=..] <url>` | Window sized to the terminal. Flatpak mpv is launched via `flatpak run`. |
| VLC | `vlc --width=W --height=H --play-and-exit [--http-referrer=..] [--http-user-agent=..] [--sub-file=..] <url>` | |
-| IINA | `iina-cli --keep-running --no-stdin --mpv-autofit=.. --mpv-<option> .. <url>` | Uses the bundled `iina-cli`; falls back to `open -a IINA <url>` only if the CLI is absent. |
+| IINA | `iina-cli --keep-running --no-stdin --mpv-autofit=.. --mpv-http-header-fields=.. --mpv-sub-files=.. <url>` | Uses the bundled `iina-cli`; falls back to `open -a IINA <url>` only if the CLI is absent. |
| Android / Proot | `termux-open --chooser --content-type video/* <url>` (or absolute `/system/bin/am start` fallback, ensuring `.so` injections are dropped) | Opens an app chooser on the device. Real-device chooser behavior should be confirmed for each release. |
Window size is derived from the live terminal size times the real font cell size
@@ -32,9 +32,9 @@ Window size is derived from the live terminal size times the real font cell size
## Headers
Playback sources (e.g. 4KHD) may carry `Referer`/`User-Agent` headers. mpv/IINA send
-them via their dedicated `--referrer`/`--user-agent` options (comma-safe); VLC uses
-`--http-referrer`/`--http-user-agent`. The `supports_headers` gate in `LaunchPlayback`
-warns when a player cannot satisfy a source's headers.
+them via `http-header-fields` (`--http-header-fields=...` or `--mpv-http-header-fields=...`),
+while VLC maps them to `--http-referrer` / `--http-user-agent`. The `supports_headers`
+gate in `LaunchPlayback` warns when a player cannot satisfy a source's headers.
## Subtitles