Skip to content

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.md
index 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.
[![Crates.io](https://img.shields.io/crates/v/moviebox-tui.svg?logo=rust)](https://crates.io/crates/moviebox-tui)
[![CI](https://github.com/mesamirh/MovieBox-Tui/actions/workflows/ci.yml/badge.svg)](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.md
index 8783a61..bc11bc7 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -39,6 +39,7 @@ src/
navigation.rs list navigation, submit actions, provider helpers
tv.rs TV mode: playlist manager + playback
keyboard.rs raw key-event handling
+ mouse.rs mouse click handling and hitbox routing
system.rs help, refresh, cache, theme, updates, focus, resize
state.rs AppState: all UI state + in-memory LRU caches
action.rs the Action enum (event/message model)
diff --git a/docs/downloads.md b/docs/downloads.md
index 086b6d1..65527e9 100644
--- a/docs/downloads.md
+++ b/docs/downloads.md
@@ -23,9 +23,10 @@ characters are replaced, Windows reserved names (`CON`, `COM1`-`COM9`, …) are
and length is capped. Files go to the user's download directory. On Android-family
environments 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 a
time, 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.md
index 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.md
index 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 and
picks 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 failure
reason are logged with the mirror label and a sanitized URL.