Skip to content

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.md
index 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 Mode
diff --git a/docs/cache.md b/docs/cache.md
index 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>.json
details/details_<hash>.json
streams/v3_<hash>_<season>_<episode>.json (v3_ prefix only for 4KHD)
images/<md5>.img
moviebox/
homepage/<tab>_<page>.json
captions/captions_<hash>.json
+ addons/
+ catalogs/catalog_<hash>.json
+ manifests/manifest_<hash>.json
+ streams/<hash>_<season>_<episode>.json
tv_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 from
different 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 of
being served from the cache.
- **Atomic writes**: data is written to a temp file then renamed, so a crash never
diff --git a/docs/config.md b/docs/config.md
index 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`). |
## CLI
diff --git a/docs/controls.md b/docs/controls.md
index 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.md
index 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