@involvex/youtube-music-cli 0.0.9 → 0.0.12

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [0.0.12](https://github.com/involvex/youtube-music-cli/compare/v0.0.11...v0.0.12) (2026-02-18)
+
+## [0.0.11](https://github.com/involvex/youtube-music-cli/compare/v0.0.10...v0.0.11) (2026-02-18)
+
+### Features
+
+- **download:** add track, artist, and playlist downloads ([42298d2](https://github.com/involvex/youtube-music-cli/commit/42298d2fd35ba71ad841f58e140f4c53b3222ed7))
+
+## [0.0.10](https://github.com/involvex/youtube-music-cli/compare/v0.0.9...v0.0.10) (2026-02-18)
+
+### Bug Fixes
+
+- mpv resume not working and double-process on track change ([fd04bda](https://github.com/involvex/youtube-music-cli/commit/fd04bdaa852f366eb92d265415ec18794ea5dfc3))
+
+### Features
+
+- dynamic mix playlist creation from search results ([d019048](https://github.com/involvex/youtube-music-cli/commit/d019048c4450d633003c8026ac43e92a743d87a0))
+
 ## [0.0.9](https://github.com/involvex/youtube-music-cli/compare/v0.0.8...v0.0.9) (2026-02-18)
 
 ### Features

package/dist/source/components/common/Help.js

@@ -6,5 +6,5 @@ import { useNavigation } from "../../hooks/useNavigation.js";
 export default function Help() {
     const { theme } = useTheme();
     const { dispatch: _dispatch } = useNavigation();
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, padding: 1, children: [_jsx(Box, { borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Keyboard Shortcuts" }) }), _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Global" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "q / Esc" }), " - Quit", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "?" }), " - Help", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "/" }), " - Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+P" }), " - Playlists", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "p" }), " - Plugins", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "g" }), " - Suggestions", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "," }), " - Settings"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Player" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Space" }), " - Play/Pause", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "n" }), " - Next", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "b" }), " - Previous", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "=" }), " - Volume Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "-" }), " - Volume Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "s" }), " - Toggle Shuffle", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "r" }), " - Toggle Repeat"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Navigation" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Up" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "k" }), " - Move Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Down" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "j" }), " - Move Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Enter" }), " - Select", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Go Back"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Search" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Tab" }), " - Switch Search Type", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Clear Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "[ / ]" }), " - Results Limit"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Playlist" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "a" }), " - Add to Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "d" }), " - Remove from Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "c" }), " - Create Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "D" }), " - Delete Playlist"] }) }), _jsxs(Text, { color: theme.colors.dim, children: ["Press ", _jsx(Text, { color: theme.colors.text, children: "Esc" }), " or", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), " to close"] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, padding: 1, children: [_jsx(Box, { borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Keyboard Shortcuts" }) }), _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Global" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "q / Esc" }), " - Quit", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "?" }), " - Help", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "/" }), " - Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+P" }), " - Playlists", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "p" }), " - Plugins", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "g" }), " - Suggestions", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "," }), " - Settings"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Player" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Space" }), " - Play/Pause", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "n" }), " - Next", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "b" }), " - Previous", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "=" }), " - Volume Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "-" }), " - Volume Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "s" }), " - Toggle Shuffle", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "r" }), " - Toggle Repeat"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Navigation" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Up" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "k" }), " - Move Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Down" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "j" }), " - Move Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Enter" }), " - Select", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Go Back"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Search" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Tab" }), " - Switch Search Type", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "m" }), " - Create Mix Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " - Download selection", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Clear Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "[ / ]" }), " - Results Limit"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Playlist" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "a" }), " - Add to Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "d" }), " - Remove from Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "c" }), " - Create Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " - Download Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "D" }), " - Delete Playlist"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "View" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "M" }), " - Toggle Mini Player", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "l" }), " - Lyrics", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "T" }), " - Trending", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "e" }), " - Explore"] }) }), _jsxs(Text, { color: theme.colors.dim, children: ["Press ", _jsx(Text, { color: theme.colors.text, children: "Esc" }), " or", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), " to close"] })] })] }));
 }

package/dist/source/components/common/ShortcutsBar.js

@@ -1,15 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Shortcuts bar component
 import { Box, Text } from 'ink';
-import { useCallback } from 'react';
 import { usePlayer } from "../../hooks/usePlayer.js";
-import { useNavigation } from "../../hooks/useNavigation.js";
 import { useTheme } from "../../hooks/useTheme.js";
 import { useKeyBinding } from "../../hooks/useKeyboard.js";
 import { KEYBINDINGS } from "../../utils/constants.js";
 export default function ShortcutsBar() {
     const { theme } = useTheme();
-    const { dispatch: navDispatch } = useNavigation();
     const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, } = usePlayer();
     // Register key bindings globally
     const handlePlayPause = () => {
@@ -20,9 +17,6 @@ export default function ShortcutsBar() {
             resume();
         }
     };
-    const goConfig = useCallback(() => {
-        navDispatch({ category: 'NAVIGATE', view: 'config' });
-    }, [navDispatch]);
     useKeyBinding(KEYBINDINGS.PLAY_PAUSE, handlePlayPause);
     useKeyBinding(KEYBINDINGS.NEXT, next);
     useKeyBinding(KEYBINDINGS.PREVIOUS, previous);
@@ -30,6 +24,6 @@ export default function ShortcutsBar() {
     useKeyBinding(KEYBINDINGS.VOLUME_DOWN, volumeDown);
     useKeyBinding(KEYBINDINGS.VOLUME_FINE_UP, volumeFineUp);
     useKeyBinding(KEYBINDINGS.VOLUME_FINE_DOWN, volumeFineDown);
-    useKeyBinding(KEYBINDINGS.SETTINGS, goConfig);
-    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: ["Shortcuts: ", _jsx(Text, { color: theme.colors.text, children: "Space" }), " Play/Pause |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2192" }), " Next |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2190" }), " Previous |", ' ', _jsx(Text, { color: theme.colors.text, children: "Shift+P" }), " Playlists |", ' ', _jsx(Text, { color: theme.colors.text, children: "p" }), " Plugins |", ' ', _jsx(Text, { color: theme.colors.text, children: "/" }), " Search |", ' ', _jsx(Text, { color: theme.colors.text, children: "," }), " Settings |", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), " Help |", ' ', _jsx(Text, { color: theme.colors.text, children: "q" }), " Quit"] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: theme.colors.dim, children: "[=/" }), "-", _jsx(Text, { color: theme.colors.dim, children: "]" }), " Vol:", ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
+    // Note: SETTINGS keybinding handled by MainLayout to avoid double-dispatch
+    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: ["Shortcuts: ", _jsx(Text, { color: theme.colors.text, children: "Space" }), " Play/Pause |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2192" }), " Next |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2190" }), " Prev |", ' ', _jsx(Text, { color: theme.colors.text, children: "Shift+P" }), " Playlists |", ' ', _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " Download |", ' ', _jsx(Text, { color: theme.colors.text, children: "m" }), " Mix |", ' ', _jsx(Text, { color: theme.colors.text, children: "M" }), " Mini |", ' ', _jsx(Text, { color: theme.colors.text, children: "/" }), " Search |", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), " Help |", ' ', _jsx(Text, { color: theme.colors.text, children: "q" }), " Quit"] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: theme.colors.dim, children: "[=/" }), "-", _jsx(Text, { color: theme.colors.dim, children: "]" }), " Vol:", ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
 }

package/dist/source/components/layouts/MainLayout.js

@@ -76,7 +76,7 @@ function MainLayout() {
     useKeyBinding(KEYBINDINGS.SUGGESTIONS, goToSuggestions);
     useKeyBinding(KEYBINDINGS.SETTINGS, goToSettings);
     useKeyBinding(KEYBINDINGS.HELP, goToHelp);
-    useKeyBinding(['m'], togglePlayerMode);
+    useKeyBinding(['M'], togglePlayerMode);
     useKeyBinding(['l'], goToLyrics);
     useKeyBinding(['T'], goToTrending);
     useKeyBinding(['e'], goToExplore);

package/dist/source/components/layouts/SearchLayout.js

@@ -17,8 +17,8 @@ function SearchLayout() {
     const [results, setResults] = useState([]);
     const [isTyping, setIsTyping] = useState(true);
     const [isSearching, setIsSearching] = useState(false);
-    const [mixMessage, setMixMessage] = useState(null);
-    const mixTimeoutRef = useRef(null);
+    const [actionMessage, setActionMessage] = useState(null);
+    const actionTimeoutRef = useRef(null);
     // Handle search action
     const performSearch = useCallback(async (query) => {
         if (!query || isSearching)
@@ -74,19 +74,29 @@ function SearchLayout() {
     }, [isTyping, dispatch]);
     useKeyBinding(KEYBINDINGS.BACK, goBack);
     const handleMixCreated = useCallback((message) => {
-        setMixMessage(message);
-        if (mixTimeoutRef.current) {
-            clearTimeout(mixTimeoutRef.current);
+        setActionMessage(message);
+        if (actionTimeoutRef.current) {
+            clearTimeout(actionTimeoutRef.current);
         }
-        mixTimeoutRef.current = setTimeout(() => {
-            setMixMessage(null);
-            mixTimeoutRef.current = null;
+        actionTimeoutRef.current = setTimeout(() => {
+            setActionMessage(null);
+            actionTimeoutRef.current = null;
+        }, 4000);
+    }, []);
+    const handleDownloadStatus = useCallback((message) => {
+        setActionMessage(message);
+        if (actionTimeoutRef.current) {
+            clearTimeout(actionTimeoutRef.current);
+        }
+        actionTimeoutRef.current = setTimeout(() => {
+            setActionMessage(null);
+            actionTimeoutRef.current = null;
         }, 4000);
     }, []);
     useEffect(() => {
         return () => {
-            if (mixTimeoutRef.current) {
-                clearTimeout(mixTimeoutRef.current);
+            if (actionTimeoutRef.current) {
+                clearTimeout(actionTimeoutRef.current);
             }
         };
     }, []);
@@ -100,8 +110,8 @@ function SearchLayout() {
     }, [dispatch]);
     return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, children: [_jsx(Text, { bold: true, color: theme.colors.primary, children: "Search" }), _jsxs(Text, { color: theme.colors.dim, children: [' ', "| Limit: ", navState.searchLimit, " (Use [ or ] to adjust)"] })] }), _jsx(SearchBar, { isActive: isTyping && !isSearching, onInput: input => {
                     void performSearch(input);
-                } }), (isLoading || isSearching) && (_jsx(Text, { color: theme.colors.accent, children: "Searching..." })), error && _jsx(Text, { color: theme.colors.error, children: error }), !isLoading && navState.hasSearched && (_jsx(SearchResults, { results: results, selectedIndex: navState.selectedResult, isActive: !isTyping, onMixCreated: handleMixCreated })), !isLoading && navState.hasSearched && results.length === 0 && !error && (_jsx(Text, { color: theme.colors.dim, children: "No results found" })), mixMessage && _jsx(Text, { color: theme.colors.accent, children: mixMessage }), _jsx(Text, { color: theme.colors.dim, children: isTyping
+                } }), (isLoading || isSearching) && (_jsx(Text, { color: theme.colors.accent, children: "Searching..." })), error && _jsx(Text, { color: theme.colors.error, children: error }), !isLoading && navState.hasSearched && (_jsx(SearchResults, { results: results, selectedIndex: navState.selectedResult, isActive: !isTyping, onMixCreated: handleMixCreated, onDownloadStatus: handleDownloadStatus })), !isLoading && navState.hasSearched && results.length === 0 && !error && (_jsx(Text, { color: theme.colors.dim, children: "No results found" })), actionMessage && (_jsx(Text, { color: theme.colors.accent, children: actionMessage })), _jsx(Text, { color: theme.colors.dim, children: isTyping
                     ? 'Type to search, Enter to start, Esc to clear'
-                    : `Arrows to navigate, Enter to play, M to create mix, ]/[ more/fewer results (${navState.searchLimit}), H for history, Esc to type` })] }));
+                    : `Arrows to navigate, Enter to play, M mix, Shift+D download, ]/[ more/fewer results (${navState.searchLimit}), H history, Esc to type` })] }));
 }
 export default React.memo(SearchLayout);

package/dist/source/components/playlist/PlaylistList.js

@@ -10,15 +10,19 @@ import { usePlaylist } from "../../hooks/usePlaylist.js";
 import { useTheme } from "../../hooks/useTheme.js";
 import { useKeyboardBlocker } from "../../hooks/useKeyboardBlocker.js";
 import { KEYBINDINGS } from "../../utils/constants.js";
+import { getDownloadService } from "../../services/download/download.service.js";
 export default function PlaylistList() {
     const { theme } = useTheme();
     const { play, setQueue } = usePlayer();
     const { dispatch } = useNavigation();
-    const { playlists, createPlaylist, renamePlaylist } = usePlaylist();
+    const downloadService = getDownloadService();
+    const { playlists, createPlaylist, renamePlaylist, deletePlaylist } = usePlaylist();
     const [selectedIndex, setSelectedIndex] = useState(0);
     const [lastCreated, setLastCreated] = useState(null);
     const [renamingPlaylistId, setRenamingPlaylistId] = useState(null);
     const [renameValue, setRenameValue] = useState('');
+    const [downloadStatus, setDownloadStatus] = useState(null);
+    const [isDownloading, setIsDownloading] = useState(false);
     useKeyboardBlocker(renamingPlaylistId !== null);
     const handleCreate = useCallback(() => {
         const name = `Playlist ${playlists.length + 1}`;
@@ -67,16 +71,68 @@ export default function PlaylistList() {
         }
         dispatch({ category: 'GO_BACK' });
     }, [dispatch, renamingPlaylistId]);
+    const handleDelete = useCallback(() => {
+        if (renamingPlaylistId)
+            return;
+        const playlist = playlists[selectedIndex];
+        if (!playlist)
+            return;
+        deletePlaylist(playlist.playlistId);
+        setSelectedIndex(prev => Math.max(0, prev - 1));
+    }, [deletePlaylist, playlists, renamingPlaylistId, selectedIndex]);
+    const handleDownload = useCallback(async () => {
+        if (renamingPlaylistId)
+            return;
+        if (isDownloading) {
+            setDownloadStatus('Download already in progress. Please wait.');
+            return;
+        }
+        const playlist = playlists[selectedIndex];
+        if (!playlist)
+            return;
+        const config = downloadService.getConfig();
+        if (!config.enabled) {
+            setDownloadStatus('Downloads are disabled. Enable Download Feature in Settings.');
+            return;
+        }
+        const target = downloadService.resolvePlaylistTarget(playlist);
+        if (target.tracks.length === 0) {
+            setDownloadStatus(`No tracks to download in "${playlist.name}".`);
+            return;
+        }
+        setDownloadStatus(`Downloading ${target.tracks.length} track(s) from "${playlist.name}"... this can take a few minutes.`);
+        try {
+            setIsDownloading(true);
+            const summary = await downloadService.downloadTracks(target.tracks);
+            setDownloadStatus(`Downloaded ${summary.downloaded}, skipped ${summary.skipped}, failed ${summary.failed}.`);
+        }
+        catch (error) {
+            setDownloadStatus(error instanceof Error ? error.message : 'Failed to download playlist.');
+        }
+        finally {
+            setIsDownloading(false);
+        }
+    }, [
+        downloadService,
+        isDownloading,
+        playlists,
+        renamingPlaylistId,
+        selectedIndex,
+    ]);
     useKeyBinding(KEYBINDINGS.UP, navigateUp);
     useKeyBinding(KEYBINDINGS.DOWN, navigateDown);
     useKeyBinding(KEYBINDINGS.SELECT, startPlaylist);
     useKeyBinding(['r'], handleRename);
     useKeyBinding(KEYBINDINGS.CREATE_PLAYLIST, handleCreate);
+    useKeyBinding(KEYBINDINGS.DELETE_PLAYLIST, handleDelete);
     useKeyBinding(KEYBINDINGS.BACK, handleBack);
+    useKeyBinding(KEYBINDINGS.DOWNLOAD, () => {
+        void handleDownload();
+    });
     return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Box, { borderStyle: "double", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Playlists" }) }), playlists.length === 0 ? (_jsx(Text, { color: theme.colors.dim, children: "No playlists yet" })) : (playlists.map((playlist, index) => {
                 const isSelected = index === selectedIndex;
                 const isRenaming = renamingPlaylistId === playlist.playlistId && isSelected;
                 const rowBackground = isSelected ? theme.colors.secondary : undefined;
                 return (_jsxs(Box, { paddingX: 1, backgroundColor: rowBackground, children: [_jsxs(Text, { color: isSelected ? theme.colors.background : theme.colors.primary, bold: isSelected, children: [index + 1, "."] }), _jsx(Text, { children: " " }), _jsxs(Box, { flexDirection: "column", children: [isRenaming ? (_jsx(TextInput, { value: renameValue, onChange: setRenameValue, onSubmit: handleRenameSubmit, placeholder: "Playlist name", focus: true })) : (_jsx(Text, { color: isSelected ? theme.colors.background : theme.colors.text, bold: isSelected, children: playlist.name })), _jsx(Text, { color: theme.colors.dim, children: ` (${playlist.tracks.length} tracks)` })] })] }, playlist.playlistId));
-            })), _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsx(Text, { color: theme.colors.text, children: "Enter" }), " to play playlist |", ' ', _jsx(Text, { color: theme.colors.text, children: "r" }), " to rename |", ' ', _jsx(Text, { color: theme.colors.text, children: "c" }), " to create |", ' ', _jsx(Text, { color: theme.colors.text, children: "Esc" }), " to go back"] }), lastCreated && (_jsxs(Text, { color: theme.colors.accent, children: [" Created ", lastCreated] }))] })] }));
+            })), _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsx(Text, { color: theme.colors.text, children: "Enter" }), " to play |", ' ', _jsx(Text, { color: theme.colors.text, children: "r" }), " rename |", ' ', _jsx(Text, { color: theme.colors.text, children: "c" }), " create |", ' ', _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " download |", ' ', _jsx(Text, { color: theme.colors.text, children: "D" }), " delete |", ' ', _jsx(Text, { color: theme.colors.text, children: "Esc" }), " back"] }), lastCreated && (_jsxs(Text, { color: theme.colors.accent, children: [" Created ", lastCreated] })), downloadStatus && (_jsx(Text, { color: theme.colors.accent, children: downloadStatus }))] })] }));
 }

package/dist/source/components/search/SearchResults.d.ts

@@ -5,7 +5,8 @@ type Props = {
     selectedIndex: number;
     isActive?: boolean;
     onMixCreated?: (message: string) => void;
+    onDownloadStatus?: (message: string) => void;
 };
-declare function SearchResults({ results, selectedIndex, isActive, onMixCreated, }: Props): import("react/jsx-runtime").JSX.Element | null;
+declare function SearchResults({ results, selectedIndex, isActive, onMixCreated, onDownloadStatus, }: Props): import("react/jsx-runtime").JSX.Element | null;
 declare const _default: React.MemoExoticComponent<typeof SearchResults>;
 export default _default;

package/dist/source/components/search/SearchResults.js

@@ -7,23 +7,28 @@ import { useNavigation } from "../../hooks/useNavigation.js";
 import { useKeyBinding } from "../../hooks/useKeyboard.js";
 import { usePlayer } from "../../hooks/usePlayer.js";
 import { usePlaylist } from "../../hooks/usePlaylist.js";
-import { KEYBINDINGS } from "../../utils/constants.js";
+import { KEYBINDINGS, VIEW } from "../../utils/constants.js";
 import { truncate } from "../../utils/format.js";
-import { useCallback, useRef, useEffect } from 'react';
+import { useCallback, useRef, useEffect, useState } from 'react';
 import { logger } from "../../services/logger/logger.service.js";
 import { useTerminalSize } from "../../hooks/useTerminalSize.js";
 import { getMusicService } from "../../services/youtube-music/api.js";
+import { getDownloadService } from "../../services/download/download.service.js";
 // Generate unique component instance ID
 let instanceCounter = 0;
-function SearchResults({ results, selectedIndex, isActive = true, onMixCreated, }) {
+function SearchResults({ results, selectedIndex, isActive = true, onMixCreated, onDownloadStatus, }) {
     const { theme } = useTheme();
     const { dispatch } = useNavigation();
     const { play, dispatch: playerDispatch } = usePlayer();
     const { columns } = useTerminalSize();
     const musicService = getMusicService();
+    const downloadService = getDownloadService();
     const { createPlaylist } = usePlaylist();
+    const [isDownloading, setIsDownloading] = useState(false);
     const mixCreatedRef = useRef(onMixCreated);
     mixCreatedRef.current = onMixCreated;
+    const downloadStatusRef = useRef(onDownloadStatus);
+    downloadStatusRef.current = onDownloadStatus;
     // Track component instance and last action time for debouncing
     const instanceIdRef = useRef(++instanceCounter);
     const lastSelectTime = useRef(0);
@@ -206,21 +211,60 @@ function SearchResults({ results, selectedIndex, isActive = true, onMixCreated,
         if (firstTrack) {
             playerDispatch({ category: 'PLAY', track: firstTrack });
         }
+        // Navigate to player view so the user lands on the queue/player
+        dispatch({ category: 'NAVIGATE', view: VIEW.PLAYER });
         mixCreatedRef.current?.(`Created mix "${playlist.name}" with ${uniqueTracks.length} tracks — playing now.`);
     }, [
         createPlaylist,
+        dispatch,
         isActive,
         musicService,
         playerDispatch,
         results,
         selectedIndex,
     ]);
+    const downloadSelected = useCallback(async () => {
+        if (!isActive)
+            return;
+        if (isDownloading) {
+            downloadStatusRef.current?.('Download already in progress. Please wait.');
+            return;
+        }
+        const selected = results[selectedIndex];
+        if (!selected)
+            return;
+        const config = downloadService.getConfig();
+        if (!config.enabled) {
+            downloadStatusRef.current?.('Downloads are disabled. Enable Download Feature in Settings.');
+            return;
+        }
+        try {
+            setIsDownloading(true);
+            const target = await downloadService.resolveSearchTarget(selected);
+            if (target.tracks.length === 0) {
+                downloadStatusRef.current?.(`No tracks found for "${target.name}".`);
+                return;
+            }
+            downloadStatusRef.current?.(`Downloading ${target.tracks.length} track(s) from "${target.name}"... this can take a few minutes.`);
+            const summary = await downloadService.downloadTracks(target.tracks);
+            downloadStatusRef.current?.(`Downloaded ${summary.downloaded}, skipped ${summary.skipped}, failed ${summary.failed}.`);
+        }
+        catch (error) {
+            downloadStatusRef.current?.(error instanceof Error ? error.message : 'Download failed.');
+        }
+        finally {
+            setIsDownloading(false);
+        }
+    }, [downloadService, isActive, isDownloading, results, selectedIndex]);
     useKeyBinding(KEYBINDINGS.UP, navigateUp);
     useKeyBinding(KEYBINDINGS.DOWN, navigateDown);
     useKeyBinding(KEYBINDINGS.SELECT, handleSelect);
     useKeyBinding(KEYBINDINGS.CREATE_MIX, () => {
         void createMixPlaylist();
     });
+    useKeyBinding(KEYBINDINGS.DOWNLOAD, () => {
+        void downloadSelected();
+    });
     // Note: Removed redundant useEffect that was syncing selectedIndex to dispatch
     // This was causing unnecessary re-renders. The selectedIndex is already managed
     // by the parent component (SearchLayout) and passed down as a prop.

package/dist/source/components/settings/Settings.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Settings component
 import { useState } from 'react';
 import { Box, Text } from 'ink';
+import TextInput from 'ink-text-input';
 import { useTheme } from "../../hooks/useTheme.js";
 import { useNavigation } from "../../hooks/useNavigation.js";
 import { getConfigService } from "../../services/config/config.service.js";
@@ -9,12 +10,17 @@ import { useKeyBinding } from "../../hooks/useKeyboard.js";
 import { KEYBINDINGS, VIEW } from "../../utils/constants.js";
 import { useSleepTimer } from "../../hooks/useSleepTimer.js";
 import { formatTime } from "../../utils/format.js";
+import { useKeyboardBlocker } from "../../hooks/useKeyboardBlocker.js";
 const QUALITIES = ['low', 'medium', 'high'];
+const DOWNLOAD_FORMATS = ['mp3', 'm4a'];
 const SETTINGS_ITEMS = [
     'Stream Quality',
     'Audio Normalization',
     'Notifications',
     'Discord Rich Presence',
+    'Downloads Enabled',
+    'Download Folder',
+    'Download Format',
     'Sleep Timer',
     'Custom Keybindings',
     'Manage Plugins',
@@ -28,7 +34,12 @@ export default function Settings() {
     const [audioNormalization, setAudioNormalization] = useState(config.get('audioNormalization') ?? false);
     const [notifications, setNotifications] = useState(config.get('notifications') ?? false);
     const [discordRpc, setDiscordRpc] = useState(config.get('discordRichPresence') ?? false);
+    const [downloadsEnabled, setDownloadsEnabled] = useState(config.get('downloadsEnabled') ?? false);
+    const [downloadDirectory, setDownloadDirectory] = useState(config.get('downloadDirectory') ?? '');
+    const [downloadFormat, setDownloadFormat] = useState(config.get('downloadFormat') ?? 'mp3');
+    const [isEditingDownloadDirectory, setIsEditingDownloadDirectory] = useState(false);
     const { isActive, activeMinutes, remainingSeconds, startTimer, cancelTimer, presets, } = useSleepTimer();
+    useKeyboardBlocker(isEditingDownloadDirectory);
     const navigateUp = () => {
         setSelectedIndex(prev => Math.max(0, prev - 1));
     };
@@ -56,6 +67,17 @@ export default function Settings() {
         setDiscordRpc(next);
         config.set('discordRichPresence', next);
     };
+    const toggleDownloadsEnabled = () => {
+        const next = !downloadsEnabled;
+        setDownloadsEnabled(next);
+        config.set('downloadsEnabled', next);
+    };
+    const cycleDownloadFormat = () => {
+        const currentIndex = DOWNLOAD_FORMATS.indexOf(downloadFormat);
+        const nextFormat = DOWNLOAD_FORMATS[(currentIndex + 1) % DOWNLOAD_FORMATS.length];
+        setDownloadFormat(nextFormat);
+        config.set('downloadFormat', nextFormat);
+    };
     const cycleSleepTimer = () => {
         if (isActive) {
             cancelTimer();
@@ -82,12 +104,21 @@ export default function Settings() {
             toggleDiscordRpc();
         }
         else if (selectedIndex === 4) {
-            cycleSleepTimer();
+            toggleDownloadsEnabled();
         }
         else if (selectedIndex === 5) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+            setIsEditingDownloadDirectory(true);
         }
         else if (selectedIndex === 6) {
+            cycleDownloadFormat();
+        }
+        else if (selectedIndex === 7) {
+            cycleSleepTimer();
+        }
+        else if (selectedIndex === 8) {
+            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+        }
+        else if (selectedIndex === 9) {
             dispatch({ category: 'NAVIGATE', view: VIEW.PLUGINS });
         }
     };
@@ -97,9 +128,19 @@ export default function Settings() {
     const sleepTimerLabel = isActive && remainingSeconds !== null
         ? `Sleep Timer: ${formatTime(remainingSeconds)} remaining (Enter to cancel)`
         : 'Sleep Timer: Off (Enter to set)';
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Box, { borderStyle: "double", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Settings" }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 0 ? theme.colors.primary : undefined, color: selectedIndex === 0 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 0, children: ["Stream Quality: ", quality.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 1 ? theme.colors.primary : undefined, color: selectedIndex === 1 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 1, children: ["Audio Normalization: ", audioNormalization ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 2 ? theme.colors.primary : undefined, color: selectedIndex === 2 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 2, children: ["Desktop Notifications: ", notifications ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 3 ? theme.colors.primary : undefined, color: selectedIndex === 3 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 3, children: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 4 ? theme.colors.primary : undefined, color: selectedIndex === 4
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Box, { borderStyle: "double", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Settings" }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 0 ? theme.colors.primary : undefined, color: selectedIndex === 0 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 0, children: ["Stream Quality: ", quality.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 1 ? theme.colors.primary : undefined, color: selectedIndex === 1 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 1, children: ["Audio Normalization: ", audioNormalization ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 2 ? theme.colors.primary : undefined, color: selectedIndex === 2 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 2, children: ["Desktop Notifications: ", notifications ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 3 ? theme.colors.primary : undefined, color: selectedIndex === 3 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 3, children: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 4 ? theme.colors.primary : undefined, color: selectedIndex === 4 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 4, children: ["Download Feature: ", downloadsEnabled ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: isEditingDownloadDirectory && selectedIndex === 5 ? (_jsx(TextInput, { value: downloadDirectory, onChange: setDownloadDirectory, onSubmit: value => {
+                        const normalized = value.trim();
+                        if (!normalized) {
+                            setDownloadDirectory(config.get('downloadDirectory') ?? '');
+                            setIsEditingDownloadDirectory(false);
+                            return;
+                        }
+                        setDownloadDirectory(normalized);
+                        config.set('downloadDirectory', normalized);
+                        setIsEditingDownloadDirectory(false);
+                    }, placeholder: "Download directory", focus: true })) : (_jsxs(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: ["Download Folder: ", downloadDirectory] })) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 6 ? theme.colors.primary : undefined, color: selectedIndex === 6 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 6, children: ["Download Format: ", downloadFormat.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 7 ? theme.colors.primary : undefined, color: selectedIndex === 7
                         ? theme.colors.background
                         : isActive
                             ? theme.colors.accent
-                            : theme.colors.text, bold: selectedIndex === 4, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: "Custom Keybindings \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 6 ? theme.colors.primary : undefined, color: selectedIndex === 6 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 6, children: "Manage Plugins" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.colors.dim, children: "Arrows to navigate, Enter to select, Esc/q to go back" }) })] }));
+                            : theme.colors.text, bold: selectedIndex === 7, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 8 ? theme.colors.primary : undefined, color: selectedIndex === 8 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 8, children: "Custom Keybindings \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 9 ? theme.colors.primary : undefined, color: selectedIndex === 9 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 9, children: "Manage Plugins" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.colors.dim, children: "Arrows to navigate, Enter to select, Esc/q to go back" }) })] }));
 }

package/dist/source/services/config/config.service.js

@@ -2,6 +2,7 @@
 import { CONFIG_DIR, CONFIG_FILE } from "../../utils/constants.js";
 import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { BUILTIN_THEMES, DEFAULT_THEME } from "../../config/themes.config.js";
+import path from 'node:path';
 class ConfigService {
     configPath;
     configDir;
@@ -27,6 +28,9 @@ class ConfigService {
             audioNormalization: false,
             notifications: false,
             discordRichPresence: false,
+            downloadsEnabled: false,
+            downloadDirectory: path.join(CONFIG_DIR, 'downloads'),
+            downloadFormat: 'mp3',
         };
     }
     load() {

package/dist/source/services/download/download.service.d.ts

@@ -0,0 +1,38 @@
+import type { DownloadFormat } from '../../types/config.types.ts';
+import type { Playlist, SearchResult, Track } from '../../types/youtube-music.types.ts';
+type DownloadResult = {
+    downloaded: number;
+    skipped: number;
+    failed: number;
+    errors: string[];
+};
+type DownloadTarget = {
+    name: string;
+    tracks: Track[];
+};
+declare class DownloadService {
+    private ffmpegChecked;
+    private ffmpegAvailable;
+    private activeDownload;
+    private readonly config;
+    private readonly musicService;
+    getConfig(): {
+        enabled: boolean;
+        directory: string;
+        format: DownloadFormat;
+    };
+    resolveSearchTarget(result: SearchResult): Promise<DownloadTarget>;
+    resolvePlaylistTarget(playlist: Playlist): DownloadTarget;
+    downloadTracks(tracks: Track[]): Promise<DownloadResult>;
+    private uniqueTracks;
+    private getDestinationPath;
+    private sanitizeFilename;
+    private fetchAudio;
+    private ensureFfmpeg;
+    private convertAudio;
+    private runFfmpeg;
+    private recordViaYtDlp;
+    private recordViaMpv;
+}
+export declare function getDownloadService(): DownloadService;
+export {};