Skip to content

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

docs: align documentation with new dynamic target architecture for Termux/Proot environments

Samir Hossains0c86387ac318
diff --git a/docs/cross-platform.md b/docs/cross-platform.md
index 9b79e67..37041f9 100644
--- a/docs/cross-platform.md
+++ b/docs/cross-platform.md
@@ -10,7 +10,7 @@ Supported: macOS, Linux, Windows, and Android (Termux). The codebase uses
| macOS | IINA preferred player (via bundled `iina-cli`); VLC/mpv `.app` paths detected. `process_group(0)` on spawn. |
| Windows | mpv/VLC detected via Program Files + `%LOCALAPPDATA%`; players spawned with `CREATE_NO_WINDOW`; path-safe file stems. |
| Linux | Flatpak mpv/VLC supported (`flatpak run …`); xdg data/cache dirs. |
-| Android (Termux) | `cfg(target_os = "android")`; playback falls back to `termux-open --chooser` (or `am start`), with `LD_LIBRARY_PATH` cleared. |
+| Android (Termux) | Dynamic filesystem checks for `/system/bin/am` or `termux-open`; playback intelligently strips `LD_LIBRARY_PATH` and `LD_PRELOAD`. Works gracefully in Proot Linux containers and Termux X11 natively. |
## Terminal capabilities
diff --git a/docs/downloads.md b/docs/downloads.md
index 10e3550..40c8088 100644
--- a/docs/downloads.md
+++ b/docs/downloads.md
@@ -20,8 +20,7 @@ and optional segmentation. Orchestration lives in `app/download.rs`.
`safe_file_stem` sanitizes titles for all platforms: control/whitespace/illegal
characters are replaced, Windows reserved names (`CON`, `COM1`-`COM9`, …) are avoided,
-and length is capped. Files go to the user's download directory (on Android,
-`storage/downloads` when present).
+and length is capped. Files go to the user's download directory (on Android Proot, Termux X11, or native JVM, it dynamically scopes to `storage/downloads` when present, safely dropping filesystem target boundaries).
## Seasons
diff --git a/docs/players.md b/docs/players.md
index 68f795e..758ee06 100644
--- a/docs/players.md
+++ b/docs/players.md
@@ -23,7 +23,7 @@ detected player.
| 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`. |
| 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. |
-| Android | `termux-open --chooser --content-type video/* <url>` (or `am start` fallback) | Opens an app chooser on the device. |
+| 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. Falls back natively to mpv/VLC if in Termux X11. |
Window size is derived from the live terminal size times the real font cell size
(reported by the image picker), clamped to a sane range.