@involvex/youtube-music-cli 0.0.37 → 0.0.39

package/CHANGELOG.md

@@ -1,4 +1,14 @@
-## [0.0.37](https://github.com/involvex/youtube-music-cli/compare/v0.0.36...v0.0.37) (2026-02-22)
+## [0.0.39](https://github.com/involvex/youtube-music-cli/compare/v0.0.38...v0.0.39) (2026-02-23)
+
+### Features
+
+- add visual flash feedback when shortcuts are pressed ([dc3efa8](https://github.com/involvex/youtube-music-cli/commit/dc3efa8f642619ad2e9ce937528e76f4d388e4dc))
+
+## [0.0.38](https://github.com/involvex/youtube-music-cli/compare/v0.0.36...v0.0.38) (2026-02-22)
+
+### Bug Fixes
+
+- **search:** prevent 'q' key from triggering quit when typing in search bar ([32cd888](https://github.com/involvex/youtube-music-cli/commit/32cd888afcabc30d10988491da12c653cb5175d5))
 
 ## [0.0.36](https://github.com/involvex/youtube-music-cli/compare/v0.0.35...v0.0.36) (2026-02-22)
 

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

@@ -1,16 +1,27 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 // Shortcuts bar component
+import { useState } from 'react';
 import { Box, Text } from 'ink';
 import { usePlayer } from "../../hooks/usePlayer.js";
 import { useTheme } from "../../hooks/useTheme.js";
 import { useKeyBinding } from "../../hooks/useKeyboard.js";
 import { KEYBINDINGS } from "../../utils/constants.js";
 import { ICONS } from "../../utils/icons.js";
+const FLASH_DURATION_MS = 300;
 export default function ShortcutsBar() {
     const { theme } = useTheme();
     const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, toggleShuffle, toggleRepeat, } = usePlayer();
+    const [flashState, setFlashState] = useState({});
+    const flash = (key) => {
+        setFlashState(prev => ({ ...prev, [key]: true }));
+        setTimeout(() => {
+            setFlashState(prev => ({ ...prev, [key]: false }));
+        }, FLASH_DURATION_MS);
+    };
+    const shortcutColor = (key) => flashState[key] ? theme.colors.success : theme.colors.text;
     // Register key bindings globally
     const handlePlayPause = () => {
+        flash('playPause');
         if (playerState.isPlaying) {
             pause();
         }
@@ -19,16 +30,51 @@ export default function ShortcutsBar() {
         }
     };
     useKeyBinding(KEYBINDINGS.PLAY_PAUSE, handlePlayPause);
-    useKeyBinding(KEYBINDINGS.NEXT, next);
-    useKeyBinding(KEYBINDINGS.PREVIOUS, previous);
-    useKeyBinding(KEYBINDINGS.VOLUME_UP, volumeUp);
-    useKeyBinding(KEYBINDINGS.VOLUME_DOWN, volumeDown);
-    useKeyBinding(KEYBINDINGS.VOLUME_FINE_UP, volumeFineUp);
-    useKeyBinding(KEYBINDINGS.VOLUME_FINE_DOWN, volumeFineDown);
-    useKeyBinding(KEYBINDINGS.SHUFFLE, toggleShuffle);
-    useKeyBinding(KEYBINDINGS.REPEAT, toggleRepeat);
+    useKeyBinding(KEYBINDINGS.NEXT, () => {
+        flash('next');
+        next();
+    });
+    useKeyBinding(KEYBINDINGS.PREVIOUS, () => {
+        flash('prev');
+        previous();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_UP, () => {
+        flash('volume');
+        volumeUp();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_DOWN, () => {
+        flash('volume');
+        volumeDown();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_FINE_UP, () => {
+        flash('volume');
+        volumeFineUp();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_FINE_DOWN, () => {
+        flash('volume');
+        volumeFineDown();
+    });
+    useKeyBinding(KEYBINDINGS.SHUFFLE, () => {
+        flash('shuffle');
+        toggleShuffle();
+    });
+    useKeyBinding(KEYBINDINGS.REPEAT, () => {
+        flash('repeat');
+        toggleRepeat();
+    });
     // 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: [_jsxs(Text, { color: theme.colors.text, children: [ICONS.PLAY_PAUSE_ON, "/", ICONS.PAUSE, " [Space]"] }), ' ', "| ", _jsxs(Text, { color: theme.colors.text, children: [ICONS.PREV, " [B/\u2190]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.NEXT, " [N/\u2192]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.SHUFFLE, " [Shift+S]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.REPEAT_ALL, " [R]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.PLAYLIST, " [Shift+P]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.DOWNLOAD, " [Shift+D]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.SEARCH, " [/]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.HELP, " [?]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.BG_PLAY, " [Shift+Q]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.RESUME, " [Shift+R]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.QUIT, " [Q]"] })] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: playerState.shuffle ? theme.colors.primary : theme.colors.dim, children: ICONS.SHUFFLE }), ' ', _jsx(Text, { color: playerState.repeat === 'off'
-                            ? theme.colors.dim
-                            : theme.colors.secondary, children: playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
+    const shuffleColor = flashState['shuffle']
+        ? theme.colors.success
+        : playerState.shuffle
+            ? theme.colors.primary
+            : theme.colors.dim;
+    const repeatColor = flashState['repeat']
+        ? theme.colors.success
+        : playerState.repeat !== 'off'
+            ? theme.colors.secondary
+            : theme.colors.dim;
+    const volumeColor = flashState['volume']
+        ? theme.colors.success
+        : theme.colors.primary;
+    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsxs(Text, { color: shortcutColor('playPause'), children: [playerState.isPlaying ? ICONS.PAUSE : ICONS.PLAY_PAUSE_ON, " [Space]"] }), ' ', "| ", _jsxs(Text, { color: shortcutColor('prev'), children: [ICONS.PREV, " [B/\u2190]"] }), " |", ' ', _jsxs(Text, { color: shortcutColor('next'), children: [ICONS.NEXT, " [N/\u2192]"] }), " |", ' ', _jsxs(Text, { color: shuffleColor, children: [ICONS.SHUFFLE, " [Shift+S]"] }), " |", ' ', _jsxs(Text, { color: repeatColor, children: [playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL, ' ', "[R]"] }), ' ', "| ", _jsxs(Text, { color: theme.colors.text, children: [ICONS.PLAYLIST, " [Shift+P]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.DOWNLOAD, " [Shift+D]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.SEARCH, " [/]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.HELP, " [?]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.BG_PLAY, " [Shift+Q]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.RESUME, " [Shift+R]"] }), " |", ' ', _jsxs(Text, { color: theme.colors.text, children: [ICONS.QUIT, " [Q]"] })] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: shuffleColor, children: ICONS.SHUFFLE }), ' ', _jsx(Text, { color: repeatColor, children: playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: volumeColor, children: [playerState.volume, "%"] })] })] }));
 }

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

@@ -124,7 +124,7 @@ function MainLayout() {
         dispatch({ category: 'TOGGLE_PLAYER_MODE' });
     }, [dispatch]);
     // Global keyboard bindings
-    useKeyBinding(KEYBINDINGS.QUIT, handleQuit, { bypassBlock: true });
+    useKeyBinding(KEYBINDINGS.QUIT, handleQuit);
     useKeyBinding(KEYBINDINGS.SEARCH, goToSearch);
     useKeyBinding(KEYBINDINGS.PLAYLISTS, goToPlaylists);
     useKeyBinding(KEYBINDINGS.PLUGINS, goToPlugins);

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

@@ -218,6 +218,7 @@ class PlayerService {
             case 'eof-reached':
                 event.eof = message.data;
                 if (event.eof) {
+                    this.isPlaying = false;
                     logger.info('PlayerService', 'End of file reached');
                 }
                 break;

package/dist/source/services/web/web-server-manager.js

@@ -23,6 +23,7 @@ class WebServerManager {
         shuffle: false,
         isLoading: false,
         error: null,
+        playRequestId: 0,
     };
     constructor() {
         // Load config or use defaults

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

@@ -23,6 +23,7 @@ const initialState = {
     shuffle: false,
     isLoading: false,
     error: null,
+    playRequestId: 0,
 };
 // Get player service instance
 const playerService = getPlayerService();
@@ -35,6 +36,7 @@ export function playerReducer(state, action) {
                 isPlaying: true,
                 progress: 0,
                 error: null,
+                playRequestId: state.playRequestId + 1,
             };
         case 'PAUSE':
             return { ...state, isPlaying: false };
@@ -62,6 +64,7 @@ export function playerReducer(state, action) {
                     currentTrack: state.queue[randomIndex] ?? null,
                     isPlaying: true,
                     progress: 0,
+                    playRequestId: state.playRequestId + 1,
                 };
             }
             // Sequential mode
@@ -74,6 +77,7 @@ export function playerReducer(state, action) {
                         currentTrack: state.queue[0] ?? null,
                         isPlaying: true,
                         progress: 0,
+                        playRequestId: state.playRequestId + 1,
                     };
                 }
                 return state;
@@ -84,6 +88,7 @@ export function playerReducer(state, action) {
                 currentTrack: state.queue[nextPosition] ?? null,
                 isPlaying: true,
                 progress: 0,
+                playRequestId: state.playRequestId + 1,
             };
         }
         case 'PREVIOUS':
@@ -95,6 +100,7 @@ export function playerReducer(state, action) {
                 return {
                     ...state,
                     progress: 0,
+                    playRequestId: state.playRequestId + 1,
                 };
             }
             return {
@@ -102,6 +108,7 @@ export function playerReducer(state, action) {
                 queuePosition: prevPosition,
                 currentTrack: state.queue[prevPosition] ?? null,
                 progress: 0,
+                playRequestId: state.playRequestId + 1,
             };
         case 'SEEK':
             return {
@@ -174,6 +181,7 @@ export function playerReducer(state, action) {
                     queuePosition: action.position,
                     currentTrack: state.queue[action.position] ?? null,
                     progress: 0,
+                    playRequestId: state.playRequestId + 1,
                 };
             }
             return state;
@@ -207,6 +215,7 @@ export function playerReducer(state, action) {
                 hasTrack: !!action.currentTrack,
                 queueLength: action.queue.length,
             });
+            playerService.setVolume(action.volume);
             return {
                 ...state,
                 currentTrack: action.currentTrack,
@@ -292,6 +301,7 @@ function PlayerManager() {
         };
     }, [dispatch, playerService]);
     // Handle track changes
+    const lastPlayedRequestId = useRef(-1);
     useEffect(() => {
         const track = state.currentTrack;
         if (!track) {
@@ -306,14 +316,17 @@ function PlayerManager() {
             });
             return;
         }
-        // Guard: Only play if track actually changed
+        // Guard: Don't replay same track unless a new play request was explicitly dispatched
         const currentTrackId = playerService.getCurrentTrackId?.() || '';
-        if (currentTrackId === track.videoId) {
+        const isSameTrack = currentTrackId === track.videoId;
+        const isNewPlayRequest = state.playRequestId !== lastPlayedRequestId.current;
+        if (isSameTrack && !isNewPlayRequest) {
             logger.debug('PlayerManager', 'Track already playing, skipping', {
                 videoId: track.videoId,
             });
             return;
         }
+        lastPlayedRequestId.current = state.playRequestId;
         logger.info('PlayerManager', 'Loading track', {
             title: track.title,
             videoId: track.videoId,
@@ -424,7 +437,13 @@ function PlayerManager() {
         void loadAndPlayTrack();
         // Note: state.volume intentionally excluded - volume changes should not restart playback
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [state.currentTrack, state.isPlaying, dispatch, musicService]);
+    }, [
+        state.currentTrack,
+        state.isPlaying,
+        state.playRequestId,
+        dispatch,
+        musicService,
+    ]);
     // Handle progress tracking
     useEffect(() => {
         if (state.isPlaying && state.currentTrack) {

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

@@ -13,5 +13,6 @@ export interface PlayerState {
     shuffle: boolean;
     isLoading: boolean;
     error: string | null;
+    playRequestId: number;
 }
 export type PlayerAction = PlayAction | PauseAction | ResumeAction | StopAction | NextAction | PreviousAction | SeekAction | SetVolumeAction | VolumeUpAction | VolumeDownAction | VolumeFineUpAction | VolumeFineDownAction | ToggleShuffleAction | ToggleRepeatAction | SetQueueAction | AddToQueueAction | RemoveFromQueueAction | ClearQueueAction | SetQueuePositionAction | UpdateProgressAction | SetDurationAction | TickAction | SetLoadingAction | SetErrorAction | RestoreStateAction | SetSpeedAction;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.37",
+	"version": "0.0.39",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",