@involvex/youtube-music-cli 0.0.45 → 0.0.47

package/dist/package.json

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

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

@@ -10,7 +10,7 @@ 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 { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, toggleShuffle, toggleRepeat, toggleAutoplay, } = usePlayer();
     const [flashState, setFlashState] = useState({});
     const flash = (key) => {
         setFlashState(prev => ({ ...prev, [key]: true }));
@@ -62,6 +62,10 @@ export default function ShortcutsBar() {
         flash('repeat');
         toggleRepeat();
     });
+    useKeyBinding(KEYBINDINGS.AUTOPLAY_TOGGLE, () => {
+        flash('autoplay');
+        toggleAutoplay();
+    });
     // Note: SETTINGS keybinding handled by MainLayout to avoid double-dispatch
     const shuffleColor = flashState['shuffle']
         ? theme.colors.success
@@ -76,5 +80,10 @@ export default function ShortcutsBar() {
     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, "%"] })] })] }));
+    const autoplayColor = flashState['autoplay']
+        ? theme.colors.success
+        : playerState.autoplay
+            ? theme.colors.primary
+            : theme.colors.dim;
+    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: autoplayColor, children: [ICONS.AUTOPLAY, " [Shift+A]"] }), " |", ' ', _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 }), ' ', _jsx(Text, { color: autoplayColor, children: ICONS.AUTOPLAY }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: volumeColor, children: [playerState.volume, "%"] })] })] }));
 }

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

@@ -17,6 +17,7 @@ export declare function usePlayer(): {
     volumeFineDown: () => void;
     toggleShuffle: () => void;
     toggleRepeat: () => void;
+    toggleAutoplay: () => void;
     setQueue: (queue: Track[]) => void;
     addToQueue: (track: Track) => void;
     removeFromQueue: (index: number) => void;

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

@@ -8,6 +8,7 @@ export interface PersistedPlayerState {
     volume: number;
     shuffle: boolean;
     repeat: 'off' | 'all' | 'one';
+    autoplay?: boolean;
     lastUpdated: string;
 }
 /**

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

@@ -15,6 +15,7 @@ const defaultState = {
     volume: 70,
     shuffle: false,
     repeat: 'off',
+    autoplay: true,
     lastUpdated: new Date().toISOString(),
 };
 /**

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

@@ -21,6 +21,7 @@ class WebServerManager {
         queuePosition: 0,
         repeat: 'off',
         shuffle: false,
+        autoplay: true,
         isLoading: false,
         error: null,
         playRequestId: 0,

package/dist/source/services/web/web-streaming.service.js

@@ -164,6 +164,7 @@ class WebStreamingService {
             'queuePosition',
             'repeat',
             'shuffle',
+            'autoplay',
             'isLoading',
             'error',
         ];
@@ -186,9 +187,10 @@ class WebStreamingService {
      * Update and broadcast player state (throttled)
      */
     onStateChange(state) {
-        this.prevState = { ...state };
         const now = Date.now();
+        // Compute delta against OLD prevState BEFORE updating it
         const delta = this.computeDelta(state);
+        this.prevState = { ...state };
         // Skip if no changes
         if (Object.keys(delta).length === 0) {
             return;

package/dist/source/stores/player.store.d.ts

@@ -18,6 +18,7 @@ type PlayerContextValue = {
     volumeFineDown: () => void;
     toggleShuffle: () => void;
     toggleRepeat: () => void;
+    toggleAutoplay: () => void;
     setQueue: (queue: Track[]) => void;
     addToQueue: (track: Track) => void;
     removeFromQueue: (index: number) => void;

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

@@ -21,6 +21,7 @@ const initialState = {
     queuePosition: 0,
     repeat: 'off',
     shuffle: false,
+    autoplay: true,
     isLoading: false,
     error: null,
     playRequestId: 0,
@@ -150,6 +151,8 @@ export function playerReducer(state, action) {
         }
         case 'TOGGLE_SHUFFLE':
             return { ...state, shuffle: !state.shuffle };
+        case 'TOGGLE_AUTOPLAY':
+            return { ...state, autoplay: !state.autoplay };
         case 'TOGGLE_REPEAT':
             const repeatModes = ['off', 'all', 'one'];
             const currentIndex = repeatModes.indexOf(state.repeat);
@@ -225,6 +228,7 @@ export function playerReducer(state, action) {
                 volume: action.volume,
                 shuffle: action.shuffle,
                 repeat: action.repeat,
+                autoplay: action.autoplay ?? true,
                 isPlaying: false, // Don't auto-play restored state
             };
         default:
@@ -251,6 +255,7 @@ function PlayerManager() {
     }, [dispatch]);
     // Register event handler for mpv IPC events
     const eofTimestampRef = useRef(0);
+    const lastAutoNextRef = useRef(0);
     useEffect(() => {
         let lastProgressUpdate = 0;
         const PROGRESS_THROTTLE_MS = 1000; // Update progress max once per second
@@ -269,8 +274,10 @@ function PlayerManager() {
             if (event.eof) {
                 // Track ended — record timestamp so we can suppress mpv's spurious
                 // pause event that immediately follows EOF (idle state).
-                eofTimestampRef.current = Date.now();
+                const now = Date.now();
+                eofTimestampRef.current = now;
                 next();
+                lastAutoNextRef.current = now;
             }
             if (event.paused !== undefined) {
                 // mpv sends pause=true when a track ends and it enters idle mode.
@@ -505,14 +512,101 @@ function PlayerManager() {
         config.set('volume', state.volume);
     }, [state.volume]);
     // Handle track completion
+    const autoAdvanceRef = useRef(false);
     useEffect(() => {
-        if (state.duration > 0 && state.progress >= state.duration) {
-            if (state.repeat === 'one') {
-                dispatch({ category: 'SEEK', position: 0 });
-            }
-            // next() for regular track completion is handled by the eof IPC event
+        if (state.duration <= 0) {
+            autoAdvanceRef.current = false;
+            return;
+        }
+        if (state.progress < state.duration) {
+            autoAdvanceRef.current = false;
+            return;
+        }
+        if (state.repeat === 'one') {
+            dispatch({ category: 'SEEK', position: 0 });
+            return;
+        }
+        const hasNextTrack = state.queue.length > 0 &&
+            (state.repeat === 'all' ||
+                state.queuePosition < state.queue.length - 1 ||
+                (state.shuffle && state.queue.length > 1));
+        if (!hasNextTrack) {
+            return;
+        }
+        const now = Date.now();
+        if (now - lastAutoNextRef.current < 1500) {
+            return;
+        }
+        if (!autoAdvanceRef.current) {
+            autoAdvanceRef.current = true;
+            lastAutoNextRef.current = now;
+            dispatch({ category: 'NEXT' });
+        }
+    }, [
+        state.duration,
+        state.progress,
+        state.repeat,
+        state.queue.length,
+        state.queuePosition,
+        state.shuffle,
+        dispatch,
+    ]);
+    // Smart autoplay: fetch suggestions when near end of queue
+    const fetchedForRef = useRef(null);
+    const isFetchingAutoplayRef = useRef(false);
+    useEffect(() => {
+        if (!state.autoplay || !state.currentTrack || !state.isPlaying) {
+            return;
+        }
+        // Already looping — no need to feed the queue
+        if (state.repeat === 'all' || (state.shuffle && state.queue.length > 1)) {
+            return;
+        }
+        // Still enough tracks ahead — wait until we're close to the end
+        const tracksAhead = state.queue.length - state.queuePosition - 1;
+        if (tracksAhead > 5)
+            return;
+        // Already fetched for this track or a fetch is in flight
+        if (fetchedForRef.current === state.currentTrack.videoId ||
+            isFetchingAutoplayRef.current) {
+            return;
         }
-    }, [state.progress, state.duration, state.repeat, dispatch]);
+        const trackId = state.currentTrack.videoId;
+        const trackTitle = state.currentTrack.title;
+        isFetchingAutoplayRef.current = true;
+        fetchedForRef.current = trackId;
+        musicService
+            .getSuggestions(trackId)
+            .then(suggestions => {
+            for (const track of suggestions) {
+                dispatch({ category: 'ADD_TO_QUEUE', track });
+            }
+            logger.info('PlayerManager', 'Autoplay: added suggestions', {
+                count: suggestions.length,
+                basedOn: trackTitle,
+            });
+        })
+            .catch((error) => {
+            isFetchingAutoplayRef.current = false;
+            fetchedForRef.current = null; // Allow retry on next track change
+            logger.warn('PlayerManager', 'Autoplay: failed to fetch suggestions', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        })
+            .finally(() => {
+            isFetchingAutoplayRef.current = false;
+        });
+    }, [
+        state.autoplay,
+        state.currentTrack,
+        state.isPlaying,
+        state.repeat,
+        state.shuffle,
+        state.queue.length,
+        state.queuePosition,
+        musicService,
+        dispatch,
+    ]);
     return null;
 }
 export function PlayerProvider({ children }) {
@@ -540,6 +634,7 @@ export function PlayerProvider({ children }) {
                     volume: persistedState.volume,
                     shuffle: persistedState.shuffle,
                     repeat: persistedState.repeat,
+                    autoplay: persistedState.autoplay ?? true,
                 });
             }
         });
@@ -562,6 +657,7 @@ export function PlayerProvider({ children }) {
                 volume: state.volume,
                 shuffle: state.shuffle,
                 repeat: state.repeat,
+                autoplay: state.autoplay,
             });
         }, 
         // Debounce progress updates (5s), immediate for track/queue changes
@@ -579,6 +675,7 @@ export function PlayerProvider({ children }) {
         state.volume,
         state.shuffle,
         state.repeat,
+        state.autoplay,
     ]);
     // Save immediately on unmount/quit
     useEffect(() => {
@@ -593,6 +690,7 @@ export function PlayerProvider({ children }) {
                 volume: currentState.volume,
                 shuffle: currentState.shuffle,
                 repeat: currentState.repeat,
+                autoplay: currentState.autoplay,
             });
         };
         process.on('beforeExit', handleExit);
@@ -661,6 +759,7 @@ export function PlayerProvider({ children }) {
         },
         toggleShuffle: () => dispatch({ category: 'TOGGLE_SHUFFLE' }),
         toggleRepeat: () => dispatch({ category: 'TOGGLE_REPEAT' }),
+        toggleAutoplay: () => dispatch({ category: 'TOGGLE_AUTOPLAY' }),
         setQueue: (queue) => dispatch({ category: 'SET_QUEUE', queue }),
         addToQueue: (track) => dispatch({ category: 'ADD_TO_QUEUE', track }),
         removeFromQueue: (index) => dispatch({ category: 'REMOVE_FROM_QUEUE', index }),

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

@@ -44,6 +44,9 @@ export interface ToggleShuffleAction {
 export interface ToggleRepeatAction {
     readonly category: 'TOGGLE_REPEAT';
 }
+export interface ToggleAutoplayAction {
+    readonly category: 'TOGGLE_AUTOPLAY';
+}
 export interface SetQueueAction {
     readonly category: 'SET_QUEUE';
     queue: Track[];
@@ -91,6 +94,7 @@ export interface RestoreStateAction {
     volume: number;
     shuffle: boolean;
     repeat: 'off' | 'all' | 'one';
+    autoplay?: boolean;
 }
 export interface SetSpeedAction {
     readonly category: 'SET_SPEED';

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

@@ -1,4 +1,4 @@
-import type { 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 } from './actions.ts';
+import type { PlayAction, PauseAction, ResumeAction, StopAction, NextAction, PreviousAction, SeekAction, SetVolumeAction, VolumeUpAction, VolumeDownAction, VolumeFineUpAction, VolumeFineDownAction, ToggleShuffleAction, ToggleRepeatAction, ToggleAutoplayAction, SetQueueAction, AddToQueueAction, RemoveFromQueueAction, ClearQueueAction, SetQueuePositionAction, UpdateProgressAction, SetDurationAction, TickAction, SetLoadingAction, SetErrorAction, RestoreStateAction, SetSpeedAction } from './actions.ts';
 import type { Track } from './youtube-music.types.ts';
 export interface PlayerState {
     currentTrack: Track | null;
@@ -11,8 +11,9 @@ export interface PlayerState {
     queuePosition: number;
     repeat: 'off' | 'all' | 'one';
     shuffle: boolean;
+    autoplay: 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;
+export type PlayerAction = PlayAction | PauseAction | ResumeAction | StopAction | NextAction | PreviousAction | SeekAction | SetVolumeAction | VolumeUpAction | VolumeDownAction | VolumeFineUpAction | VolumeFineDownAction | ToggleShuffleAction | ToggleRepeatAction | ToggleAutoplayAction | SetQueueAction | AddToQueueAction | RemoveFromQueueAction | ClearQueueAction | SetQueuePositionAction | UpdateProgressAction | SetDurationAction | TickAction | SetLoadingAction | SetErrorAction | RestoreStateAction | SetSpeedAction;

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

@@ -49,6 +49,7 @@ export declare const KEYBINDINGS: {
     readonly VOLUME_FINE_DOWN: readonly ["shift+-"];
     readonly SHUFFLE: readonly ["shift+s"];
     readonly REPEAT: readonly ["r"];
+    readonly AUTOPLAY_TOGGLE: readonly ["shift+a"];
     readonly GAPLESS_TOGGLE: readonly ["shift+g"];
     readonly CROSSFADE_CYCLE: readonly ["shift+c"];
     readonly EQUALIZER_CYCLE: readonly ["shift+e"];

package/dist/source/utils/constants.js

@@ -85,6 +85,7 @@ export const KEYBINDINGS = {
     VOLUME_FINE_DOWN: ['shift+-'], // Fine-grained -1 step
     SHUFFLE: ['shift+s'],
     REPEAT: ['r'],
+    AUTOPLAY_TOGGLE: ['shift+a'],
     GAPLESS_TOGGLE: ['shift+g'],
     CROSSFADE_CYCLE: ['shift+c'],
     EQUALIZER_CYCLE: ['shift+e'],

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

@@ -16,4 +16,5 @@ export declare const ICONS: {
     readonly RESUME: "⟳";
     readonly BG_PLAY: "○";
     readonly VOLUME: "♪";
+    readonly AUTOPLAY: "∞";
 };

package/dist/source/utils/icons.js

@@ -23,4 +23,6 @@ export const ICONS = {
     BG_PLAY: '○', // U+25CB
     // Status
     VOLUME: '♪', // U+266A
+    // Autoplay / radio
+    AUTOPLAY: '∞', // U+221E
 };

package/package.json

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

package/readme.md

@@ -27,6 +27,7 @@ A powerful Terminal User Interface (TUI) music player for YouTube Music
 - 🖥️ **Headless Mode** - Run without TUI for scripting
 - 💾 **Downloads** - Save tracks/playlists/artists with `Shift+D`
 - 🏷️ **Metadata Tagging** - Auto-tag title/artist/album with optional cover art
+- ⚡️ **Shell Completions** - `ymc completions <bash|zsh|powershell|fish>` emits scripts you can source or save so the CLI (also available as `ymc`) tab-completes subcommands and flags
 
 ## Roadmap
 
@@ -161,6 +162,28 @@ youtube-music-cli skip
 youtube-music-cli back
 ```
 
+### Shell completions
+
+Generate shell completion helpers through the lightweight `ymc` alias that ships with the CLI. Run `ymc completions <bash|zsh|powershell|fish>` to print the completion script for your shell, then source it or persist it in your profile:
+
+```bash
+# Bash
+source <(ymc completions bash)
+ymc completions bash >> ~/.bash_completion
+
+# Zsh
+source <(ymc completions zsh)
+
+# PowerShell
+ymc completions powershell | Out-File -Encoding utf8 $PROFILE
+Invoke-Expression (ymc completions powershell)
+
+# Fish
+ymc completions fish > ~/.config/fish/completions/ymc.fish
+```
+
+If you installed the CLI globally with an alias or script name, make sure `ymc` points at the same binary before generating completions so that the script matches your install path.
+
 ### Options
 
 | Flag         | Short | Description                                  |