Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
docs: update README and docs with mouse support, contextual downloads, and multilingual audio detection
Samir Hossainsf3860aa0cb3a
diff --git a/README.md b/README.mdindex e8fa61a..2ed9157 100644--- a/README.md+++ b/README.md@@ -2,7 +2,7 @@# MovieBox-TUI-Search, browse, play, and download movies, series, anime, and IPTV streams from a keyboard-first terminal interface using external media players.+Search, browse, play, and download movies, series, anime, and IPTV streams from a keyboard-first terminal interface with full mouse support using external media players.[](https://crates.io/crates/moviebox-tui)[](https://github.com/mesamirh/MovieBox-Tui/actions/workflows/ci.yml)@@ -25,7 +25,7 @@ guidance is in [`CONTRIBUTING.md`](CONTRIBUTING.md).### Catalogs & Browsing- Search and browse movies, TV series, and anime from multiple content catalogs-- Inspect stream quality groupings and subtitle options before playback+- Inspect stream quality groupings, multilingual audio tracks, and subtitle options before playback> **Note on BDIX:** BDIX sources are only accessible from supported Bangladeshi ISP networks. Because of this, they are hidden by default. You can enable them manually if your network supports it.@@ -36,7 +36,8 @@ guidance is in [`CONTRIBUTING.md`](CONTRIBUTING.md).### Downloads-- Download full seasons or episodes with automatic subtitle language selection+- Contextual downloads: download entire seasons or single episodes with one click/key+- Automatic subtitle language selection applied across all season episodes- Resume interrupted downloads without losing progress### IPTV@@ -45,6 +46,7 @@ guidance is in [`CONTRIBUTING.md`](CONTRIBUTING.md).### User Interface & App+- Full mouse and keyboard controls: click search, suggestions, cards, tabs, and action buttons directly- View rich graphical posters in supported terminals (Kitty, iTerm2, Sixel) or fallback to text art- Let the app automatically manage configuration and clean up expired caches@@ -197,6 +199,18 @@ moviebox-tui| `?` | Show help || `q` | Quit |+### Mouse controls++| Action | Result |+| ------ | ------ |+| Left click search bar | Enter search query input mode |+| Left click suggestion item | Select and search suggestion immediately |+| Left click search result row | Select item and preview; click again / double click to open details |+| Left click audio / season / episode / stream | Switch audio language, change season, select episode, or play stream |+| Left click footer buttons | Switch provider (`[Ctrl+P]`), toggle TV mode (`[Ctrl+T]`), open help (`[?]`), or quit (`[q]`) |+| Left click modal items / buttons | Select theme, browse preset, subtitles, players, or confirm download/cancel |+| Left click outside modal | Dismiss popup |+### Slash commands| Command | Action |@@ -228,6 +242,7 @@ MovieBox-TUI/└── Series/<title>/Season <number>/```+- **Contextual triggers:** Pressing `d` or clicking `[Download]` while focused on the **Seasons** pane prompts to download the whole season; while on **Episodes** or **Streams**, it downloads that single episode.- **Sequential downloads:** Entire seasons are downloaded one by one to limit disk and network pressure.- **Smart subtitles:** Your subtitle language choice for the first episode is applied to the remaining episodes. Missing subtitles do not discard completed video files.- **Robust resuming:** Interrupted downloads preserve `.part` and metadata files, and can be resumed without losing progress.diff --git a/docs/architecture.md b/docs/architecture.mdindex 8783a61..bc11bc7 100644--- a/docs/architecture.md+++ b/docs/architecture.md@@ -39,6 +39,7 @@ src/navigation.rs list navigation, submit actions, provider helperstv.rs TV mode: playlist manager + playbackkeyboard.rs raw key-event handling+ mouse.rs mouse click handling and hitbox routingsystem.rs help, refresh, cache, theme, updates, focus, resizestate.rs AppState: all UI state + in-memory LRU cachesaction.rs the Action enum (event/message model)diff --git a/docs/downloads.md b/docs/downloads.mdindex 086b6d1..65527e9 100644--- a/docs/downloads.md+++ b/docs/downloads.md@@ -23,9 +23,10 @@ characters are replaced, Windows reserved names (`CON`, `COM1`-`COM9`, …) areand length is capped. Files go to the user's download directory. On Android-familyenvironments the code prefers shared `storage/downloads` when present.-## Seasons+## Contextual triggers & Seasons-A season download enqueues every episode (`download_queue`) and processes them one at a+- **Contextual trigger**: Pressing `d` (or clicking `[Download]`) while focused on the **Seasons** pane prompts to download all episodes of the selected season. Triggering download while on the **Episodes** or **Streams** pane prompts to download only that single episode.+- A season download enqueues every episode (`download_queue`) and processes them one at atime, each resolving its stream and subtitle. Progress is reported through`Action::UpdateDownload` and the status bar; failures pause and preserve partial data.diff --git a/docs/modules.md b/docs/modules.mdindex df02423..7f8e04b 100644--- a/docs/modules.md+++ b/docs/modules.md@@ -80,6 +80,8 @@ src/download.rs handle_download: download orchestration + start_resilient_download.navigation.rs handle_navigation + provider/nav helpers.keyboard.rs handle_key: raw key-event handling.+ mouse.rs handle_mouse: mouse click routing and hitboxes across screens,+ popups, tabs, buttons, and dialogs.system.rs handle_system: tick/quit/focus/resize/help/refresh/cache/theme/status/updates.tv.rs handle_tv: playlist manager + TV actions.diff --git a/docs/providers.md b/docs/providers.mdindex a7edee1..7374b46 100644--- a/docs/providers.md+++ b/docs/providers.md@@ -49,6 +49,10 @@ which `app/playback.rs::launch_player` feeds to the external player.attached so referer-gated CDNs stream in the player too.- `hubcloud.rs` resolves hubcloud/hubdrive pages into candidate playable links andpicks the best mirror by score.+- **Multilingual audio detection**: `parser.rs::detect_language` parses release titles and+ metadata for 30+ regional and international languages (Hindi, Tamil, Telugu, Kannada,+ Malayalam, Bengali, Marathi, Punjabi, Gujarati, Urdu, Japanese, Korean, Chinese, Spanish,+ French, German, Italian, etc.) and formats all available audio tracks for stream display.- Errors are surfaced as `FourKHdHubError`; mirror rejections and the final failurereason are logged with the mirror label and a sanitized URL.