Skip to content

Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.

feat(ui): unify favorite shortcut to f and remove redundant star binding

Samir Hossains66af9a73f53d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 50815f9..872910c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@
## [Unreleased]
### Added
+- **Unified `f` Shortcut for Favorites (`src/tui/app/keyboard.rs`, `src/tui/screens/help.rs`)**: Standardized favorite / unfavorite toggling across all screens exclusively to `f` / `F`, removing redundant `*` keybindings and streamlining in-app help overlays and documentation.
- **Responsive Details Screen Layout & Narrow Terminal Polish (`src/tui/screens/details.rs`, `src/tui/app/mouse.rs`)**:
- **Narrow-Screen Dynamic Selector Pane Focus**: On compact terminal widths (<85 columns), renders the active selector pane (Audio, Seasons, or Episodes) with 100% available horizontal width instead of horizontally cramming 3 unreadable 14-character columns that cut off titles, language names, and season numbers.
- **Adaptive Pane Titles & Border Overflow Guard**: Dynamic title formatting for selector panes and streams headers (`"Streams · N available · X/Y"` $\to$ `"Streams · N (X/Y)"` $\to$ `"Streams (N)"`) preventing Ratatui border title truncations (`"● Audio · 4 1/"`).
diff --git a/README.md b/README.md
index 2e0bbf1..29193ce 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@ Searching and watching media through web browsers often means dealing with heavy
- **Addon Mode:** Install community HTTP addon manifests for custom catalog metadata (Cinemeta, Anime Kitsu) and direct stream resolution.
- **Smooth Video Playback:** Plays directly in **mpv** or **VLC**, with **IINA** available on macOS, using your computer's hardware for smooth video.
- **Easy Downloads:** Download single episodes or entire seasons with one keypress. Completed episodes are skipped automatically.
-- **Favorites:** Star any movie or series with `*` (or `f` on the details screen) and reach it instantly from a dedicated row on the home screen, or view the full list with `/favorites`.
+- **Favorites:** Favorite any movie or series with `f` and reach it instantly from a dedicated row on the home screen, or view the full list with `/favorites`.
- **Refined Terminal Interface:** Full keyboard and mouse support, responsive multi-column grid, compact single-column narrow terminal fallbacks, fluid 10-frame Braille loading spinners, WCAG AA contrast light/dark themes (Catppuccin Latte/Mocha, Nord, TokyoNight, Dracula, Gruvbox, Rosé Pine), contextual window titles, and modal-gated poster art.
## Installation
diff --git a/docs/controls.md b/docs/controls.md
index 88f905a..e803dca 100644
--- a/docs/controls.md
+++ b/docs/controls.md
@@ -64,8 +64,7 @@ All popup dialogs (Theme picker, Browse categories, Player picker, TV Manager, A
- **`o`**: Open player selection picker for the current stream.
- **`d`**: Download current episode or full season batch.
- **`r`**: Refresh search results / stream list.
-- **`*` / `f`**: Favorite / unfavorite the selected title on the Home screen.
-- **`f`**: Favorite / unfavorite the open title on the Details screen.
+- **`f`**: Favorite / unfavorite the selected title (Home & Details screens).
- **`s`**: Open subtitle language picker on the Details screen.
- **`/settings`**: Open interactive Settings & Preferences Hub.
- **`/browse`**: Open curated browse categories (Trending, Popular, Top Rated, etc.).
@@ -86,8 +85,7 @@ All popup dialogs (Theme picker, Browse categories, Player picker, TV Manager, A
- **`o`**: Open player selection picker for the stream.
- **`d`**: Download HTTP stream release.
- **`r`**: Refresh addon catalog search results.
-- **`*` / `f`**: Favorite / unfavorite the selected title on the Home screen.
-- **`f`**: Favorite / unfavorite the open title on the Details screen.
+- **`f`**: Favorite / unfavorite the selected title (Home & Details screens).
- **`s`**: Open subtitle language picker on the Details screen.
- **`/history`**: Open watch history (`Space` or `P` to instantly resume recorded episode/movie).
- **`/favorites`**: Open your starred titles.
diff --git a/src/tui/app/favorites.rs b/src/tui/app/favorites.rs
index 3e9257b..6768173 100644
--- a/src/tui/app/favorites.rs
+++ b/src/tui/app/favorites.rs
@@ -220,7 +220,7 @@ impl App {
self.state.notify(
NotificationKind::Info,
"Favorites",
- "No favorites yet. Star a title with * to add one.",
+ "No favorites yet. Favorite a title with 'f' to add one.",
);
} else {
items.sort_by_key(|item| std::cmp::Reverse(item.added_at));
diff --git a/src/tui/app/keyboard.rs b/src/tui/app/keyboard.rs
index ab926bf..29d1de5 100644
--- a/src/tui/app/keyboard.rs
+++ b/src/tui/app/keyboard.rs
@@ -928,7 +928,7 @@ impl App {
}
}
}
- KeyCode::Char('*') | KeyCode::Char('f') | KeyCode::Char('F')
+ KeyCode::Char('f') | KeyCode::Char('F')
if self.state.favorites_available()
&& (!self.state.search_results.is_empty()
|| self.state.favorites_focus) =>
diff --git a/src/tui/screens/help.rs b/src/tui/screens/help.rs
index 1fc4d70..302fa15 100644
--- a/src/tui/screens/help.rs
+++ b/src/tui/screens/help.rs
@@ -143,13 +143,9 @@ 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(" [*] / [f] ", theme.header),
- Span::styled("Favorite / Unfavorite (Home)", theme.text),
- ]));
help_text.push(Line::from(vec![
Span::styled(" [f] ", theme.header),
- Span::styled("Favorite / Unfavorite (Details)", theme.text),
+ Span::styled("Favorite / Unfavorite Title", theme.text),
]));
help_text.push(Line::from(vec![
Span::styled(" [s] ", theme.header),
@@ -199,13 +195,9 @@ pub fn draw(frame: &mut Frame, area: Rect, state: &AppState, theme: &Theme) {
Span::styled(" [d] ", theme.header),
Span::styled("Download Episode / Season Batch", theme.text),
]));
- help_text.push(Line::from(vec![
- Span::styled(" [*] / [f] ", theme.header),
- Span::styled("Favorite / Unfavorite (Home)", theme.text),
- ]));
help_text.push(Line::from(vec![
Span::styled(" [f] ", theme.header),
- Span::styled("Favorite / Unfavorite (Details)", theme.text),
+ Span::styled("Favorite / Unfavorite Title", theme.text),
]));
help_text.push(Line::from(vec![
Span::styled(" [s] ", theme.header),