@involvex/youtube-music-cli 0.0.8 → 0.0.11

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [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
+
+- **search:** add dynamic mix creation from search results ([0d50231](https://github.com/involvex/youtube-music-cli/commit/0d5023168c73cec9d22dab9808e0fb2f23b5c1cc))
+
 ## [0.0.8](https://github.com/involvex/youtube-music-cli/compare/v0.0.7...v0.0.8) (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

@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useNavigation } from "../../hooks/useNavigation.js";
 import { useYouTubeMusic } from "../../hooks/useYouTubeMusic.js";
 import SearchResults from "../search/SearchResults.js";
-import { useState, useCallback, useEffect } from 'react';
+import { useState, useCallback, useEffect, useRef } from 'react';
 import React from 'react';
 import { useTheme } from "../../hooks/useTheme.js";
 import SearchBar from "../search/SearchBar.js";
@@ -17,6 +17,8 @@ function SearchLayout() {
     const [results, setResults] = useState([]);
     const [isTyping, setIsTyping] = useState(true);
     const [isSearching, setIsSearching] = useState(false);
+    const [actionMessage, setActionMessage] = useState(null);
+    const actionTimeoutRef = useRef(null);
     // Handle search action
     const performSearch = useCallback(async (query) => {
         if (!query || isSearching)
@@ -71,6 +73,33 @@ function SearchLayout() {
         }
     }, [isTyping, dispatch]);
     useKeyBinding(KEYBINDINGS.BACK, goBack);
+    const handleMixCreated = useCallback((message) => {
+        setActionMessage(message);
+        if (actionTimeoutRef.current) {
+            clearTimeout(actionTimeoutRef.current);
+        }
+        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 (actionTimeoutRef.current) {
+                clearTimeout(actionTimeoutRef.current);
+            }
+        };
+    }, []);
     // Reset search state when leaving view
     useEffect(() => {
         return () => {
@@ -81,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 })), !isLoading && navState.hasSearched && results.length === 0 && !error && (_jsx(Text, { color: theme.colors.dim, children: "No results found" })), _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, ]/[ 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,20 +10,23 @@ 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);
     useKeyboardBlocker(renamingPlaylistId !== null);
     const handleCreate = useCallback(() => {
         const name = `Playlist ${playlists.length + 1}`;
-        createPlaylist(name);
-        setLastCreated(name);
+        const playlist = createPlaylist(name);
+        setLastCreated(playlist.name);
         setSelectedIndex(playlists.length);
     }, [createPlaylist, playlists.length]);
     const navigateUp = useCallback(() => {
@@ -67,16 +70,54 @@ 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;
+        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}"...`);
+        try {
+            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.');
+        }
+    }, [downloadService, 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

@@ -4,7 +4,9 @@ type Props = {
     results: SearchResult[];
     selectedIndex: number;
     isActive?: boolean;
+    onMixCreated?: (message: string) => void;
+    onDownloadStatus?: (message: string) => void;
 };
-declare function SearchResults({ results, selectedIndex, isActive }: 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

@@ -6,20 +6,28 @@ import { useTheme } from "../../hooks/useTheme.js";
 import { useNavigation } from "../../hooks/useNavigation.js";
 import { useKeyBinding } from "../../hooks/useKeyboard.js";
 import { usePlayer } from "../../hooks/usePlayer.js";
-import { KEYBINDINGS } from "../../utils/constants.js";
+import { usePlaylist } from "../../hooks/usePlaylist.js";
+import { KEYBINDINGS, VIEW } from "../../utils/constants.js";
 import { truncate } from "../../utils/format.js";
 import { useCallback, useRef, useEffect } 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 }) {
+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 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);
@@ -123,9 +131,131 @@ function SearchResults({ results, selectedIndex, isActive = true }) {
         logger.debug('SearchResults', 'SELECT key pressed', { isActive, instanceId });
         playSelected();
     }, [isActive, playSelected]);
+    const createMixPlaylist = useCallback(async () => {
+        if (!isActive)
+            return;
+        const selected = results[selectedIndex];
+        if (!selected) {
+            logger.warn('SearchResults', 'No result selected for mix');
+            return;
+        }
+        let playlistName = 'Dynamic mix';
+        const collectedTracks = [];
+        if (selected.type === 'song') {
+            const selectedTrack = selected.data;
+            const title = selectedTrack.title || 'selected track';
+            playlistName = `Mix for ${title}`;
+            collectedTracks.push(selectedTrack);
+            try {
+                const suggestions = await musicService.getSuggestions(selectedTrack.videoId);
+                collectedTracks.push(...suggestions);
+            }
+            catch (error) {
+                logger.error('SearchResults', 'Failed to fetch song suggestions', {
+                    error,
+                });
+            }
+        }
+        else if (selected.type === 'artist') {
+            const artistName = 'name' in selected.data ? selected.data.name : '';
+            if (!artistName) {
+                logger.warn('SearchResults', 'Artist name missing for mix');
+                mixCreatedRef.current?.('Artist information is missing, cannot create mix.');
+                return;
+            }
+            playlistName = `${artistName} mix`;
+            try {
+                const response = await musicService.search(artistName, {
+                    type: 'songs',
+                    limit: 25,
+                });
+                const artistTracks = response.results
+                    .filter(result => result.type === 'song')
+                    .map(result => result.data);
+                collectedTracks.push(...artistTracks);
+            }
+            catch (error) {
+                logger.error('SearchResults', 'Failed to fetch artist songs for mix', {
+                    error,
+                });
+            }
+        }
+        else {
+            logger.warn('SearchResults', 'Mix creation unsupported result type', {
+                type: selected.type,
+            });
+            mixCreatedRef.current?.('Mix creation is only supported for songs and artists.');
+            return;
+        }
+        const uniqueTracks = [];
+        const seenVideoIds = new Set();
+        for (const track of collectedTracks) {
+            if (!track?.videoId || seenVideoIds.has(track.videoId))
+                continue;
+            seenVideoIds.add(track.videoId);
+            uniqueTracks.push(track);
+        }
+        if (uniqueTracks.length === 0) {
+            mixCreatedRef.current?.('No similar tracks were found to create a mix.');
+            return;
+        }
+        const playlist = createPlaylist(playlistName, uniqueTracks);
+        logger.info('SearchResults', 'Mix playlist created', {
+            name: playlist.name,
+            trackCount: uniqueTracks.length,
+        });
+        // Queue the mix tracks and start playing the first one
+        playerDispatch({ category: 'SET_QUEUE', queue: uniqueTracks });
+        const firstTrack = uniqueTracks[0];
+        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;
+        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 {
+            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}"...`);
+            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.');
+        }
+    }, [downloadService, isActive, 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/hooks/usePlaylist.d.ts

@@ -2,7 +2,7 @@ import type { Playlist, Track } from '../types/youtube-music.types.ts';
 export type AddTrackResult = 'added' | 'duplicate';
 export declare function usePlaylist(): {
     playlists: Playlist[];
-    createPlaylist: (name: string) => void;
+    createPlaylist: (name: string, tracks?: Track[]) => Playlist;
     deletePlaylist: (playlistId: string) => void;
     renamePlaylist: (playlistId: string, newName: string) => void;
     addTrackToPlaylist: (playlistId: string, track: Track, force?: boolean) => AddTrackResult;

package/dist/source/hooks/usePlaylist.js

@@ -7,15 +7,16 @@ export function usePlaylist() {
     useEffect(() => {
         setPlaylists(configService.get('playlists'));
     }, []);
-    const createPlaylist = useCallback((name) => {
+    const createPlaylist = useCallback((name, tracks = []) => {
         const newPlaylist = {
             playlistId: Date.now().toString(),
             name,
-            tracks: [],
+            tracks: tracks.map(track => ({ ...track })),
         };
         const updatedPlaylists = [...playlists, newPlaylist];
         setPlaylists(updatedPlaylists);
         configService.set('playlists', updatedPlaylists);
+        return newPlaylist;
     }, [playlists, configService]);
     const deletePlaylist = useCallback((playlistId) => {
         const updatedPlaylists = playlists.filter(p => p.playlistId !== playlistId);

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,35 @@
+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 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;
+}
+export declare function getDownloadService(): DownloadService;
+export {};

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

@@ -0,0 +1,197 @@
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { getConfigService } from "../config/config.service.js";
+import { logger } from "../logger/logger.service.js";
+import { getMusicService } from "../youtube-music/api.js";
+class DownloadService {
+    ffmpegChecked = false;
+    ffmpegAvailable = false;
+    config = getConfigService();
+    musicService = getMusicService();
+    getConfig() {
+        return {
+            enabled: this.config.get('downloadsEnabled') ?? false,
+            directory: this.config.get('downloadDirectory') ?? '',
+            format: (this.config.get('downloadFormat') ?? 'mp3'),
+        };
+    }
+    async resolveSearchTarget(result) {
+        if (result.type === 'song') {
+            const track = result.data;
+            return { name: track.title, tracks: [track] };
+        }
+        if (result.type === 'artist') {
+            const artistName = 'name' in result.data ? result.data.name : '';
+            if (!artistName) {
+                throw new Error('Artist name is missing.');
+            }
+            const response = await this.musicService.search(artistName, {
+                type: 'songs',
+                limit: 25,
+            });
+            const tracks = response.results
+                .filter(row => row.type === 'song')
+                .map(row => row.data);
+            return { name: artistName, tracks: this.uniqueTracks(tracks) };
+        }
+        if (result.type === 'playlist') {
+            const playlistInfo = result.data;
+            if (!playlistInfo.playlistId) {
+                throw new Error('Playlist id is missing.');
+            }
+            const playlist = await this.musicService.getPlaylist(playlistInfo.playlistId);
+            return {
+                name: playlist.name || playlistInfo.name || 'playlist',
+                tracks: this.uniqueTracks(playlist.tracks),
+            };
+        }
+        throw new Error('Downloads are supported for songs, artists, and playlists.');
+    }
+    resolvePlaylistTarget(playlist) {
+        return {
+            name: playlist.name,
+            tracks: this.uniqueTracks(playlist.tracks),
+        };
+    }
+    async downloadTracks(tracks) {
+        const { directory, format } = this.getConfig();
+        if (!directory) {
+            throw new Error('No download directory configured.');
+        }
+        mkdirSync(directory, { recursive: true });
+        await this.ensureFfmpeg();
+        const result = {
+            downloaded: 0,
+            skipped: 0,
+            failed: 0,
+            errors: [],
+        };
+        for (const track of tracks) {
+            const destination = this.getDestinationPath(track, directory, format);
+            const tempSource = `${destination}.source`;
+            try {
+                if (existsSync(destination)) {
+                    result.skipped++;
+                    continue;
+                }
+                const streamUrl = await this.musicService.getStreamUrl(track.videoId);
+                const audioBuffer = await this.fetchAudio(streamUrl);
+                writeFileSync(tempSource, audioBuffer);
+                await this.convertAudio(tempSource, destination, format);
+                result.downloaded++;
+            }
+            catch (error) {
+                result.failed++;
+                const message = error instanceof Error ? error.message : 'Unknown download failure';
+                result.errors.push(message);
+                logger.error('DownloadService', 'Track download failed', {
+                    videoId: track.videoId,
+                    title: track.title,
+                    error: message,
+                });
+            }
+            finally {
+                if (existsSync(tempSource)) {
+                    unlinkSync(tempSource);
+                }
+            }
+        }
+        return result;
+    }
+    uniqueTracks(tracks) {
+        const seen = new Set();
+        const unique = [];
+        for (const track of tracks) {
+            if (!track?.videoId || seen.has(track.videoId))
+                continue;
+            seen.add(track.videoId);
+            unique.push(track);
+        }
+        return unique;
+    }
+    getDestinationPath(track, directory, format) {
+        const artist = track.artists[0]?.name ?? 'Unknown Artist';
+        const baseName = this.sanitizeFilename(`${artist} - ${track.title}`);
+        return path.join(directory, `${baseName}.${format}`);
+    }
+    sanitizeFilename(value) {
+        return value.replace(/[<>:"/\\|?*\u0000-\u001F]/g, '_').trim();
+    }
+    async fetchAudio(url) {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch audio stream (${response.status}).`);
+        }
+        const audio = await response.arrayBuffer();
+        return Buffer.from(audio);
+    }
+    async ensureFfmpeg() {
+        if (this.ffmpegChecked) {
+            if (!this.ffmpegAvailable) {
+                throw new Error('ffmpeg is required for downloads. Install ffmpeg and ensure it is available in PATH.');
+            }
+            return;
+        }
+        this.ffmpegChecked = true;
+        try {
+            await this.runFfmpeg(['-version']);
+            this.ffmpegAvailable = true;
+        }
+        catch {
+            this.ffmpegAvailable = false;
+            throw new Error('ffmpeg is required for downloads. Install ffmpeg and ensure it is available in PATH.');
+        }
+    }
+    async convertAudio(sourcePath, destinationPath, format) {
+        if (format === 'mp3') {
+            await this.runFfmpeg([
+                '-y',
+                '-i',
+                sourcePath,
+                '-vn',
+                '-codec:a',
+                'libmp3lame',
+                '-q:a',
+                '2',
+                destinationPath,
+            ]);
+            return;
+        }
+        await this.runFfmpeg([
+            '-y',
+            '-i',
+            sourcePath,
+            '-vn',
+            '-codec:a',
+            'aac',
+            '-b:a',
+            '192k',
+            destinationPath,
+        ]);
+    }
+    async runFfmpeg(args) {
+        await new Promise((resolve, reject) => {
+            const process = spawn('ffmpeg', args, { windowsHide: true });
+            let stderr = '';
+            process.stderr.on('data', chunk => {
+                stderr += String(chunk);
+            });
+            process.on('error', reject);
+            process.on('exit', code => {
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                reject(new Error(stderr.trim() || `ffmpeg exited with code ${code}`));
+            });
+        });
+    }
+}
+let downloadServiceInstance = null;
+export function getDownloadService() {
+    if (!downloadServiceInstance) {
+        downloadServiceInstance = new DownloadService();
+    }
+    return downloadServiceInstance;
+}

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

@@ -21,6 +21,7 @@ declare class PlayerService {
     private ipcConnectRetries;
     private readonly maxIpcRetries;
     private currentTrackId;
+    private playSessionId;
     private constructor();
     static getInstance(): PlayerService;
     getCurrentTrackId(): string | null;
@@ -29,7 +30,7 @@ declare class PlayerService {
      */
     onEvent(callback: PlayerEventCallback): void;
     /**
-     * Generate IPC socket path based on platform
+     * Generate IPC socket path based on platform, unique per play session
      */
     private getIpcPath;
     /**

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

@@ -14,6 +14,7 @@ class PlayerService {
     ipcConnectRetries = 0;
     maxIpcRetries = 10;
     currentTrackId = null; // Track currently playing
+    playSessionId = 0; // Incremented per play() call for unique IPC paths
     constructor() { }
     static getInstance() {
         if (!PlayerService.instance) {
@@ -31,16 +32,16 @@ class PlayerService {
         this.eventCallback = callback;
     }
     /**
-     * Generate IPC socket path based on platform
+     * Generate IPC socket path based on platform, unique per play session
      */
     getIpcPath() {
         if (process.platform === 'win32') {
             // Windows named pipe
-            return `\\\\.\\pipe\\mpvsocket-${process.pid}`;
+            return `\\\\.\\pipe\\mpvsocket-${process.pid}-${this.playSessionId}`;
         }
         else {
             // Unix domain socket
-            return `/tmp/mpvsocket-${process.pid}`;
+            return `/tmp/mpvsocket-${process.pid}-${this.playSessionId}`;
         }
     }
     /**
@@ -193,6 +194,8 @@ class PlayerService {
         if (!url.startsWith('http')) {
             playUrl = `https://www.youtube.com/watch?v=${url}`;
         }
+        // Increment session ID for a unique IPC socket path per play call
+        this.playSessionId++;
         // Generate IPC socket path
         this.ipcPath = this.getIpcPath();
         return new Promise((resolve, reject) => {
@@ -223,8 +226,11 @@ class PlayerService {
                     mpvArgs.push(`--http-proxy=${options.proxy}`);
                 }
                 mpvArgs.push(playUrl);
-                this.mpvProcess = spawn('mpv', mpvArgs);
-                if (!this.mpvProcess.stdout || !this.mpvProcess.stderr) {
+                // Capture process in local var so stale exit handlers from a killed
+                // process don't overwrite state belonging to a newly-spawned process.
+                const spawnedProcess = spawn('mpv', mpvArgs);
+                this.mpvProcess = spawnedProcess;
+                if (!spawnedProcess.stdout || !spawnedProcess.stderr) {
                     throw new Error('Failed to create mpv process streams');
                 }
                 this.isPlaying = true;
@@ -238,27 +244,30 @@ class PlayerService {
                     });
                 }, 200);
                 // Handle stdout (should be minimal with --really-quiet)
-                this.mpvProcess.stdout.on('data', (data) => {
+                spawnedProcess.stdout.on('data', (data) => {
                     logger.debug('PlayerService', 'mpv stdout', {
                         output: data.toString().trim(),
                     });
                 });
                 // Handle stderr (errors)
-                this.mpvProcess.stderr.on('data', (data) => {
+                spawnedProcess.stderr.on('data', (data) => {
                     const error = data.toString().trim();
                     if (error) {
                         logger.error('PlayerService', 'mpv stderr', { error });
                     }
                 });
-                // Handle process exit
-                this.mpvProcess.on('exit', (code, signal) => {
+                // Handle process exit — guard against stale handlers from killed processes
+                spawnedProcess.on('exit', (code, signal) => {
                     logger.info('PlayerService', 'mpv process exited', {
                         code,
                         signal,
                         wasPlaying: this.isPlaying,
                     });
-                    this.isPlaying = false;
-                    this.mpvProcess = null;
+                    // Only update shared state if this is still the active process
+                    if (this.mpvProcess === spawnedProcess) {
+                        this.isPlaying = false;
+                        this.mpvProcess = null;
+                    }
                     if (code === 0) {
                         // Normal exit (track finished)
                         resolve();
@@ -269,14 +278,16 @@ class PlayerService {
                     }
                     // If killed by signal, don't reject (user stopped it)
                 });
-                // Handle errors
-                this.mpvProcess.on('error', (error) => {
+                // Handle errors — same guard
+                spawnedProcess.on('error', (error) => {
                     logger.error('PlayerService', 'mpv process error', {
                         error: error.message,
                         stack: error.stack,
                     });
-                    this.isPlaying = false;
-                    this.mpvProcess = null;
+                    if (this.mpvProcess === spawnedProcess) {
+                        this.isPlaying = false;
+                        this.mpvProcess = null;
+                    }
                     reject(error);
                 });
                 logger.info('PlayerService', 'mpv process started successfully');

package/dist/source/services/youtube-music/api.js

@@ -124,11 +124,50 @@ class MusicService {
         };
     }
     async getPlaylist(playlistId) {
-        return {
-            playlistId,
-            name: 'Unknown Playlist',
-            tracks: [],
-        };
+        try {
+            const yt = await getClient();
+            const playlistData = (await yt.music.getPlaylist(playlistId));
+            const rows = [
+                ...(playlistData.contents ?? []),
+                ...(playlistData.tracks ?? []),
+            ];
+            const seen = new Set();
+            const tracks = [];
+            for (const row of rows) {
+                const videoId = row.id || row.video_id;
+                if (!videoId || seen.has(videoId))
+                    continue;
+                seen.add(videoId);
+                tracks.push({
+                    videoId,
+                    title: (typeof row.title === 'string' ? row.title : row.title?.text) ??
+                        'Unknown',
+                    artists: (row.artists ?? []).map(artist => ({
+                        artistId: artist.channel_id || artist.id || '',
+                        name: artist.name ?? 'Unknown',
+                    })),
+                    duration: typeof row.duration === 'number'
+                        ? row.duration
+                        : (row.duration?.seconds ?? 0),
+                });
+            }
+            return {
+                playlistId,
+                name: playlistData.title || playlistData.name || 'Unknown Playlist',
+                tracks,
+            };
+        }
+        catch (error) {
+            logger.error('MusicService', 'getPlaylist failed', {
+                playlistId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                playlistId,
+                name: 'Unknown Playlist',
+                tracks: [],
+            };
+        }
     }
     async getTrending() {
         try {
@@ -218,37 +257,39 @@ class MusicService {
     async getSuggestions(trackId) {
         try {
             const yt = await getClient();
-            let video = null;
-            try {
-                video = (await yt.getInfo(trackId));
-            }
-            catch (error) {
-                logger.warn('MusicService', 'getSuggestions getInfo failed', {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-                return [];
-            }
-            const suggestions = video?.related?.contents ?? [];
+            // Use music.getUpNext with automix — avoids the yt.getInfo() ParsingError
+            // caused by YouTube "Remove ads" menu items that youtubei.js can't parse.
+            const panel = await yt.music.getUpNext(trackId, true);
             const tracks = [];
-            for (const item of suggestions) {
-                const videoId = item?.id || '';
-                if (!videoId)
+            for (const item of panel.contents) {
+                const video = item;
+                const videoId = video.video_id;
+                if (!videoId || videoId === trackId)
                     continue;
-                const title = typeof item.title === 'string' ? item.title : item.title?.text;
+                const title = typeof video.title === 'string'
+                    ? video.title
+                    : (video.title?.text ?? '');
                 if (!title)
                     continue;
                 tracks.push({
                     videoId,
                     title,
-                    artists: [],
+                    artists: (video.artists ?? []).map(a => ({
+                        artistId: a.channel_id ?? '',
+                        name: a.name ?? 'Unknown',
+                    })),
+                    duration: video.duration?.seconds ?? 0,
                 });
             }
-            return tracks.slice(0, 10);
+            logger.debug('MusicService', 'getSuggestions success', {
+                trackId,
+                count: tracks.length,
+            });
+            return tracks.slice(0, 15);
         }
         catch (error) {
-            logger.error('MusicService', 'getSuggestions failed', {
-                error: error instanceof Error ? error.message : String(error),
-            });
+            const message = error instanceof Error ? error.message : String(error);
+            logger.warn('MusicService', 'getSuggestions failed', { error: message });
             return [];
         }
     }

package/dist/source/stores/player.store.js

@@ -407,10 +407,18 @@ function PlayerManager() {
     }, [state.progress, state.duration, state.currentTrack]);
     // Handle play/pause state
     useEffect(() => {
-        if (!state.isPlaying) {
+        if (state.isPlaying) {
+            // Resume only if the same track is already loaded in the player service.
+            // If the track changed, the "handle track changes" effect will call play().
+            const currentTrackId = playerService.getCurrentTrackId?.() ?? '';
+            if (currentTrackId && state.currentTrack?.videoId === currentTrackId) {
+                playerService.resume();
+            }
+        }
+        else {
             playerService.pause();
         }
-    }, [state.isPlaying, playerService]);
+    }, [state.isPlaying, state.currentTrack, playerService]);
     // Handle volume changes
     useEffect(() => {
         const config = getConfigService();

package/dist/source/types/config.types.d.ts

@@ -1,6 +1,7 @@
 import type { Playlist } from './youtube-music.types.ts';
 import type { Theme } from './theme.types.ts';
 export type RepeatMode = 'off' | 'all' | 'one';
+export type DownloadFormat = 'mp3' | 'm4a';
 export interface KeybindingConfig {
     keys: string[];
     description: string;
@@ -30,4 +31,7 @@ export interface Config {
     };
     discordRichPresence?: boolean;
     proxy?: string;
+    downloadsEnabled?: boolean;
+    downloadDirectory?: string;
+    downloadFormat?: DownloadFormat;
 }

package/dist/source/utils/constants.d.ts

@@ -59,7 +59,9 @@ export declare const KEYBINDINGS: {
     readonly ADD_TO_PLAYLIST: readonly ["a"];
     readonly REMOVE_FROM_PLAYLIST: readonly ["d"];
     readonly CREATE_PLAYLIST: readonly ["c"];
+    readonly CREATE_MIX: readonly ["m"];
     readonly DELETE_PLAYLIST: readonly ["D"];
+    readonly DOWNLOAD: readonly ["shift+d"];
 };
 export declare const DEFAULT_VOLUME = 70;
 export declare const MAX_QUEUE_SIZE = 1000;

package/dist/source/utils/constants.js

@@ -71,7 +71,9 @@ export const KEYBINDINGS = {
     ADD_TO_PLAYLIST: ['a'],
     REMOVE_FROM_PLAYLIST: ['d'],
     CREATE_PLAYLIST: ['c'],
+    CREATE_MIX: ['m'],
     DELETE_PLAYLIST: ['D'],
+    DOWNLOAD: ['shift+d'],
 };
 // Default volume
 export const DEFAULT_VOLUME = 70;

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.8",
+	"version": "0.0.11",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/involvex/youtube-music-cli"
+		"url": "git+https://github.com/involvex/youtube-music-cli.git"
 	},
 	"funding": "https://github.com/sponsors/involvex",
 	"license": "MIT",
@@ -21,6 +21,20 @@
 		"LICENSE",
 		".github/FUNDING.yml"
 	],
+	"icon": "assets/icon2.PNG",
+	"sponsor": {
+		"url": "https://github.com/sponsors/involvex"
+	},
+	"homepage": "https://involvex.github.io/youtube-music-cli/",
+	"keywords": [
+		"cli",
+		"youtube",
+		"youtube-music",
+		"youtube-cli",
+		"youtube-music-cli",
+		"ink",
+		"cli-music"
+	],
 	"scripts": {
 		"prebuild": "bun run format && bun run lint:fix && bun run typecheck",
 		"build": "tsc",