@involvex/youtube-music-cli 0.0.44 → 0.0.45

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.0.45](https://github.com/involvex/youtube-music-cli/compare/v0.0.44...v0.0.45) (2026-02-24)
+
+### Features
+
+- add volume fade duration setting for smoother playback transitions ([936e3e2](https://github.com/involvex/youtube-music-cli/commit/936e3e2c7ae043b26dd48a1cd6f2d26cb11b0ae2))
+
 ## [0.0.44](https://github.com/involvex/youtube-music-cli/compare/v0.0.43...v0.0.44) (2026-02-23)
 
 ### Features

package/dist/package.json

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

package/dist/source/cli.js

@@ -157,6 +157,7 @@ async function runDirectPlaybackCommand(flags) {
     const playbackOptions = {
         volume: flags.volume ?? config.get('volume'),
         audioNormalization: config.get('audioNormalization'),
+        volumeFadeDuration: config.get('volumeFadeDuration'),
     };
     let track;
     if (flags.playTrack) {

package/dist/source/components/settings/Settings.js

@@ -21,11 +21,13 @@ const EQUALIZER_PRESETS = [
     'bright',
     'warm',
 ];
+const VOLUME_FADE_PRESETS = [0, 1, 2, 3, 5];
 const SETTINGS_ITEMS = [
     'Stream Quality',
     'Audio Normalization',
     'Gapless Playback',
     'Crossfade Duration',
+    'Volume Fade Duration',
     'Equalizer Preset',
     'Notifications',
     'Discord Rich Presence',
@@ -47,6 +49,7 @@ export default function Settings() {
     const [audioNormalization, setAudioNormalization] = useState(config.get('audioNormalization') ?? false);
     const [gaplessPlayback, setGaplessPlayback] = useState(config.get('gaplessPlayback') ?? true);
     const [crossfadeDuration, setCrossfadeDuration] = useState(config.get('crossfadeDuration') ?? 0);
+    const [volumeFadeDuration, setVolumeFadeDuration] = useState(config.get('volumeFadeDuration') ?? 0);
     const [equalizerPreset, setEqualizerPreset] = useState(config.get('equalizerPreset') ?? 'flat');
     const [notifications, setNotifications] = useState(config.get('notifications') ?? false);
     const [discordRpc, setDiscordRpc] = useState(config.get('discordRichPresence') ?? false);
@@ -85,6 +88,13 @@ export default function Settings() {
         setCrossfadeDuration(next);
         config.set('crossfadeDuration', next);
     };
+    const cycleVolumeFadeDuration = () => {
+        const currentIndex = VOLUME_FADE_PRESETS.indexOf(volumeFadeDuration);
+        const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % VOLUME_FADE_PRESETS.length;
+        const next = VOLUME_FADE_PRESETS[nextIndex] ?? 0;
+        setVolumeFadeDuration(next);
+        config.set('volumeFadeDuration', next);
+    };
     const cycleEqualizerPreset = () => {
         const currentIndex = EQUALIZER_PRESETS.indexOf(equalizerPreset);
         const nextPreset = EQUALIZER_PRESETS[(currentIndex + 1) % EQUALIZER_PRESETS.length];
@@ -142,36 +152,39 @@ export default function Settings() {
             cycleCrossfadeDuration();
         }
         else if (selectedIndex === 4) {
-            cycleEqualizerPreset();
+            cycleVolumeFadeDuration();
         }
         else if (selectedIndex === 5) {
-            toggleNotifications();
+            cycleEqualizerPreset();
         }
         else if (selectedIndex === 6) {
-            toggleDiscordRpc();
+            toggleNotifications();
         }
         else if (selectedIndex === 7) {
-            toggleDownloadsEnabled();
+            toggleDiscordRpc();
         }
         else if (selectedIndex === 8) {
-            setIsEditingDownloadDirectory(true);
+            toggleDownloadsEnabled();
         }
         else if (selectedIndex === 9) {
-            cycleDownloadFormat();
+            setIsEditingDownloadDirectory(true);
         }
         else if (selectedIndex === 10) {
-            cycleSleepTimer();
+            cycleDownloadFormat();
         }
         else if (selectedIndex === 11) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.IMPORT });
+            cycleSleepTimer();
         }
         else if (selectedIndex === 12) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.EXPORT_PLAYLISTS });
+            dispatch({ category: 'NAVIGATE', view: VIEW.IMPORT });
         }
         else if (selectedIndex === 13) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+            dispatch({ category: 'NAVIGATE', view: VIEW.EXPORT_PLAYLISTS });
         }
         else if (selectedIndex === 14) {
+            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+        }
+        else if (selectedIndex === 15) {
             dispatch({ category: 'NAVIGATE', view: VIEW.PLUGINS });
         }
     };
@@ -181,7 +194,7 @@ export default function Settings() {
     const sleepTimerLabel = isActive && remainingSeconds !== null
         ? `Sleep Timer: ${formatTime(remainingSeconds)} remaining (Enter to cancel)`
         : 'Sleep Timer: Off (Enter to set)';
-    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: "Settings" }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 0 ? theme.colors.primary : undefined, color: selectedIndex === 0 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 0, children: ["Stream Quality: ", quality.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 1 ? theme.colors.primary : undefined, color: selectedIndex === 1 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 1, children: ["Audio Normalization: ", audioNormalization ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 2 ? theme.colors.primary : undefined, color: selectedIndex === 2 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 2, children: ["Gapless Playback: ", gaplessPlayback ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 3 ? theme.colors.primary : undefined, color: selectedIndex === 3 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 3, children: ["Crossfade: ", crossfadeDuration === 0 ? 'Off' : `${crossfadeDuration}s`] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 4 ? theme.colors.primary : undefined, color: selectedIndex === 4 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 4, children: ["Equalizer: ", formatEqualizerLabel(equalizerPreset)] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: ["Desktop Notifications: ", notifications ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 6 ? theme.colors.primary : undefined, color: selectedIndex === 6 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 6, children: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 7 ? theme.colors.primary : undefined, color: selectedIndex === 7 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 7, children: ["Download Feature: ", downloadsEnabled ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: isEditingDownloadDirectory && selectedIndex === 8 ? (_jsx(TextInput, { value: downloadDirectory, onChange: setDownloadDirectory, onSubmit: value => {
+    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: "Settings" }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 0 ? theme.colors.primary : undefined, color: selectedIndex === 0 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 0, children: ["Stream Quality: ", quality.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 1 ? theme.colors.primary : undefined, color: selectedIndex === 1 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 1, children: ["Audio Normalization: ", audioNormalization ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 2 ? theme.colors.primary : undefined, color: selectedIndex === 2 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 2, children: ["Gapless Playback: ", gaplessPlayback ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 3 ? theme.colors.primary : undefined, color: selectedIndex === 3 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 3, children: ["Crossfade: ", crossfadeDuration === 0 ? 'Off' : `${crossfadeDuration}s`] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 4 ? theme.colors.primary : undefined, color: selectedIndex === 4 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 4, children: ["Volume Fade:", ' ', volumeFadeDuration === 0 ? 'Off' : `${volumeFadeDuration}s`] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: ["Equalizer: ", formatEqualizerLabel(equalizerPreset)] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 6 ? theme.colors.primary : undefined, color: selectedIndex === 6 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 6, children: ["Desktop Notifications: ", notifications ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 7 ? theme.colors.primary : undefined, color: selectedIndex === 7 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 7, children: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 8 ? theme.colors.primary : undefined, color: selectedIndex === 8 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 8, children: ["Download Feature: ", downloadsEnabled ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: isEditingDownloadDirectory && selectedIndex === 9 ? (_jsx(TextInput, { value: downloadDirectory, onChange: setDownloadDirectory, onSubmit: value => {
                         const normalized = value.trim();
                         if (!normalized) {
                             setIsEditingDownloadDirectory(false);
@@ -190,9 +203,9 @@ export default function Settings() {
                         setDownloadDirectory(normalized);
                         config.set('downloadDirectory', normalized);
                         setIsEditingDownloadDirectory(false);
-                    }, placeholder: "Download directory", focus: true })) : (_jsxs(Text, { backgroundColor: selectedIndex === 8 ? theme.colors.primary : undefined, color: selectedIndex === 8 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 8, children: ["Download Folder: ", downloadDirectory] })) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 9 ? theme.colors.primary : undefined, color: selectedIndex === 9 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 9, children: ["Download Format: ", downloadFormat.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 10 ? theme.colors.primary : undefined, color: selectedIndex === 10
+                    }, placeholder: "Download directory", focus: true })) : (_jsxs(Text, { backgroundColor: selectedIndex === 9 ? theme.colors.primary : undefined, color: selectedIndex === 9 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 9, children: ["Download Folder: ", downloadDirectory] })) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 10 ? theme.colors.primary : undefined, color: selectedIndex === 10 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 10, children: ["Download Format: ", downloadFormat.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 11 ? theme.colors.primary : undefined, color: selectedIndex === 11
                         ? theme.colors.background
                         : isActive
                             ? theme.colors.accent
-                            : theme.colors.text, bold: selectedIndex === 10, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 11 ? theme.colors.primary : undefined, color: selectedIndex === 11 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 11, children: "Import Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 12 ? theme.colors.primary : undefined, color: selectedIndex === 12 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 12, children: "Export Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 13 ? theme.colors.primary : undefined, color: selectedIndex === 13 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 13, children: "Custom Keybindings \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 14 ? theme.colors.primary : undefined, color: selectedIndex === 14 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 14, children: "Manage Plugins" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.colors.dim, children: "Arrows to navigate, Enter to select, Esc/q to go back" }) })] }));
+                            : theme.colors.text, bold: selectedIndex === 11, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 12 ? theme.colors.primary : undefined, color: selectedIndex === 12 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 12, children: "Import Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 13 ? theme.colors.primary : undefined, color: selectedIndex === 13 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 13, children: "Export Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 14 ? theme.colors.primary : undefined, color: selectedIndex === 14 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 14, children: "Custom Keybindings \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 15 ? theme.colors.primary : undefined, color: selectedIndex === 15 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 15, children: "Manage Plugins" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.colors.dim, children: "Arrows to navigate, Enter to select, Esc/q to go back" }) })] }));
 }

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

@@ -43,6 +43,7 @@ class ConfigService {
             },
             gaplessPlayback: true,
             crossfadeDuration: 0,
+            volumeFadeDuration: 0,
             equalizerPreset: 'flat',
         };
     }

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

@@ -6,6 +6,7 @@ export type PlayOptions = {
     gaplessPlayback?: boolean;
     crossfadeDuration?: number;
     equalizerPreset?: EqualizerPreset;
+    volumeFadeDuration?: number;
 };
 export type MpvArgsOptions = PlayOptions & {
     volume: number;

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

@@ -5,11 +5,16 @@ import { logger } from "../logger/logger.service.js";
 export function buildMpvArgs(url, ipcPath, options) {
     const gapless = options.gaplessPlayback ?? true;
     const crossfadeDuration = Math.max(0, options.crossfadeDuration ?? 0);
+    const fadeDuration = Math.max(0, options.volumeFadeDuration ?? 0);
     const eqPreset = options.equalizerPreset ?? 'flat';
     const audioFilters = [];
     if (options.audioNormalization) {
         audioFilters.push('dynaudnorm');
     }
+    if (fadeDuration > 0) {
+        audioFilters.push(`afade=t=in:st=0:d=${fadeDuration}`);
+        audioFilters.push(`afade=t=out:d=${fadeDuration}`);
+    }
     if (crossfadeDuration > 0) {
         audioFilters.push(`acrossfade=d=${crossfadeDuration}`);
     }

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

@@ -141,6 +141,7 @@ class WebServerManager {
     handleCommand(action) {
         logger.debug('WebServerManager', 'Executing command from client', { action });
         const playerService = getPlayerService();
+        const config = getConfigService();
         // Execute command and update internal state
         switch (action.category) {
             case 'PLAY': {
@@ -152,6 +153,7 @@ class WebServerManager {
                     const youtubeUrl = `https://www.youtube.com/watch?v=${action.track.videoId}`;
                     void playerService.play(youtubeUrl, {
                         volume: this.internalState.volume,
+                        volumeFadeDuration: config.get('volumeFadeDuration'),
                     });
                 }
                 break;
@@ -202,6 +204,7 @@ class WebServerManager {
                     const youtubeUrl = `https://www.youtube.com/watch?v=${this.internalState.currentTrack.videoId}`;
                     void playerService.play(youtubeUrl, {
                         volume: this.internalState.volume,
+                        volumeFadeDuration: config.get('volumeFadeDuration'),
                     });
                 }
                 break;

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

@@ -402,6 +402,7 @@ function PlayerManager() {
                         gaplessPlayback: config.get('gaplessPlayback') ?? true,
                         crossfadeDuration: config.get('crossfadeDuration') ?? 0,
                         equalizerPreset: config.get('equalizerPreset') ?? 'flat',
+                        volumeFadeDuration: config.get('volumeFadeDuration') ?? 0,
                     });
                     logger.info('PlayerManager', 'Playback started successfully', {
                         attempt,

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

@@ -23,6 +23,7 @@ export interface Config {
     audioNormalization?: boolean;
     gaplessPlayback?: boolean;
     crossfadeDuration?: number;
+    volumeFadeDuration?: number;
     equalizerPreset?: EqualizerPreset;
     notifications?: boolean;
     scrobbling?: {

package/package.json

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