@involvex/youtube-music-cli 0.0.5 → 0.0.8

package/.github/FUNDING.yml

@@ -0,0 +1,9 @@
+# These are supported funding model platforms
+
+github: [involvex]
+custom:
+  [
+    'https://buymeacoffee.com/involvex',
+    'https://paypal.me/involvex',
+    'https://rewards.bing.com/welcome?rh=14525F68&ref=rafsrchae&form=ML2XE3&OCID=ML2XE3&PUBL=RewardsDO&CREA=ML2XE3',
+  ]

package/CHANGELOG.md

@@ -0,0 +1,86 @@
+## [0.0.8](https://github.com/involvex/youtube-music-cli/compare/v0.0.7...v0.0.8) (2026-02-18)
+
+### Features
+
+- **ui:** add keyboard blocker to search bar ([ee533fe](https://github.com/involvex/youtube-music-cli/commit/ee533fe716a203d432170e36149389f5bd48d687))
+
+## [0.0.7](https://github.com/involvex/youtube-music-cli/compare/v0.0.6...v0.0.7) (2026-02-18)
+
+### Features
+
+- **ui:** add plugins and enhance playlist management ([83a043c](https://github.com/involvex/youtube-music-cli/commit/83a043c0956da7023ea198468db8bbc2ce3acb0d))
+
+### BREAKING CHANGES
+
+- **ui:** The keybinding for playlists has changed from 'p' to
+  'shift+p' to accommodate the new plugins feature.
+
+## [0.0.6](https://github.com/involvex/youtube-music-cli/compare/v0.0.5...v0.0.6) (2026-02-18)
+
+### Features
+
+- **ui:** add playlist creation and artist playback features ([0f50fd2](https://github.com/involvex/youtube-music-cli/commit/0f50fd2eeda0d340aee26b8fa2f7e5f2356d8042))
+
+## [0.0.5](https://github.com/involvex/youtube-music-cli/compare/v0.0.4...v0.0.5) (2026-02-18)
+
+## [0.0.4](https://github.com/involvex/youtube-music-cli/compare/v0.0.3...v0.0.4) (2026-02-18)
+
+### Bug Fixes
+
+- resolve three bugs - discord rpc, search history key, resume ([90c5306](https://github.com/involvex/youtube-music-cli/commit/90c530698f08c355e11d31048844b2e1d6a312ef))
+- **youtube:** guard suggestions parsing errors ([aca832e](https://github.com/involvex/youtube-music-cli/commit/aca832e27bb244f8b42b33060f2640f3cc003f7f))
+
+### Features
+
+- **assets:** add new icons and images ([a0d6558](https://github.com/involvex/youtube-music-cli/commit/a0d6558ed2fd42b470e7123eaac5ce0c602db051))
+
+## [0.0.3](https://github.com/involvex/youtube-music-cli/compare/v0.0.2...v0.0.3) (2026-02-18)
+
+### Features
+
+- add playback speed control, new themes, and notifications ([426360a](https://github.com/involvex/youtube-music-cli/commit/426360adfde0a19d7cf9706371f5bc15a4e7640b))
+
+## [0.0.2](https://github.com/involvex/youtube-music-cli/compare/v0.0.1...v0.0.2) (2026-02-18)
+
+## [0.0.1](https://github.com/involvex/youtube-music-cli/compare/32798e7dd129656b9786fc435466203a0c913705...v0.0.1) (2026-02-18)
+
+### Bug Fixes
+
+- **api:** resolve 404 error during search and improve reliability ([c26f80f](https://github.com/involvex/youtube-music-cli/commit/c26f80f3c7f4de075393da7cc378aada8809604a))
+- **api:** resolve search runtime error and integrate real streaming ([3c8066c](https://github.com/involvex/youtube-music-cli/commit/3c8066c37386ed6b2d50249cbeec4b30e012960d))
+- clear queue when playing from search results to match indices ([272690d](https://github.com/involvex/youtube-music-cli/commit/272690d2f1dd0f81fecfdad4e916f4a6f42392a2))
+- **cli:** resolve Ink crash, prevent double instances, and add features ([2dfa274](https://github.com/involvex/youtube-music-cli/commit/2dfa2747a1729037e3f88656579042892aec0b26))
+- **cli:** resolve search input issues, terminal auto-scrolling, and UI duplication ([f3898ad](https://github.com/involvex/youtube-music-cli/commit/f3898adde09d244e6705d970ab2c3af75cd7aec7))
+- **cli:** resolve search trigger and improve UI stability ([ccce4b1](https://github.com/involvex/youtube-music-cli/commit/ccce4b1a354432f04e771a7ddd957bd7ec5b8e6d))
+- **cli:** resolve terminal flooding, fix search selection, and modernize React imports ([1bdfae3](https://github.com/involvex/youtube-music-cli/commit/1bdfae307ee45cafe722590ed64c5c1fd22322ae))
+- **hooks:** resolve memory leak in useKeyboard hook ([94f4d39](https://github.com/involvex/youtube-music-cli/commit/94f4d3974a4ad0a5e609f5cc3003933978fd9008))
+- **lint:** disable no-explicit-any for react-hooks plugin in eslint.config.ts ([7a54c2a](https://github.com/involvex/youtube-music-cli/commit/7a54c2ab04dd6dfbfcc80a3c8ec86fdcb66c05c8))
+- **lint:** resolve react-hooks/exhaustive-deps error and fix hook bugs ([19cf971](https://github.com/involvex/youtube-music-cli/commit/19cf9712b049e494fba1b86e5e08f37c5f24c91e))
+- **security:** implement URL sanitization and resolve linting errors ([adb1d8f](https://github.com/involvex/youtube-music-cli/commit/adb1d8fa02830d470c14912a0c1155441224ec01))
+- simplify VOLUME_UP and VOLUME_DOWN keybindings ([571b136](https://github.com/involvex/youtube-music-cli/commit/571b136bfefefc122e9da82ce4e615d3d576b9e3))
+- **ui:** refine help display, fix help nav, and update key hints ([adb8afb](https://github.com/involvex/youtube-music-cli/commit/adb8afbba95c1495431502d9049e67bac10295a4))
+
+### Features
+
+- add .gemini agent config for CLI UI design ([e27269e](https://github.com/involvex/youtube-music-cli/commit/e27269e88bd73a23bf668ef1374f4525d06a69bd))
+- add @distube/ytdl-core dependency for YouTube downloading ([da5a8a7](https://github.com/involvex/youtube-music-cli/commit/da5a8a70cf4d65ff90dff3e7956c5d4e72740b7d))
+- add compile script for building standalone executable ([ce3d731](https://github.com/involvex/youtube-music-cli/commit/ce3d7314e42f852b4c05eb8436463a1572ef6ed0))
+- add config screen with keyboard navigation ([f9566cd](https://github.com/involvex/youtube-music-cli/commit/f9566cdd4f4818b158ecc5c45dae73b2af544f44))
+- add Help component for keyboard shortcuts display ([32798e7](https://github.com/involvex/youtube-music-cli/commit/32798e7dd129656b9786fc435466203a0c913705))
+- add player state persistence and npm publish workflow ([df7e5ce](https://github.com/involvex/youtube-music-cli/commit/df7e5ce10d13406ec0e284ff91ab8d1c38c23084))
+- add plugin system API docs, templates, and context provider ([06392dc](https://github.com/involvex/youtube-music-cli/commit/06392dc95253fe90ddfc77d0bfbb0455b517fff6))
+- add plugin system infrastructure and improve navigation ([626ada6](https://github.com/involvex/youtube-music-cli/commit/626ada679d530b66733ad58a553e72bd7b94755a))
+- add react-devtools-core dependency and bun build script ([44a2a90](https://github.com/involvex/youtube-music-cli/commit/44a2a90a6c738d3bc4637bccf0d8513b2967c363))
+- add ShortcutsBar component and prevent duplicate track playback ([af1fe32](https://github.com/involvex/youtube-music-cli/commit/af1fe32c42a49ba3ac12bb5e081dcfb31b5771c6))
+- **cli:** fix search typing, add headless mode and control commands ([506653d](https://github.com/involvex/youtube-music-cli/commit/506653d5e1e7098a87002f039a7051f7f8e7ce76))
+- **layouts:** optimize components with React.memo and responsive padding ([924991c](https://github.com/involvex/youtube-music-cli/commit/924991cc85ae7c96f38760ecce139e58175af8d1))
+- migrate audio player from play-sound to mpv ([ac1aeb3](https://github.com/involvex/youtube-music-cli/commit/ac1aeb3652ec49a5e74c0519d41055e715eb4499))
+- move PlayerControls to MainLayout for global key bindings ([4190bf0](https://github.com/involvex/youtube-music-cli/commit/4190bf0393a4f1c8602d0603a953b36d4351d89d))
+- **player:** Add IPC-based player event monitoring for mpv ([5a40ab0](https://github.com/involvex/youtube-music-cli/commit/5a40ab06679adf6569914075440dce833f1c1226))
+- **ui:** implement responsive layout, adjustable search limit, and fix search navigation ([78150d6](https://github.com/involvex/youtube-music-cli/commit/78150d675746879cce2d329333009cd8cfe8cc4d))
+
+### Performance Improvements
+
+- **cli:** optimize UI rendering and fix search result selection ([17e9f7e](https://github.com/involvex/youtube-music-cli/commit/17e9f7efc07980852fa7b1c45e002b2abd93cfd8))
+- memoize view components and remove redundant useEffect in SearchResults ([9b90902](https://github.com/involvex/youtube-music-cli/commit/9b90902d27416df0ca5bd2854e5afb46ab24b128))
+- throttle progress updates and fix exit handler stale closure ([162b732](https://github.com/involvex/youtube-music-cli/commit/162b73292fb21a3eae2cf998a8a02dbb0adc5446))

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: "p" }), " - Playlists", _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: "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"] })] })] }));
 }

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

@@ -31,5 +31,5 @@ export default function ShortcutsBar() {
     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: "n" }), " Next |", ' ', _jsx(Text, { color: theme.colors.text, children: "p" }), " Previous |", ' ', _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, "%"] })] })] }));
+    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, "%"] })] })] }));
 }

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

@@ -39,6 +39,9 @@ function MainLayout() {
     const goToSuggestions = useCallback(() => {
         dispatch({ category: 'NAVIGATE', view: VIEW.SUGGESTIONS });
     }, [dispatch]);
+    const goToPlugins = useCallback(() => {
+        dispatch({ category: 'NAVIGATE', view: VIEW.PLUGINS });
+    }, [dispatch]);
     const goToSettings = useCallback(() => {
         dispatch({ category: 'NAVIGATE', view: VIEW.SETTINGS });
     }, [dispatch]);
@@ -69,6 +72,7 @@ function MainLayout() {
     useKeyBinding(KEYBINDINGS.QUIT, handleQuit);
     useKeyBinding(KEYBINDINGS.SEARCH, goToSearch);
     useKeyBinding(KEYBINDINGS.PLAYLISTS, goToPlaylists);
+    useKeyBinding(KEYBINDINGS.PLUGINS, goToPlugins);
     useKeyBinding(KEYBINDINGS.SUGGESTIONS, goToSuggestions);
     useKeyBinding(KEYBINDINGS.SETTINGS, goToSettings);
     useKeyBinding(KEYBINDINGS.HELP, goToHelp);

package/dist/source/components/player/Suggestions.js

@@ -16,7 +16,10 @@ export default function Suggestions() {
     const [selectedIndex, setSelectedIndex] = useState(0);
     useEffect(() => {
         if (playerState.currentTrack?.videoId) {
-            getSuggestions(playerState.currentTrack.videoId).then(setSuggestions);
+            getSuggestions(playerState.currentTrack.videoId).then(tracks => {
+                setSuggestions(tracks);
+                setSelectedIndex(0);
+            });
         }
     }, [playerState.currentTrack?.videoId, getSuggestions]);
     const navigateUp = useCallback(() => {

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

@@ -1,11 +1,82 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Playlist list component
 import { Box, Text } from 'ink';
+import TextInput from 'ink-text-input';
+import { useCallback, useState } from 'react';
+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 { useTheme } from "../../hooks/useTheme.js";
-import { getConfigService } from "../../services/config/config.service.js";
+import { useKeyboardBlocker } from "../../hooks/useKeyboardBlocker.js";
+import { KEYBINDINGS } from "../../utils/constants.js";
 export default function PlaylistList() {
     const { theme } = useTheme();
-    const config = getConfigService();
-    const playlists = config.get('playlists');
-    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) => (_jsxs(Box, { paddingX: 1, children: [_jsxs(Text, { color: theme.colors.primary, children: [index + 1, "."] }), _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: playlist.name }), _jsxs(Text, { color: theme.colors.dim, children: [_jsx(Text, { children: " " }), "(", playlist.tracks?.length || 0, " tracks)"] })] }, playlist.playlistId || index)))), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.colors.dim, children: ["Press ", _jsx(Text, { color: theme.colors.text, children: "c" }), " to create playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " to go back"] }) })] }));
+    const { play, setQueue } = usePlayer();
+    const { dispatch } = useNavigation();
+    const { playlists, createPlaylist, renamePlaylist } = usePlaylist();
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const [lastCreated, setLastCreated] = useState(null);
+    const [renamingPlaylistId, setRenamingPlaylistId] = useState(null);
+    const [renameValue, setRenameValue] = useState('');
+    useKeyboardBlocker(renamingPlaylistId !== null);
+    const handleCreate = useCallback(() => {
+        const name = `Playlist ${playlists.length + 1}`;
+        createPlaylist(name);
+        setLastCreated(name);
+        setSelectedIndex(playlists.length);
+    }, [createPlaylist, playlists.length]);
+    const navigateUp = useCallback(() => {
+        setSelectedIndex(prev => Math.max(0, prev - 1));
+    }, []);
+    const navigateDown = useCallback(() => {
+        setSelectedIndex(prev => Math.min(playlists.length === 0 ? 0 : playlists.length - 1, prev + 1));
+    }, [playlists.length]);
+    const startPlaylist = useCallback(() => {
+        if (renamingPlaylistId)
+            return;
+        const playlist = playlists[selectedIndex];
+        if (!playlist || playlist.tracks.length === 0)
+            return;
+        setQueue([...playlist.tracks]);
+        const firstTrack = playlist.tracks[0];
+        if (!firstTrack)
+            return;
+        play(firstTrack);
+    }, [play, playlists, selectedIndex, renamingPlaylistId, setQueue]);
+    const handleRename = useCallback(() => {
+        const playlist = playlists[selectedIndex];
+        if (!playlist)
+            return;
+        setRenamingPlaylistId(playlist.playlistId);
+        setRenameValue(playlist.name);
+    }, [playlists, selectedIndex]);
+    const handleRenameSubmit = useCallback((value) => {
+        if (!renamingPlaylistId)
+            return;
+        const trimmedValue = value.trim() || `Playlist ${selectedIndex + 1}`;
+        renamePlaylist(renamingPlaylistId, trimmedValue);
+        setRenamingPlaylistId(null);
+        setRenameValue('');
+    }, [renamePlaylist, renamingPlaylistId, selectedIndex]);
+    const handleBack = useCallback(() => {
+        if (renamingPlaylistId) {
+            setRenamingPlaylistId(null);
+            setRenameValue('');
+            return;
+        }
+        dispatch({ category: 'GO_BACK' });
+    }, [dispatch, renamingPlaylistId]);
+    useKeyBinding(KEYBINDINGS.UP, navigateUp);
+    useKeyBinding(KEYBINDINGS.DOWN, navigateDown);
+    useKeyBinding(KEYBINDINGS.SELECT, startPlaylist);
+    useKeyBinding(['r'], handleRename);
+    useKeyBinding(KEYBINDINGS.CREATE_PLAYLIST, handleCreate);
+    useKeyBinding(KEYBINDINGS.BACK, handleBack);
+    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] }))] })] }));
 }

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

@@ -6,6 +6,7 @@ import React from 'react';
 import { SEARCH_TYPE } from "../../utils/constants.js";
 import { useTheme } from "../../hooks/useTheme.js";
 import { useKeyBinding } from "../../hooks/useKeyboard.js";
+import { useKeyboardBlocker } from "../../hooks/useKeyboardBlocker.js";
 import { Box, Text } from 'ink';
 import TextInput from 'ink-text-input';
 import { getConfigService } from "../../services/config/config.service.js";
@@ -46,6 +47,7 @@ function SearchBar({ onInput, isActive = true }) {
     }, [isActive, onInput]);
     useKeyBinding(['tab'], cycleType);
     useKeyBinding(['escape'], clearSearch);
+    useKeyboardBlocker(isActive);
     return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: theme.colors.secondary, padding: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: theme.colors.dim, children: "Type: " }), searchTypes.map((type, index) => (_jsxs(Text, { color: navState.searchType === type
                             ? theme.colors.primary
                             : theme.colors.dim, bold: navState.searchType === type, children: [type, index < searchTypes.length - 1 && ' '] }, type))), _jsx(Text, { color: theme.colors.dim, children: " (Tab to switch)" })] }), isActive && (_jsxs(Box, { children: [_jsx(Text, { color: theme.colors.primary, children: "Search: " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: handleSubmit, placeholder: "Type to search...", focus: isActive })] })), !isActive && (_jsxs(Box, { children: [_jsx(Text, { color: theme.colors.primary, children: "Search: " }), _jsx(Text, { color: theme.colors.dim, children: input || 'Type to search...' })] })), _jsx(Text, { color: theme.colors.dim, children: "Type to search, Enter to search, Tab to change type, Esc to clear" })] }));

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

@@ -11,13 +11,15 @@ 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";
 // Generate unique component instance ID
 let instanceCounter = 0;
 function SearchResults({ results, selectedIndex, isActive = true }) {
     const { theme } = useTheme();
     const { dispatch } = useNavigation();
-    const { play } = usePlayer();
+    const { play, dispatch: playerDispatch } = usePlayer();
     const { columns } = useTerminalSize();
+    const musicService = getMusicService();
     // Track component instance and last action time for debouncing
     const instanceIdRef = useRef(++instanceCounter);
     const lastSelectTime = useRef(0);
@@ -45,7 +47,7 @@ function SearchResults({ results, selectedIndex, isActive = true }) {
         }
     }, [selectedIndex, results.length, dispatch, isActive]);
     // Play selected result
-    const playSelected = useCallback(() => {
+    const playSelected = useCallback(async () => {
         logger.debug('SearchResults', 'playSelected called', {
             isActive,
             selectedIndex,
@@ -62,12 +64,43 @@ function SearchResults({ results, selectedIndex, isActive = true }) {
             // Clear queue when playing from search results to ensure indices match
             play(selected.data, { clearQueue: true });
         }
+        else if (selected && selected.type === 'artist') {
+            const artistName = 'name' in selected.data ? selected.data.name : '';
+            if (!artistName) {
+                logger.warn('SearchResults', 'Artist name missing, cannot search songs');
+                return;
+            }
+            try {
+                const response = await musicService.search(artistName, {
+                    type: 'songs',
+                    limit: 20,
+                });
+                const tracks = response.results
+                    .filter(result => result.type === 'song')
+                    .map(result => result.data);
+                if (tracks.length === 0) {
+                    logger.warn('SearchResults', 'No songs found for artist', {
+                        artistName,
+                    });
+                    return;
+                }
+                // Replace queue with artist songs and start playback
+                playerDispatch({ category: 'CLEAR_QUEUE' });
+                playerDispatch({ category: 'SET_QUEUE', queue: tracks });
+                playerDispatch({ category: 'PLAY', track: tracks[0] });
+            }
+            catch (error) {
+                logger.error('SearchResults', 'Failed to play artist songs', {
+                    error,
+                });
+            }
+        }
         else {
-            logger.warn('SearchResults', 'Selected item is not a song', {
+            logger.warn('SearchResults', 'Selected item is not playable', {
                 type: selected?.type,
             });
         }
-    }, [selectedIndex, results, play, isActive]);
+    }, [selectedIndex, results, play, isActive, musicService, playerDispatch]);
     // Play selected result handler (memoized to prevent duplicate registrations)
     const handleSelect = useCallback(() => {
         const now = Date.now();

package/dist/source/hooks/useKeyboard.js

@@ -2,6 +2,7 @@
 import { useCallback, useEffect } from 'react';
 import { useInput } from 'ink';
 import { logger } from "../services/logger/logger.service.js";
+import { useKeyboardBlockContext } from "./useKeyboardBlocker.js";
 // Global registry for key handlers
 const registry = new Set();
 /**
@@ -23,7 +24,13 @@ export function useKeyBinding(keys, handler) {
  * This should be rendered once at the root of the app.
  */
 export function KeyboardManager() {
+    const { blockCount } = useKeyboardBlockContext();
     useInput((input, key) => {
+        if (blockCount > 0) {
+            // When keyboard input is blocked (e.g., within a focused text input),
+            // we deliberately skip executing global shortcuts.
+            return;
+        }
         // Debug logging for key presses (helps diagnose binding issues)
         if (input || key.ctrl || key.meta || key.shift) {
             logger.debug('KeyboardManager', 'Key pressed', {
@@ -74,6 +81,8 @@ export function KeyboardManager() {
                             return false;
                         if (hasShift && !key.shift)
                             return false;
+                        if (!hasShift && key.shift)
+                            return false;
                         // Check the actual key
                         if (mainKey === 'up' && key.upArrow)
                             return true;

package/dist/source/hooks/useKeyboardBlocker.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+type KeyboardBlockContextValue = {
+    blockCount: number;
+    increment: () => void;
+    decrement: () => void;
+};
+export declare function KeyboardBlockProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useKeyboardBlockContext(): KeyboardBlockContextValue;
+export declare function useKeyboardBlocker(shouldBlock: boolean): void;
+export declare function useIsKeyboardBlocked(): boolean;
+export {};

package/dist/source/hooks/useKeyboardBlocker.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+const KeyboardBlockContext = createContext(null);
+export function KeyboardBlockProvider({ children }) {
+    const [blockCount, setBlockCount] = useState(0);
+    const increment = useCallback(() => {
+        setBlockCount(prev => prev + 1);
+    }, []);
+    const decrement = useCallback(() => {
+        setBlockCount(prev => Math.max(0, prev - 1));
+    }, []);
+    const value = useMemo(() => ({ blockCount, increment, decrement }), [blockCount, increment, decrement]);
+    return (_jsx(KeyboardBlockContext.Provider, { value: value, children: children }));
+}
+export function useKeyboardBlockContext() {
+    const context = useContext(KeyboardBlockContext);
+    if (!context) {
+        throw new Error('useKeyboardBlockContext must be used within KeyboardBlockProvider');
+    }
+    return context;
+}
+export function useKeyboardBlocker(shouldBlock) {
+    const { increment, decrement } = useKeyboardBlockContext();
+    const blockedRef = useRef(false);
+    useEffect(() => {
+        if (shouldBlock && !blockedRef.current) {
+            increment();
+            blockedRef.current = true;
+        }
+        else if (!shouldBlock && blockedRef.current) {
+            decrement();
+            blockedRef.current = false;
+        }
+        return () => {
+            if (blockedRef.current) {
+                decrement();
+                blockedRef.current = false;
+            }
+        };
+    }, [shouldBlock, increment, decrement]);
+}
+export function useIsKeyboardBlocked() {
+    const { blockCount } = useKeyboardBlockContext();
+    return blockCount > 0;
+}

package/dist/source/hooks/usePlaylist.d.ts

@@ -4,6 +4,7 @@ export declare function usePlaylist(): {
     playlists: Playlist[];
     createPlaylist: (name: string) => void;
     deletePlaylist: (playlistId: string) => void;
+    renamePlaylist: (playlistId: string, newName: string) => void;
     addTrackToPlaylist: (playlistId: string, track: Track, force?: boolean) => AddTrackResult;
     removeTrackFromPlaylist: (playlistId: string, trackIndex: number) => void;
 };

package/dist/source/hooks/usePlaylist.js

@@ -37,6 +37,13 @@ export function usePlaylist() {
         configService.set('playlists', updatedPlaylists);
         return 'added';
     }, [playlists, configService]);
+    const renamePlaylist = useCallback((playlistId, newName) => {
+        const updatedPlaylists = playlists.map(playlist => playlist.playlistId === playlistId
+            ? { ...playlist, name: newName }
+            : playlist);
+        setPlaylists(updatedPlaylists);
+        configService.set('playlists', updatedPlaylists);
+    }, [playlists, configService]);
     const removeTrackFromPlaylist = useCallback((playlistId, trackIndex) => {
         const playlistIndex = playlists.findIndex(p => p.playlistId === playlistId);
         if (playlistIndex === -1)
@@ -50,6 +57,7 @@ export function usePlaylist() {
         playlists,
         createPlaylist,
         deletePlaylist,
+        renamePlaylist,
         addTrackToPlaylist,
         removeTrackFromPlaylist,
     };

package/dist/source/main.js

@@ -7,6 +7,7 @@ import { ThemeProvider } from "./contexts/theme.context.js";
 import { PlayerProvider } from "./stores/player.store.js";
 import { ErrorBoundary } from "./components/common/ErrorBoundary.js";
 import { KeyboardManager } from "./hooks/useKeyboard.js";
+import { KeyboardBlockProvider } from "./hooks/useKeyboardBlocker.js";
 import { Box, Text } from 'ink';
 import { useEffect } from 'react';
 import { useNavigation } from "./hooks/useNavigation.js";
@@ -65,5 +66,5 @@ function HeadlessLayout({ flags }) {
     return (_jsx(Box, { padding: 1, children: _jsx(Text, { color: "green", children: "Headless mode active." }) }));
 }
 export default function Main({ flags }) {
-    return (_jsx(ErrorBoundary, { children: _jsx(ThemeProvider, { children: _jsx(PlayerProvider, { children: _jsx(NavigationProvider, { children: _jsx(PluginsProvider, { children: _jsxs(Box, { flexDirection: "column", children: [_jsx(KeyboardManager, {}), flags?.headless ? (_jsx(HeadlessLayout, { flags: flags })) : (_jsxs(_Fragment, { children: [_jsx(Initializer, { flags: flags }), _jsx(MainLayout, {})] }))] }) }) }) }) }) }));
+    return (_jsx(ErrorBoundary, { children: _jsx(ThemeProvider, { children: _jsx(PlayerProvider, { children: _jsx(NavigationProvider, { children: _jsx(PluginsProvider, { children: _jsx(KeyboardBlockProvider, { children: _jsxs(Box, { flexDirection: "column", children: [_jsx(KeyboardManager, {}), flags?.headless ? (_jsx(HeadlessLayout, { flags: flags })) : (_jsxs(_Fragment, { children: [_jsx(Initializer, { flags: flags }), _jsx(MainLayout, {})] }))] }) }) }) }) }) }) }));
 }

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

@@ -30,9 +30,10 @@ export declare const KEYBINDINGS: {
     readonly QUIT: readonly ["q", "escape"];
     readonly HELP: readonly ["?"];
     readonly SEARCH: readonly ["/"];
-    readonly PLAYLISTS: readonly ["p"];
+    readonly PLAYLISTS: readonly ["shift+p"];
     readonly SUGGESTIONS: readonly ["g"];
     readonly SETTINGS: readonly [","];
+    readonly PLUGINS: readonly ["p"];
     readonly PLAY_PAUSE: readonly [" "];
     readonly NEXT: readonly ["n", "right"];
     readonly PREVIOUS: readonly ["b", "left"];

package/dist/source/utils/constants.js

@@ -38,9 +38,10 @@ export const KEYBINDINGS = {
     QUIT: ['q', 'escape'],
     HELP: ['?'],
     SEARCH: ['/'],
-    PLAYLISTS: ['p'],
+    PLAYLISTS: ['shift+p'],
     SUGGESTIONS: ['g'],
     SETTINGS: [','],
+    PLUGINS: ['p'],
     // Player
     PLAY_PAUSE: [' '],
     NEXT: ['n', 'right'],

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.5",
+	"version": "0.0.8",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",
@@ -15,7 +15,11 @@
 		"ymc": "dist/source/cli.js"
 	},
 	"files": [
-		"dist"
+		"dist",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE",
+		".github/FUNDING.yml"
 	],
 	"scripts": {
 		"prebuild": "bun run format && bun run lint:fix && bun run typecheck",
@@ -29,27 +33,24 @@
 		"lint": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-pattern dist",
 		"lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix --ignore-pattern dist",
 		"start": "bun run dist/source/cli.js",
-		"test": "prettier --check . && xo && ava",
+		"test": "prettier --check . && bun run lint && ava",
 		"typecheck": "tsc --noEmit",
 		"changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
 		"clean": "rimraf dist",
 		"release": "powershell -File scripts/release.ps1"
 	},
 	"xo": {
-		"extends": "xo-react",
+		"react": true,
 		"prettier": true,
 		"rules": {
 			"react/prop-types": "off"
-		}
+		},
+		"semicolon": true
 	},
 	"prettier": "@vdemedes/prettier-config",
 	"ava": {
-		"extensions": {
-			"ts": "module",
-			"tsx": "module"
-		},
-		"nodeArguments": [
-			"--loader=ts-node/esm"
+		"files": [
+			"tests/**/*.js"
 		]
 	},
 	"dependencies": {
@@ -61,6 +62,7 @@
 		"jiti": "^2.6.1",
 		"meow": "^14.0.0",
 		"node-notifier": "^10.0.1",
+		"discord-rpc": "^4.0.1",
 		"node-youtube-music": "^0.10.3",
 		"play-sound": "^1.1.6",
 		"react": "^19.2.4",

package/dist/test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test.js

@@ -1,13 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { render } from 'ink-testing-library';
-import App from './source/app.js';
-import chalk from 'chalk';
-import test from 'ava';
-test('greet unknown user', t => {
-    const { lastFrame } = render(_jsx(App, { flags: { help: true } }));
-    t.is(lastFrame(), `Hello, ${chalk.green('Stranger')}`);
-});
-test('greet user with a name', t => {
-    const { lastFrame } = render(_jsx(App, { flags: { version: true } }));
-    t.is(lastFrame(), `Hello, ${chalk.green('Jane')}`);
-});