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.mdindex 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 capabilitiesdiff --git a/docs/downloads.md b/docs/downloads.mdindex 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/illegalcharacters 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).## Seasonsdiff --git a/docs/players.md b/docs/players.mdindex 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.