Skip to content

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

feat(tui): add explicit /download-dir <path> autocomplete hint and usage guidance

Samir Hossains868c4f3ecfc0
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 16e1a9c..8ce948c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -42,6 +42,9 @@
- Eliminated ANSI block characters, yellow/white selection redraw bars, and unnecessary background image downloads on basic terminals.
- Preserved full native high-resolution graphical rendering on Sixel, Kitty, and iTerm2 supported terminals.
- Added `MOVIEBOX_NO_IMAGE=1` environment override to disable image probing on slow or headless sessions.
+- **Explicit Download Directory Autocomplete Hints**:
+ - Added `/download-dir <path>` slash command suggestion with clear action descriptions (`Set custom folder (e.g. ~/Movies)` vs. `View current download folder`).
+ - Added friendly guidance notification if a user inputs literal `<path>` placeholders.
### Fixed
- **Default Audio Track Prioritization (Original / English)**:
diff --git a/src/tui/app/requests.rs b/src/tui/app/requests.rs
index 4a39a98..b322184 100644
--- a/src/tui/app/requests.rs
+++ b/src/tui/app/requests.rs
@@ -22,6 +22,7 @@ impl App {
commands.push("/history");
}
commands.push("/download-dir");
+ commands.push("/download-dir <path>");
if self.state.download_dir.is_some() {
commands.push("/download-dir reset");
}
diff --git a/src/tui/app/search.rs b/src/tui/app/search.rs
index cb99028..686a68a 100644
--- a/src/tui/app/search.rs
+++ b/src/tui/app/search.rs
@@ -230,6 +230,18 @@ impl App {
}
let clean_arg = raw_arg.trim_matches(|c| c == '\'' || c == '"').trim();
+ if clean_arg == "<path>"
+ || clean_arg == "path"
+ || clean_arg == "<dir>"
+ || clean_arg == "dir"
+ {
+ self.state.notify(
+ NotificationKind::Info,
+ "Download Directory",
+ "Usage: /download-dir <folder_path>\nExample: /download-dir ~/Movies",
+ );
+ return Some(true);
+ }
let expanded_path = if let Some(stripped) = clean_arg
.strip_prefix("~/")
.or_else(|| clean_arg.strip_prefix("~\\"))
diff --git a/src/tui/screens/home.rs b/src/tui/screens/home.rs
index e31d192..c363d54 100644
--- a/src/tui/screens/home.rs
+++ b/src/tui/screens/home.rs
@@ -55,7 +55,8 @@ pub(crate) fn slash_command_description(cmd: &str) -> Option<&'static str> {
let name = cmd.strip_prefix('/').unwrap_or(cmd);
match name {
"browse" => Some("Curated, rated & most-watched views"),
- "download-dir" => Some("Change or view download directory"),
+ "download-dir" => Some("View current download folder"),
+ "download-dir <path>" => Some("Set custom folder (e.g. ~/Movies)"),
"download-dir reset" => Some("Reset download directory to default"),
"history" => Some("Watch history"),
"theme" => Some("Theme picker"),
@@ -834,7 +835,7 @@ pub fn draw(frame: &mut Frame, area: Rect, state: &mut AppState, theme: &Theme)
if let Some(description) = desc {
let name_len = crate::tui::text::width(display_name);
- let pad = 16usize.saturating_sub(name_len).max(2);
+ let pad = 22usize.saturating_sub(name_len).max(2);
spans.push(Span::raw(" ".repeat(pad)));
spans.push(Span::styled(description, desc_style));
}