@involvex/youtube-music-cli 0.0.29 → 0.0.31

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [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)
 
 ### Bug Fixes

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

@@ -1,10 +1,11 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 // Shortcuts bar component
 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";
 export default function ShortcutsBar() {
     const { theme } = useTheme();
     const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, toggleShuffle, toggleRepeat, } = usePlayer();
@@ -27,7 +28,7 @@ export default function ShortcutsBar() {
     useKeyBinding(KEYBINDINGS.SHUFFLE, toggleShuffle);
     useKeyBinding(KEYBINDINGS.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: [_jsx(Text, { color: theme.colors.text, children: "\u23EF [Space]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u23EE [B/\u2190]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u23ED [N/\u2192]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD00 [Shift+S]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD01 [R]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDCDA [Shift+P]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2B07 [Shift+D]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD0E [/]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2753 [?]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDEF0 [Shift+Q]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD0C [Shift+R]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u23FB [Q]" })] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: playerState.shuffle ? theme.colors.primary : theme.colors.dim, children: "\uD83D\uDD00" }), ' ', _jsx(Text, { color: playerState.repeat === 'off'
+    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' ? '🔂' : '🔄' }), ' ', _jsx(Text, { color: theme.colors.dim, children: "\uD83D\uDD0A [=/-]" }), ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
+                            : 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, "%"] })] })] }));
 }

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

@@ -4,6 +4,7 @@ import { Box, Text } from 'ink';
 import { usePlayer } from "../../hooks/usePlayer.js";
 import { useTheme } from "../../hooks/useTheme.js";
 import { formatTime } from "../../utils/format.js";
+import { ICONS } from "../../utils/icons.js";
 export default function MiniPlayerLayout() {
     const { theme } = useTheme();
     const { state } = usePlayer();
@@ -12,7 +13,7 @@ export default function MiniPlayerLayout() {
     const title = track?.title ?? 'No track playing';
     const progress = formatTime(state.progress);
     const duration = formatTime(state.duration);
-    const playIcon = state.isPlaying ? '▶' : '⏸';
+    const playIcon = state.isPlaying ? ICONS.PLAY : ICONS.PAUSE;
     const vol = `${state.volume}%`;
     const speed = (state.speed ?? 1.0) !== 1.0 ? ` ${(state.speed ?? 1.0).toFixed(2)}x` : '';
     return (_jsxs(Box, { flexDirection: "row", paddingX: 1, gap: 1, children: [_jsx(Text, { color: state.isPlaying ? theme.colors.success : theme.colors.dim, children: playIcon }), _jsx(Text, { bold: true, color: theme.colors.primary, children: title }), _jsx(Text, { color: theme.colors.dim, children: "\u2014" }), _jsx(Text, { color: theme.colors.secondary, children: artist }), _jsx(Text, { color: theme.colors.dim, children: "|" }), _jsxs(Text, { color: theme.colors.text, children: [progress, "/", duration] }), _jsx(Text, { color: theme.colors.dim, children: "|" }), _jsxs(Text, { color: theme.colors.text, children: ["vol:", vol] }), speed && _jsx(Text, { color: theme.colors.accent, children: speed }), state.isLoading && _jsx(Text, { color: theme.colors.accent, children: "Loading..." })] }));

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

@@ -11,6 +11,7 @@ import { useKeyBinding } from "../../hooks/useKeyboard.js";
 import { KEYBINDINGS, VIEW } from "../../utils/constants.js";
 import { Box, Text } from 'ink';
 import { usePlayer } from "../../hooks/usePlayer.js";
+import { ICONS } from "../../utils/icons.js";
 function SearchLayout() {
     const { theme } = useTheme();
     const { state: navState, dispatch } = useNavigation();
@@ -118,7 +119,7 @@ function SearchLayout() {
             lastAutoSearchedQueryRef.current = null;
         };
     }, [dispatch]);
-    return (_jsxs(Box, { flexDirection: "column", children: [playerState.currentTrack && (_jsxs(Box, { children: [_jsx(Text, { color: theme.colors.dim, children: playerState.isPlaying ? '▶ ' : '⏸ ' }), _jsx(Text, { color: theme.colors.primary, bold: true, children: playerState.currentTrack.title }), playerState.currentTrack.artists &&
+    return (_jsxs(Box, { flexDirection: "column", children: [playerState.currentTrack && (_jsxs(Box, { children: [_jsx(Text, { color: theme.colors.dim, children: playerState.isPlaying ? `${ICONS.PLAY} ` : `${ICONS.PAUSE} ` }), _jsx(Text, { color: theme.colors.primary, bold: true, children: playerState.currentTrack.title }), playerState.currentTrack.artists &&
                         playerState.currentTrack.artists.length > 0 && (_jsxs(Text, { color: theme.colors.secondary, children: [' • ', playerState.currentTrack.artists.map(a => a.name).join(', ')] }))] })), _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, 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

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

@@ -7,6 +7,7 @@ import { formatTime } from "../../utils/format.js";
 import { useTerminalSize } from "../../hooks/useTerminalSize.js";
 import { getSleepTimerService } from "../../services/sleep-timer/sleep-timer.service.js";
 import { useState, useEffect } from 'react';
+import { ICONS } from "../../utils/icons.js";
 export default function NowPlaying() {
     const { theme } = useTheme();
     const { state: playerState } = usePlayer();
@@ -40,5 +41,5 @@ export default function NowPlaying() {
     const percentage = duration > 0 ? Math.min(100, Math.floor((progress / duration) * 100)) : 0;
     const barWidth = Math.max(10, columns - 8);
     const filledWidth = duration > 0 ? Math.floor((progress / duration) * barWidth) : 0;
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.colors.primary, paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: theme.colors.primary, children: track.title }), _jsx(Text, { color: theme.colors.dim, children: " \u2022 " }), _jsx(Text, { color: theme.colors.secondary, children: artists })] }), track.album && _jsx(Text, { color: theme.colors.dim, children: track.album.name }), _jsxs(Box, { children: [_jsx(Text, { color: theme.colors.primary, children: '█'.repeat(Math.min(filledWidth, barWidth)) }), _jsx(Text, { color: theme.colors.dim, children: '░'.repeat(Math.max(0, barWidth - filledWidth)) })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.colors.text, children: formatTime(progress) }), _jsxs(Text, { color: theme.colors.dim, children: [" / ", formatTime(duration), " "] }), _jsxs(Text, { color: theme.colors.dim, children: ["[", percentage, "%]"] }), playerState.isLoading && (_jsx(Text, { color: theme.colors.accent, children: " Loading..." })), !playerState.isPlaying && progress > 0 && (_jsx(Text, { color: theme.colors.dim, children: " \u23F8" })), playerState.shuffle && _jsx(Text, { color: theme.colors.primary, children: " \uD83D\uDD00" }), sleepRemaining !== null && (_jsxs(Text, { color: theme.colors.warning, children: [' ', "\u23FE ", formatTime(sleepRemaining)] }))] }), playerState.error && (_jsx(Text, { color: theme.colors.error, children: playerState.error }))] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.colors.primary, paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: theme.colors.primary, children: track.title }), _jsx(Text, { color: theme.colors.dim, children: " \u2022 " }), _jsx(Text, { color: theme.colors.secondary, children: artists })] }), track.album && _jsx(Text, { color: theme.colors.dim, children: track.album.name }), _jsxs(Box, { children: [_jsx(Text, { color: theme.colors.primary, children: '█'.repeat(Math.min(filledWidth, barWidth)) }), _jsx(Text, { color: theme.colors.dim, children: '░'.repeat(Math.max(0, barWidth - filledWidth)) })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.colors.text, children: formatTime(progress) }), _jsxs(Text, { color: theme.colors.dim, children: [" / ", formatTime(duration), " "] }), _jsxs(Text, { color: theme.colors.dim, children: ["[", percentage, "%]"] }), playerState.isLoading && (_jsx(Text, { color: theme.colors.accent, children: " Loading..." })), !playerState.isPlaying && progress > 0 && (_jsxs(Text, { color: theme.colors.dim, children: [" ", ICONS.PAUSE] })), playerState.shuffle && (_jsxs(Text, { color: theme.colors.primary, children: [" ", ICONS.SHUFFLE] })), sleepRemaining !== null && (_jsxs(Text, { color: theme.colors.warning, children: [' ', "\u23FE ", formatTime(sleepRemaining)] }))] }), playerState.error && (_jsx(Text, { color: theme.colors.error, children: playerState.error }))] }));
 }

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

@@ -7,6 +7,7 @@ import { useTheme } from "../../hooks/useTheme.js";
 import { Box, Text } from 'ink';
 import { useEffect } from 'react';
 import { logger } from "../../services/logger/logger.service.js";
+import { ICONS } from "../../utils/icons.js";
 let mountCount = 0;
 export default function PlayerControls() {
     const instanceId = ++mountCount;
@@ -40,5 +41,5 @@ export default function PlayerControls() {
     useKeyBinding(KEYBINDINGS.SPEED_UP, speedUp);
     useKeyBinding(KEYBINDINGS.SPEED_DOWN, speedDown);
     useKeyBinding(KEYBINDINGS.SHUFFLE, toggleShuffle);
-    return (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", paddingX: 2, borderStyle: "classic", borderColor: theme.colors.dim, children: [_jsxs(Text, { color: theme.colors.text, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "\u2190 / b" }), "] Prev"] }), _jsx(Text, { color: theme.colors.primary, children: playerState.isPlaying ? (_jsxs(Text, { children: ["[", _jsx(Text, { color: theme.colors.dim, children: "Space" }), "] Pause"] })) : (_jsxs(Text, { children: ["[", _jsx(Text, { color: theme.colors.dim, children: "Space" }), "] Play"] })) }), _jsxs(Text, { color: theme.colors.text, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "\u2192 / n" }), "] Next"] }), _jsxs(Text, { color: theme.colors.text, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "+/-" }), "] Vol: ", playerState.volume, "%"] }), _jsxs(Text, { color: playerState.shuffle ? theme.colors.primary : theme.colors.dim, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "Shift+S" }), "]", ' ', playerState.shuffle ? '🔀 ON' : '🔀 OFF'] }), (playerState.speed ?? 1.0) !== 1.0 && (_jsxs(Text, { color: theme.colors.accent, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "<>" }), "]", ' ', (playerState.speed ?? 1.0).toFixed(2), "x"] }))] }));
+    return (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", paddingX: 2, borderStyle: "classic", borderColor: theme.colors.dim, children: [_jsxs(Text, { color: theme.colors.text, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "\u2190 / b" }), "] Prev"] }), _jsx(Text, { color: theme.colors.primary, children: playerState.isPlaying ? (_jsxs(Text, { children: ["[", _jsx(Text, { color: theme.colors.dim, children: "Space" }), "] Pause"] })) : (_jsxs(Text, { children: ["[", _jsx(Text, { color: theme.colors.dim, children: "Space" }), "] Play"] })) }), _jsxs(Text, { color: theme.colors.text, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "\u2192 / n" }), "] Next"] }), _jsxs(Text, { color: theme.colors.text, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "+/-" }), "] Vol: ", playerState.volume, "%"] }), _jsxs(Text, { color: playerState.shuffle ? theme.colors.primary : theme.colors.dim, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "Shift+S" }), "]", ' ', playerState.shuffle ? `${ICONS.SHUFFLE} ON` : `${ICONS.SHUFFLE} OFF`] }), (playerState.speed ?? 1.0) !== 1.0 && (_jsxs(Text, { color: theme.colors.accent, children: ["[", _jsx(Text, { color: theme.colors.dim, children: "<>" }), "]", ' ', (playerState.speed ?? 1.0).toFixed(2), "x"] }))] }));
 }

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/dist/source/utils/icons.d.ts

@@ -0,0 +1,19 @@
+export declare const ICONS: {
+    readonly PLAY: "▶";
+    readonly PAUSE: "‖";
+    readonly PLAY_PAUSE_ON: "▶";
+    readonly PLAY_PAUSE_OFF: "‖";
+    readonly NEXT: "▶|";
+    readonly PREV: "|◀";
+    readonly SHUFFLE: "⇄";
+    readonly REPEAT_ALL: "↻";
+    readonly REPEAT_ONE: "↺";
+    readonly PLAYLIST: "☰";
+    readonly SEARCH: "/";
+    readonly HELP: "?";
+    readonly DOWNLOAD: "↓";
+    readonly QUIT: "×";
+    readonly RESUME: "⟳";
+    readonly BG_PLAY: "○";
+    readonly VOLUME: "♪";
+};

package/dist/source/utils/icons.js

@@ -0,0 +1,26 @@
+// Universal icon constants using widely-supported Unicode BMP characters.
+// No emoji, no Nerd Font codepoints — renders correctly on any terminal font.
+export const ICONS = {
+    // Playback controls
+    PLAY: '▶', // U+25B6
+    PAUSE: '‖', // U+2016
+    PLAY_PAUSE_ON: '▶', // when playing
+    PLAY_PAUSE_OFF: '‖', // when paused
+    NEXT: '▶|', // next track
+    PREV: '|◀', // previous track
+    // Playback modes
+    SHUFFLE: '⇄', // U+21C4
+    REPEAT_ALL: '↻', // U+21BB
+    REPEAT_ONE: '↺', // U+21BA
+    // Navigation / views
+    PLAYLIST: '☰', // U+2630
+    SEARCH: '/', // ASCII
+    HELP: '?', // ASCII
+    // Actions
+    DOWNLOAD: '↓', // U+2193
+    QUIT: '×', // U+00D7
+    RESUME: '⟳', // U+27F3
+    BG_PLAY: '○', // U+25CB
+    // Status
+    VOLUME: '♪', // U+266A
+};

package/package.json

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