Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
docs: sync theme list, player detection matrix, and addon caching across docs
Samir Hossains9cd3e7e7b0e2
diff --git a/docs/addons-mode.md b/docs/addons-mode.mdindex 4f4c776..45483b6 100644--- a/docs/addons-mode.md+++ b/docs/addons-mode.md@@ -9,6 +9,9 @@ Addon Mode enables support for community HTTP addon manifests. You can install a- **Direct HTTP Stream Engine**: Automatically extracts and filters direct Cloudflare R2, PixelDrain, direct video CDN, and HubCloud/HubDrive HTTP streams.- **Multi-Addon Concurrency**: Simultaneously queries all enabled stream addons and aggregates releases.- **Quality & Size Parsing**: Ranks streams by quality (`4K UHD / 2160p`, `1080p`, `720p`, `SD`), file size in GB/MB, and audio language tracks (e.g. `[Dual]`, `[Multi]`, `Hindi + English`).+- **Torrent Blocking Detection**: Automatically detects if an addon's streams are 100% blocked raw torrents (e.g. Torrentio without Debrid) and alerts the user that only HTTP streams are supported.+- **Watch History & Progress Parity**: Full `/history` support in Addon Mode with real-time `mpv` position tracking, scrub lines, and auto-resume.+- **High-Performance Caching**: Curated `/browse` catalogs are cached for `1 hour`, manifests for `24 hours`, and stream aggregations for `2 hours`.## Entering Addon Modediff --git a/docs/cache.md b/docs/cache.mdindex 7ecd460..71c1e51 100644--- a/docs/cache.md+++ b/docs/cache.md@@ -7,13 +7,17 @@ Disk caching lives in `cache.rs`; in-memory caches live in `AppState`.```<cache dir>/moviebox-tui/<provider>/ moviebox, fourkhdhub, bdix_circleftp, bdix_dhakaflix, addons- search/<hash>.json+ search/<hash>_<page>.jsondetails/details_<hash>.jsonstreams/v3_<hash>_<season>_<episode>.json (v3_ prefix only for 4KHD)images/<md5>.imgmoviebox/homepage/<tab>_<page>.jsoncaptions/captions_<hash>.json+ addons/+ catalogs/catalog_<hash>.json+ manifests/manifest_<hash>.json+ streams/<hash>_<season>_<episode>.jsontv_playlists/<md5>.m3u cached remote playlist snapshots```@@ -25,9 +29,9 @@ The cache directory is `dirs::cache_dir()/moviebox-tui` (macOS- **Provider namespacing**: keys include `provider.cache_key()`, so results fromdifferent providers never collide. Image caches are namespaced by provider (or`iptv` for channel logos) with fallback resolution across `posters`, `moviebox`,- `fourkhdhub`, `iptv`, `circleftp`, and `dhakaflix`.-- **TTL**: streams expire after 2h; search/details/captions after 24h;- homepage after 1h; remote TV playlist snapshots after 24h; images after 30 days+ `fourkhdhub`, `iptv`, `circleftp`, `dhakaflix`, and `addons`.+- **TTL**: streams expire after 2h; search/details/captions/manifests after 24h;+ homepage/catalogs after 1h; remote TV playlist snapshots after 24h; images after 30 days(`IMAGE_CACHE_EXPIRY_SECS`). Local file playlists are reread directly instead ofbeing served from the cache.- **Atomic writes**: data is written to a temp file then renamed, so a crash neverdiff --git a/docs/config.md b/docs/config.mdindex 1508fb5..f29bdec 100644--- a/docs/config.md+++ b/docs/config.md@@ -38,7 +38,7 @@ macOS `~/Library/Application Support/moviebox-tui`, Linux `~/.config/moviebox-tu| `MOVIEBOX_VLC_PATH` | Custom VLC executable. || `MOVIEBOX_IINA_PATH` | Custom IINA/iina-cli executable. || `MOVIEBOX_FOURKHDHUB_URL` | Override the 4KHDHub base URL. |-| `MOVIEBOX_THEME` | Force a theme (e.g. `Mocha`, `Latte`). |+| `MOVIEBOX_THEME` | Force a theme (e.g. `Dracula`, `Gruvbox`, `Nord`, `Mocha`, `RosePine`, etc.). || `MOVIEBOX_NO_IMAGE` | Disable poster image queries (set to `1` or `true`). |## CLIdiff --git a/docs/controls.md b/docs/controls.mdindex f395229..6abea2a 100644--- a/docs/controls.md+++ b/docs/controls.md@@ -71,7 +71,7 @@ Type these commands directly into the search bar:| `/enable-addons` | All | Enable Addon Mode navigation in bottom dock || `/disable-addons` | All | Disable Addon Mode navigation || `/download-dir` | All | View, change, or reset the download directory |-| `/theme` | All | Open theme picker (Mocha, Latte, Macchiato, Frappe, Nord, TokyoNight) |+| `/theme` | All | Open theme picker (Mocha, Latte, Macchiato, Frappe, Nord, TokyoNight, Dracula, Gruvbox, RosePine) || `/clear-cache` | All | Clear temporary cache files || `/update` | All | Check if a new release is available on GitHub || `/toggle-update` | All | Toggle automatic startup update checks |diff --git a/docs/players.md b/docs/players.mdindex a96848a..f2fccc6 100644--- a/docs/players.md+++ b/docs/players.md@@ -7,8 +7,9 @@ builds the exact command; `tui/app/playback.rs` spawns it.`player::detect()` returns players in priority order:-- macOS: IINA (if present), then mpv, then VLC.-- Linux/Windows: mpv, then VLC.+- macOS: IINA (if present), then mpv, then VLC (probing `/Applications`, `~/Applications`, Homebrew `/opt/homebrew/bin`, and MacPorts).+- Linux: mpv, then VLC (probing Native `$PATH`, Flathub/Flatpak user & system exports `org.videolan.VLC` / `io.mpv.Mpv`, Snap `/snap/bin/*`, and `flatpak run`).+- Windows: mpv, then VLC (probing `Program Files`, `LOCALAPPDATA\Programs`, `Microsoft\WindowsApps`, Scoop `scoop\shims`, and Chocolatey).- Android/Termux: the Android intent fallback is attempted last when `termux-open` or `am` is available.Resolution runs once at startup and is cached (`OnceLock`). A preferred player can be