@involvex/youtube-music-cli 0.0.32 → 0.0.33

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.0.33](https://github.com/involvex/youtube-music-cli/compare/v0.0.32...v0.0.33) (2026-02-22)
+
+### Features
+
+- add gapless playback, crossfade, and equalizer settings ([0fe10f4](https://github.com/involvex/youtube-music-cli/commit/0fe10f42700bb9031e4e4c1eacca1bc3aba5ec4d))
+
 ## [0.0.32](https://github.com/involvex/youtube-music-cli/compare/v0.0.31...v0.0.32) (2026-02-22)
 
 ## [0.0.31](https://github.com/involvex/youtube-music-cli/compare/v0.0.30...v0.0.31) (2026-02-22)

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

@@ -5,10 +5,23 @@ import { KEYBINDINGS } from "../../utils/constants.js";
 import { usePlayer } from "../../hooks/usePlayer.js";
 import { useTheme } from "../../hooks/useTheme.js";
 import { Box, Text } from 'ink';
-import { useEffect } from 'react';
+import { useEffect, useState } from 'react';
 import { logger } from "../../services/logger/logger.service.js";
 import { ICONS } from "../../utils/icons.js";
+import { getConfigService } from "../../services/config/config.service.js";
 let mountCount = 0;
+const CROSSFADE_PRESETS = [0, 1, 2, 3, 5];
+const EQUALIZER_PRESETS = [
+    'flat',
+    'bass_boost',
+    'vocal',
+    'bright',
+    'warm',
+];
+const formatEqualizerLabel = (preset) => preset
+    .split('_')
+    .map(segment => `${segment.charAt(0).toUpperCase()}${segment.slice(1)}`)
+    .join(' ');
 export default function PlayerControls() {
     const instanceId = ++mountCount;
     useEffect(() => {
@@ -19,6 +32,10 @@ export default function PlayerControls() {
     }, [instanceId]);
     const { theme } = useTheme();
     const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, speedUp, speedDown, toggleShuffle, } = usePlayer();
+    const config = getConfigService();
+    const [gaplessPlayback, setGaplessPlayback] = useState(config.get('gaplessPlayback') ?? true);
+    const [crossfadeDuration, setCrossfadeDuration] = useState(config.get('crossfadeDuration') ?? 0);
+    const [equalizerPreset, setEqualizerPreset] = useState(config.get('equalizerPreset') ?? 'flat');
     // DEBUG: Log when callbacks change (detect instability)
     useEffect(() => {
         // Temporarily output to stderr to debug without triggering Ink re-render
@@ -32,6 +49,24 @@ export default function PlayerControls() {
             resume();
         }
     };
+    const toggleGaplessPlayback = () => {
+        const next = !gaplessPlayback;
+        setGaplessPlayback(next);
+        config.set('gaplessPlayback', next);
+    };
+    const cycleCrossfadeDuration = () => {
+        const currentIndex = CROSSFADE_PRESETS.indexOf(crossfadeDuration);
+        const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % CROSSFADE_PRESETS.length;
+        const next = CROSSFADE_PRESETS[nextIndex] ?? 0;
+        setCrossfadeDuration(next);
+        config.set('crossfadeDuration', next);
+    };
+    const cycleEqualizerPreset = () => {
+        const currentIndex = EQUALIZER_PRESETS.indexOf(equalizerPreset);
+        const next = EQUALIZER_PRESETS[(currentIndex + 1) % EQUALIZER_PRESETS.length];
+        setEqualizerPreset(next);
+        config.set('equalizerPreset', next);
+    };
     // Keyboard bindings
     useKeyBinding(KEYBINDINGS.PLAY_PAUSE, handlePlayPause);
     useKeyBinding(KEYBINDINGS.NEXT, next);
@@ -41,5 +76,8 @@ 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 ? `${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"] }))] }));
+    useKeyBinding(KEYBINDINGS.GAPLESS_TOGGLE, toggleGaplessPlayback);
+    useKeyBinding(KEYBINDINGS.CROSSFADE_CYCLE, cycleCrossfadeDuration);
+    useKeyBinding(KEYBINDINGS.EQUALIZER_CYCLE, cycleEqualizerPreset);
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_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"] }))] }), _jsxs(Box, { flexDirection: "row", justifyContent: "space-between", paddingX: 2, gap: 2, children: [_jsxs(Text, { color: gaplessPlayback ? theme.colors.primary : theme.colors.dim, children: ["Gapless: ", gaplessPlayback ? 'ON' : 'OFF'] }), _jsxs(Text, { color: theme.colors.text, children: ["Crossfade: ", crossfadeDuration === 0 ? 'Off' : `${crossfadeDuration}s`] }), _jsxs(Text, { color: theme.colors.text, children: ["Equalizer: ", formatEqualizerLabel(equalizerPreset)] })] })] }));
 }

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

@@ -13,9 +13,20 @@ import { formatTime } from "../../utils/format.js";
 import { useKeyboardBlocker } from "../../hooks/useKeyboardBlocker.js";
 const QUALITIES = ['low', 'medium', 'high'];
 const DOWNLOAD_FORMATS = ['mp3', 'm4a'];
+const CROSSFADE_PRESETS = [0, 1, 2, 3, 5];
+const EQUALIZER_PRESETS = [
+    'flat',
+    'bass_boost',
+    'vocal',
+    'bright',
+    'warm',
+];
 const SETTINGS_ITEMS = [
     'Stream Quality',
     'Audio Normalization',
+    'Gapless Playback',
+    'Crossfade Duration',
+    'Equalizer Preset',
     'Notifications',
     'Discord Rich Presence',
     'Downloads Enabled',
@@ -34,6 +45,9 @@ export default function Settings() {
     const [selectedIndex, setSelectedIndex] = useState(0);
     const [quality, setQuality] = useState(config.get('streamQuality') || 'high');
     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 [equalizerPreset, setEqualizerPreset] = useState(config.get('equalizerPreset') ?? 'flat');
     const [notifications, setNotifications] = useState(config.get('notifications') ?? false);
     const [discordRpc, setDiscordRpc] = useState(config.get('discordRichPresence') ?? false);
     const [downloadsEnabled, setDownloadsEnabled] = useState(config.get('downloadsEnabled') ?? false);
@@ -59,6 +73,28 @@ export default function Settings() {
         setAudioNormalization(next);
         config.set('audioNormalization', next);
     };
+    const toggleGaplessPlayback = () => {
+        const next = !gaplessPlayback;
+        setGaplessPlayback(next);
+        config.set('gaplessPlayback', next);
+    };
+    const cycleCrossfadeDuration = () => {
+        const currentIndex = CROSSFADE_PRESETS.indexOf(crossfadeDuration);
+        const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % CROSSFADE_PRESETS.length;
+        const next = CROSSFADE_PRESETS[nextIndex] ?? 0;
+        setCrossfadeDuration(next);
+        config.set('crossfadeDuration', next);
+    };
+    const cycleEqualizerPreset = () => {
+        const currentIndex = EQUALIZER_PRESETS.indexOf(equalizerPreset);
+        const nextPreset = EQUALIZER_PRESETS[(currentIndex + 1) % EQUALIZER_PRESETS.length];
+        setEqualizerPreset(nextPreset);
+        config.set('equalizerPreset', nextPreset);
+    };
+    const formatEqualizerLabel = (preset) => preset
+        .split('_')
+        .map(segment => `${segment.charAt(0).toUpperCase()}${segment.slice(1)}`)
+        .join(' ');
     const toggleNotifications = () => {
         const next = !notifications;
         setNotifications(next);
@@ -100,33 +136,42 @@ export default function Settings() {
             toggleNormalization();
         }
         else if (selectedIndex === 2) {
-            toggleNotifications();
+            toggleGaplessPlayback();
         }
         else if (selectedIndex === 3) {
-            toggleDiscordRpc();
+            cycleCrossfadeDuration();
         }
         else if (selectedIndex === 4) {
-            toggleDownloadsEnabled();
+            cycleEqualizerPreset();
         }
         else if (selectedIndex === 5) {
-            setIsEditingDownloadDirectory(true);
+            toggleNotifications();
         }
         else if (selectedIndex === 6) {
-            cycleDownloadFormat();
+            toggleDiscordRpc();
         }
         else if (selectedIndex === 7) {
-            cycleSleepTimer();
+            toggleDownloadsEnabled();
         }
         else if (selectedIndex === 8) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.IMPORT });
+            setIsEditingDownloadDirectory(true);
         }
         else if (selectedIndex === 9) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.EXPORT_PLAYLISTS });
+            cycleDownloadFormat();
         }
         else if (selectedIndex === 10) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+            cycleSleepTimer();
         }
         else if (selectedIndex === 11) {
+            dispatch({ category: 'NAVIGATE', view: VIEW.IMPORT });
+        }
+        else if (selectedIndex === 12) {
+            dispatch({ category: 'NAVIGATE', view: VIEW.EXPORT_PLAYLISTS });
+        }
+        else if (selectedIndex === 13) {
+            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+        }
+        else if (selectedIndex === 14) {
             dispatch({ category: 'NAVIGATE', view: VIEW.PLUGINS });
         }
     };
@@ -136,19 +181,18 @@ 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: ["Desktop Notifications: ", notifications ? '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: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _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: ["Download Feature: ", downloadsEnabled ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: isEditingDownloadDirectory && selectedIndex === 5 ? (_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: ["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 => {
                         const normalized = value.trim();
                         if (!normalized) {
-                            setDownloadDirectory(config.get('downloadDirectory') ?? '');
                             setIsEditingDownloadDirectory(false);
                             return;
                         }
                         setDownloadDirectory(normalized);
                         config.set('downloadDirectory', normalized);
                         setIsEditingDownloadDirectory(false);
-                    }, placeholder: "Download directory", focus: true })) : (_jsxs(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: ["Download Folder: ", downloadDirectory] })) }), _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: ["Download Format: ", downloadFormat.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 7 ? theme.colors.primary : undefined, color: selectedIndex === 7
+                    }, 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
                         ? theme.colors.background
                         : isActive
                             ? theme.colors.accent
-                            : theme.colors.text, bold: selectedIndex === 7, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 8 ? theme.colors.primary : undefined, color: selectedIndex === 8 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 8, children: "Import Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 9 ? theme.colors.primary : undefined, color: selectedIndex === 9 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 9, children: "Export Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 10 ? theme.colors.primary : undefined, color: selectedIndex === 10 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 10, children: "Custom Keybindings \u2192" }) }), _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: "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 === 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" }) })] }));
 }

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

@@ -41,6 +41,9 @@ class ConfigService {
                     enabled: false,
                 },
             },
+            gaplessPlayback: true,
+            crossfadeDuration: 0,
+            equalizerPreset: 'flat',
         };
     }
     load() {

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

@@ -1,7 +1,11 @@
+import type { EqualizerPreset } from '../../types/config.types.ts';
 export type PlayOptions = {
     volume?: number;
     audioNormalization?: boolean;
     proxy?: string;
+    gaplessPlayback?: boolean;
+    crossfadeDuration?: number;
+    equalizerPreset?: EqualizerPreset;
 };
 export type PlayerEventCallback = (event: {
     timePos?: number;

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

@@ -2,6 +2,19 @@
 import { spawn } from 'node:child_process';
 import { connect } from 'node:net';
 import { logger } from "../logger/logger.service.js";
+const EQUALIZER_PRESET_FILTERS = {
+    flat: [],
+    bass_boost: ['equalizer=f=60:width_type=o:width=2:g=5'],
+    vocal: ['equalizer=f=2500:width_type=o:width=2:g=3'],
+    bright: [
+        'equalizer=f=4000:width_type=o:width=2:g=3',
+        'equalizer=f=8000:width_type=o:width=2:g=2',
+    ],
+    warm: [
+        'equalizer=f=100:width_type=o:width=2:g=4',
+        'equalizer=f=250:width_type=o:width=2:g=2',
+    ],
+};
 class PlayerService {
     static instance;
     mpvProcess = null;
@@ -212,6 +225,20 @@ class PlayerService {
                     volume: this.currentVolume,
                     ipcPath: this.ipcPath,
                 });
+                const gapless = options?.gaplessPlayback ?? true;
+                const crossfadeDuration = Math.max(0, options?.crossfadeDuration ?? 0);
+                const eqPreset = options?.equalizerPreset ?? 'flat';
+                const audioFilters = [];
+                if (options?.audioNormalization) {
+                    audioFilters.push('dynaudnorm');
+                }
+                if (crossfadeDuration > 0) {
+                    audioFilters.push(`acrossfade=d=${crossfadeDuration}`);
+                }
+                const presetFilters = EQUALIZER_PRESET_FILTERS[eqPreset] ?? [];
+                if (presetFilters.length > 0) {
+                    audioFilters.push(...presetFilters);
+                }
                 // Spawn mpv with JSON IPC for better control
                 const mpvArgs = [
                     '--no-video', // Audio only
@@ -225,9 +252,10 @@ class PlayerService {
                     '--cache=yes', // Enable cache for network streams
                     '--cache-secs=30', // Buffer 30 seconds ahead
                     '--network-timeout=10', // 10s network timeout
+                    `--gapless-audio=${gapless ? 'yes' : 'no'}`,
                 ];
-                if (options?.audioNormalization) {
-                    mpvArgs.push('--af=dynaudnorm');
+                if (audioFilters.length > 0) {
+                    mpvArgs.push(`--af=${audioFilters.join(',')}`);
                 }
                 if (options?.proxy) {
                     mpvArgs.push(`--http-proxy=${options.proxy}`);

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

@@ -386,6 +386,9 @@ function PlayerManager() {
                         volume: state.volume,
                         audioNormalization: config.get('audioNormalization') ?? false,
                         proxy: config.get('proxy'),
+                        gaplessPlayback: config.get('gaplessPlayback') ?? true,
+                        crossfadeDuration: config.get('crossfadeDuration') ?? 0,
+                        equalizerPreset: config.get('equalizerPreset') ?? 'flat',
                     });
                     logger.info('PlayerManager', 'Playback started successfully', {
                         attempt,

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

@@ -3,6 +3,7 @@ import type { Theme } from './theme.types.ts';
 import type { WebServerConfig } from './web.types.ts';
 export type RepeatMode = 'off' | 'all' | 'one';
 export type DownloadFormat = 'mp3' | 'm4a';
+export type EqualizerPreset = 'flat' | 'bass_boost' | 'vocal' | 'bright' | 'warm';
 export interface KeybindingConfig {
     keys: string[];
     description: string;
@@ -20,6 +21,9 @@ export interface Config {
     customTheme?: Theme;
     streamQuality?: 'low' | 'medium' | 'high';
     audioNormalization?: boolean;
+    gaplessPlayback?: boolean;
+    crossfadeDuration?: number;
+    equalizerPreset?: EqualizerPreset;
     notifications?: boolean;
     scrobbling?: {
         lastfm?: {

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

@@ -47,6 +47,9 @@ export declare const KEYBINDINGS: {
     readonly VOLUME_FINE_DOWN: readonly ["shift+-"];
     readonly SHUFFLE: readonly ["shift+s"];
     readonly REPEAT: readonly ["r"];
+    readonly GAPLESS_TOGGLE: readonly ["shift+g"];
+    readonly CROSSFADE_CYCLE: readonly ["shift+c"];
+    readonly EQUALIZER_CYCLE: readonly ["shift+e"];
     readonly SEEK_FORWARD: readonly ["shift+right"];
     readonly SEEK_BACKWARD: readonly ["shift+left"];
     readonly SPEED_UP: readonly [">"];

package/dist/source/utils/constants.js

@@ -56,6 +56,9 @@ export const KEYBINDINGS = {
     VOLUME_FINE_DOWN: ['shift+-'], // Fine-grained -1 step
     SHUFFLE: ['shift+s'],
     REPEAT: ['r'],
+    GAPLESS_TOGGLE: ['shift+g'],
+    CROSSFADE_CYCLE: ['shift+c'],
+    EQUALIZER_CYCLE: ['shift+e'],
     SEEK_FORWARD: ['shift+right'],
     SEEK_BACKWARD: ['shift+left'],
     SPEED_UP: ['>'],

package/package.json

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