@involvex/youtube-music-cli 0.0.30 → 0.0.31

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.0.31](https://github.com/involvex/youtube-music-cli/compare/v0.0.30...v0.0.31) (2026-02-22)
+
+### Bug Fixes
+
+- improve mpv process management and fix EOF/pause race condition ([b5e9786](https://github.com/involvex/youtube-music-cli/commit/b5e9786d99bdc0dc81cd32bef65ac5467c032231))
+
 ## [0.0.30](https://github.com/involvex/youtube-music-cli/compare/v0.0.29...v0.0.30) (2026-02-22)
 
 ## [0.0.29](https://github.com/involvex/youtube-music-cli/compare/v0.0.28...v0.0.29) (2026-02-22)

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

@@ -65,7 +65,10 @@ declare class PlayerService {
     /**
      * Reattach to an existing mpv process via IPC
      */
-    reattach(ipcPath: string): Promise<void>;
+    reattach(ipcPath: string, options?: {
+        trackId?: string;
+        currentUrl?: string;
+    }): Promise<void>;
     setVolume(volume: number): void;
     getVolume(): number;
     setSpeed(speed: number): void;

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

@@ -378,6 +378,10 @@ class PlayerService {
             currentUrl: this.currentUrl,
         };
         if (this.mpvProcess) {
+            // Close piped stdio handles so Node has no open references that could
+            // prevent clean exit or send SIGHUP to the detached mpv process.
+            this.mpvProcess.stdout?.destroy();
+            this.mpvProcess.stderr?.destroy();
             // Allow detached mpv process to survive after CLI exits.
             this.mpvProcess.unref();
         }
@@ -391,11 +395,15 @@ class PlayerService {
     /**
      * Reattach to an existing mpv process via IPC
      */
-    async reattach(ipcPath) {
+    async reattach(ipcPath, options) {
         logger.info('PlayerService', 'Reattaching to player', { ipcPath });
         this.ipcPath = ipcPath;
         await this.connectIpc();
         this.isPlaying = true;
+        if (options?.trackId)
+            this.currentTrackId = options.trackId;
+        if (options?.currentUrl)
+            this.currentUrl = options.currentUrl;
         logger.info('PlayerService', 'Successfully reattached to player');
     }
     setVolume(volume) {

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

@@ -241,6 +241,7 @@ function PlayerManager() {
         });
     }, [dispatch]);
     // Register event handler for mpv IPC events
+    const eofTimestampRef = useRef(0);
     useEffect(() => {
         let lastProgressUpdate = 0;
         const PROGRESS_THROTTLE_MS = 1000; // Update progress max once per second
@@ -256,7 +257,19 @@ function PlayerManager() {
                     lastProgressUpdate = now;
                 }
             }
+            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();
+                next();
+            }
             if (event.paused !== undefined) {
+                // mpv sends pause=true when a track ends and it enters idle mode.
+                // Suppress this for ~2s after EOF to prevent it from overwriting
+                // the isPlaying:true set by NEXT, which would block autoplay.
+                if (event.paused && Date.now() - eofTimestampRef.current < 2000) {
+                    return;
+                }
                 if (event.paused) {
                     dispatch({ category: 'PAUSE' });
                 }
@@ -264,10 +277,6 @@ function PlayerManager() {
                     dispatch({ category: 'RESUME' });
                 }
             }
-            if (event.eof) {
-                // Track ended, play next
-                next();
-            }
         });
     }, [playerService, dispatch, next]);
     // Initialize audio on mount
@@ -310,6 +319,32 @@ function PlayerManager() {
             videoId: track.videoId,
         });
         const loadAndPlayTrack = async () => {
+            // If a detached background session exists for this exact track, reattach
+            // to the still-running mpv process instead of spawning a new one.
+            const config = getConfigService();
+            const bgState = config.getBackgroundPlaybackState();
+            const trackUrl = `https://www.youtube.com/watch?v=${track.videoId}`;
+            if (bgState.enabled &&
+                bgState.ipcPath &&
+                bgState.currentUrl === trackUrl) {
+                try {
+                    await playerService.reattach(bgState.ipcPath, {
+                        trackId: track.videoId,
+                        currentUrl: trackUrl,
+                    });
+                    config.clearBackgroundPlaybackState();
+                    dispatch({ category: 'SET_LOADING', loading: false });
+                    logger.info('PlayerManager', 'Reattached to background mpv session');
+                    return;
+                }
+                catch (error) {
+                    logger.warn('PlayerManager', 'Failed to reattach background session, starting fresh', {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    config.clearBackgroundPlaybackState();
+                    // Fall through to normal play()
+                }
+            }
             dispatch({ category: 'SET_LOADING', loading: true });
             const MAX_RETRIES = 3;
             const RETRY_DELAY_MS = 1500;
@@ -452,11 +487,9 @@ function PlayerManager() {
             if (state.repeat === 'one') {
                 dispatch({ category: 'SEEK', position: 0 });
             }
-            else {
-                next();
-            }
+            // next() for regular track completion is handled by the eof IPC event
         }
-    }, [state.progress, state.duration, state.repeat, next, dispatch]);
+    }, [state.progress, state.duration, state.repeat, dispatch]);
     return null;
 }
 export function PlayerProvider({ children }) {

package/package.json

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