Skip to content

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.md
index 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.md
index 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 Manager
diff --git a/docs/controls.md b/docs/controls.md
index 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.rs
index 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),