Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
docs: update controls, changelog, and in-app help for addon browse and slash command interception
Samir Hossainsc0c4a733bb05
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex c0a4ef2..b855681 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,8 +6,15 @@- **Addon Mode (Community HTTP Addons)**:- Added full support for community HTTP addon manifests (`/manifest.json`, `/catalog`, `/meta`, `/stream`) with dedicated `Ctrl+A` mode switching.- Pre-installed and locked Cinemeta out-of-the-box as the default core metadata provider with zero API keys required.- - Added interactive Addon Manager dialog (`/addons`, `Ctrl+P` in Addon Mode) with one-click enabling, removal, and manifest URL adding.+ - Added interactive Addon Manager dialog (`/addons`, `Ctrl+P` in Addon Mode) with one-click enabling, removal, and manifest URL adding.- Added concurrent multi-addon stream resolution aggregating playable releases from all enabled stream addons.+- **Addon Mode `/browse` & Curated Catalog Exploration**:+ - Added `/browse` support in Addon Mode with a minimal, organized 4-preset catalog picker (`Top Movies`, `Top Series`, `Top Rated Movies`, `Top Rated Series`).+ - Added direct catalog fetching (`/catalog/{type}/{id}.json`) with poster hydration, details navigation, stream resolution, and `/reload` support.+- **Strict Slash Command Guarding & Guidance**:+ - Intercepted all `/` slash commands to guarantee zero remote catalog network requests.+ - Added warning toast notifications for unrecognized slash commands (`"Command '/xyz' is not recognized. Type '/' to view available commands."`).+ - Added platform-aware mode-guidance toasts (`^T` / `^S` / `^A` on macOS, `Ctrl+T` / `Ctrl+S` / `Ctrl+A` on Linux/Windows) for mode-restricted commands.- **Dynamic Multi-Source Host & Resolver Resolution**:- Added 100% dynamic domain-based host extractor (`extract_domain_label`) and stream tag parser (`detect_stream_host`) identifying and formatting direct hosts (Pixeldrain, Hubcloud, Fast Download, Google Drive, Mega, etc.) and debrid resolvers without hardcoded tables.- **Full Emoji & Symbol Sanitization**:@@ -15,9 +22,15 @@- Standardized checkbox representations to clean ASCII `[x] / [ ]`.- **Complete Mouse Navigation**:- Added dynamic footer hitboxes for `[Ctrl+S] Streaming`, `[Ctrl+T] TV`, `[Ctrl+A] Addons`, `[Ctrl+P] {Provider}`, `[?] Help`, `[q] Quit`.- - Added complete mouse click support for Addon Manager modal.+ - Added complete mouse click support for Addon Manager modal and browse popups.### Fixed+- **Atomic Mode Highlight & Single Active Selection**:+ - Added canonical `AppMode` enum (`Streaming`, `Tv`, `Addon`) and atomic state transitions guaranteeing that only one active mode is highlighted in the bottom dock at any time.+ - Hardened state isolation with automatic cleanup across mode switches.+- **Notification Readability & Word-Boundary Wrapping**:+ - Replaced horizontal middle-truncation with unicode display-width aware word wrapping (`wrap_text`).+ - Added adaptive width (up to 72 chars) and dynamic height scaling with guaranteed unbroken rounded borders.- **Resilient Addon Metadata & Fallbacks**:- Added flexible visitors and serde aliases for `genres`, `cast`, `director`, `imdbRating`, `releaseInfo`, and `runtime` preventing deserialization failures across varied community addon JSON schemas.- Added multi-tier fallback resolution in the Details screen to guarantee titles, release years, synopsis, and posters are always preserved from search results and previews.diff --git a/docs/addons-mode.md b/docs/addons-mode.mdindex 41ce844..6ef28bb 100644--- a/docs/addons-mode.md+++ b/docs/addons-mode.md@@ -15,9 +15,10 @@ Addon Mode enables support for community HTTP addon manifests. You can install a- `Ctrl+A`: Toggle / Enter **Addon Mode**.- `Ctrl+S`: Return to standard **Streaming Mode**.- `Ctrl+T`: Toggle **TV Mode**.+- `/browse`: Browse curated addon catalogs (`Top Movies`, `Top Series`, `Top Rated Movies`, `Top Rated Series`).- `/enable-addons`: Enables Addon Mode in configuration and updates the footer navigation.- `/disable-addons`: Disables Addon Mode in configuration.-- `/addons`: Opens the Addon Manager modal.+- `/addons` or `/config`: Opens the Addon Manager modal.## Addon Managerdiff --git a/docs/controls.md b/docs/controls.mdindex 1ea3b77..525cfac 100644--- a/docs/controls.md+++ b/docs/controls.md@@ -40,6 +40,7 @@ MovieBox-TUI is designed for fast keyboard navigation with complete mouse suppor- **`o`**: Open player selection picker for the stream.- **`d`**: Download HTTP stream release.- **`r`**: Refresh addon catalog search results.+- **`/browse`**: Browse curated addon catalogs (Top Movies, Top Series, Top Rated).- **`/config`**: Open Addon Manager dialog.## Mouse Controls@@ -60,11 +61,11 @@ Type these commands directly into the search bar:| Command | Applicable Mode | Action || :--- | :--- | :--- |-| `/browse` | Streaming | Browse curated popular, top-rated, and trending titles |+| `/browse` | Streaming / Addon | Browse curated views (Trending, Popular) or Addon catalogs (Top Movies, Top Series) || `/history` | Streaming | View watch history with latest progress || `/list` | TV | View live TV channels |-| `/reload` | TV | Reload M3U playlists |-| `/config` | TV | Manage custom IPTV playlists |+| `/reload` | TV / Streaming / Addon | Reload active playlist, catalog, or search results |+| `/config` | TV / Addon | Manage IPTV playlists (TV) or Addon Manager (Addon Mode) || `/addons` | Addon / Streaming | Open Addon Manager dialog || `/enable-addons` | All | Enable Addon Mode navigation || `/disable-addons` | All | Disable Addon Mode navigation |diff --git a/src/tui/screens/help.rs b/src/tui/screens/help.rsindex 1c8d0d4..5219c90 100644--- a/src/tui/screens/help.rs+++ b/src/tui/screens/help.rs@@ -119,6 +119,14 @@ pub fn draw(frame: &mut Frame, area: Rect, state: &AppState, theme: &Theme) {Span::styled(" [d] ", theme.header),Span::styled("Download Video Stream", theme.text),]));+ help_text.push(Line::from(vec![+ Span::styled(" /browse ", theme.header),+ Span::styled("Browse Addon Catalogs", theme.text),+ ]));+ help_text.push(Line::from(vec![+ Span::styled(" /config ", theme.header),+ Span::styled("Manage Addons", theme.text),+ ]));help_text.push(Line::from(vec![Span::styled(" [r] ", theme.header),Span::styled("Refresh Catalog / Streams", theme.text),