@involvex/youtube-music-cli 0.0.39 → 0.0.45

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+## [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
+
+- add standalone executable support with build-time versioning ([18f730c](https://github.com/involvex/youtube-music-cli/commit/18f730cef46dfe862cfbce0065af4b4989296ef0))
+
+## [0.0.43](https://github.com/involvex/youtube-music-cli/compare/v0.0.42...v0.0.43) (2026-02-23)
+
+## [0.0.42](https://github.com/involvex/youtube-music-cli/compare/v0.0.41...v0.0.42) (2026-02-23)
+
+## [0.0.41](https://github.com/involvex/youtube-music-cli/compare/v0.0.40...v0.0.41) (2026-02-23)
+
+### Features
+
+- add shell completions for bash, zsh, powershell, and fish ([5adecc3](https://github.com/involvex/youtube-music-cli/commit/5adecc3af1cf6dae5a188c24c598e67c8260c844))
+
+## [0.0.40](https://github.com/involvex/youtube-music-cli/compare/v0.0.39...v0.0.40) (2026-02-23)
+
+### Features
+
+- enable MSIX packaging for Windows distribution ([14eafbf](https://github.com/involvex/youtube-music-cli/commit/14eafbf522f1d2fbacf7ed1243df035cd254891b))
+
 ## [0.0.39](https://github.com/involvex/youtube-music-cli/compare/v0.0.38...v0.0.39) (2026-02-23)
 
 ### Features

package/dist/package.json

@@ -0,0 +1,120 @@
+{
+    "name": "@involvex/youtube-music-cli",
+    "version": "0.0.45",
+    "description": "- A Commandline music player for youtube-music",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/involvex/youtube-music-cli.git"
+    },
+    "funding": "https://github.com/sponsors/involvex",
+    "license": "MIT",
+    "author": "involvex",
+    "type": "module",
+    "bin": {
+        "youtube-music-cli": "dist/source/cli.js",
+        "ymc": "dist/source/cli.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "CHANGELOG.md",
+        "LICENSE",
+        ".github/FUNDING.yml"
+    ],
+    "icon": "assets/icon2.PNG",
+    "sponsor": {
+        "url": "https://github.com/sponsors/involvex"
+    },
+    "homepage": "https://involvex.github.io/youtube-music-cli/",
+    "keywords": [
+        "cli",
+        "youtube",
+        "youtube-music",
+        "youtube-cli",
+        "youtube-music-cli",
+        "ink",
+        "cli-music"
+    ],
+    "scripts": {
+        "prebuild": "bun run format && bun run lint:fix && bun run typecheck",
+        "build": "tsc",
+        "bun:build": "bun build source/cli.tsx --outfile dist/index.js --target node --footer \"//Copyright (c) 2026 involvex\"",
+        "compile": "bun scripts/build-cli.ts",
+        "dev": "bun run --bun source/cli.tsx",
+        "dev:watch": "bun run --bun --watch source/cli.tsx",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
+        "lint": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-pattern dist",
+        "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix --ignore-pattern dist",
+        "start": "bun run dist/source/cli.js",
+        "test": "bun run build && ava",
+        "typecheck": "tsc --noEmit",
+        "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
+        "clean": "rimraf dist",
+        "release": "powershell -File scripts/release.ps1",
+        "build:web": "cd web && bun run build",
+        "dev:web": "cd web && bun run dev",
+        "build:all": "bun run build && bun run build:web",
+        "msix": "bun run compile && msix-packager-cli package --config ./msix-config.json --skip-build"
+    },
+    "prettier": "@vdemedes/prettier-config",
+    "ava": {
+        "files": [
+            "tests/**/*.js"
+        ]
+    },
+    "dependencies": {
+        "@distube/ytdl-core": "^4.16.12",
+        "@types/bun": "^1.3.9",
+        "ansi-escapes": "^7.3.0",
+        "discord-rpc": "^4.0.1",
+        "ink": "^6.8.0",
+        "ink-table": "^3.1.0",
+        "ink-text-input": "^6.0.0",
+        "jiti": "^2.6.1",
+        "meow": "^14.1.0",
+        "node-notifier": "^10.0.1",
+        "node-youtube-music": "^0.10.3",
+        "play-sound": "^1.1.6",
+        "react": "^19.2.4",
+        "ws": "^8.19.0",
+        "youtube-ext": "^1.1.25",
+        "youtubei.js": "^16.0.1"
+    },
+    "devDependencies": {
+        "@eslint/js": "^10.0.1",
+        "@sindresorhus/tsconfig": "^8.1.0",
+        "@types/node": "^25.3.0",
+        "@types/node-notifier": "^8.0.5",
+        "@types/react": "^19.2.14",
+        "@types/ws": "^8.18.1",
+        "@vdemedes/prettier-config": "^2.0.1",
+        "ava": "^6.4.1",
+        "chalk": "^5.6.2",
+        "conventional-changelog-cli": "^5.0.0",
+        "eslint": "^10.0.1",
+        "eslint-plugin-react": "^7.37.5",
+        "eslint-plugin-react-hooks": "^7.0.1",
+        "globals": "^17.3.0",
+        "ink-testing-library": "^4.0.0",
+        "prettier": "^3.8.1",
+        "prettier-plugin-organize-imports": "^4.3.0",
+        "prettier-plugin-packagejson": "^3.0.0",
+        "prettier-plugin-sort-imports": "^1.8.11",
+        "react-devtools-core": "^7.0.1",
+        "rimraf": "^6.1.3",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.56.0"
+    },
+    "engines": {
+        "node": ">=16"
+    },
+    "sponsors": "https://github.com/sponsors/involvex",
+    "overrides": {
+        "minimatch": "^10.2.1"
+    },
+    "trustedDependencies": [
+        "unrs-resolver"
+    ]
+}

package/dist/scripts/build-cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/build-cli.js

@@ -0,0 +1,46 @@
+import path from 'node:path';
+import pkg from '../package.json' with { type: 'json' };
+const rootDir = process.cwd();
+const isWindows = process.platform === 'win32';
+const outputName = isWindows ? 'youtube-music-cli.exe' : 'youtube-music-cli';
+const outfile = path.join(rootDir, 'dist', outputName);
+const banner = '//Copyright (c) 2026 involvex';
+const iconPath = path.join(rootDir, 'assets', 'icon.ico');
+const platformTarget = isWindows
+    ? 'bun-windows-x64'
+    : process.platform === 'darwin'
+        ? 'bun-darwin-x64'
+        : 'bun-linux-x64';
+const compileOptions = isWindows
+    ? {
+        target: platformTarget,
+        outfile,
+        footer: banner,
+        windowsTitle: 'YouTube Music CLI',
+        windowsPublisher: 'involvex',
+        windowsIcon: iconPath,
+        windowsCopyright: 'Copyright (c) 2026 involvex',
+        windowsDescription: 'A Commandline music player for youtube-music',
+    }
+    : {
+        target: platformTarget,
+        outfile,
+    };
+const buildOptions = {
+    entrypoints: [path.join(rootDir, 'source', 'cli.tsx')],
+    compile: compileOptions,
+    footer: banner,
+    minify: true,
+    sourcemap: 'linked',
+    bytecode: false,
+    define: {
+        'process.env.NODE_ENV': JSON.stringify('production'),
+        VERSION: JSON.stringify(pkg.version ?? '0.0.0'),
+    },
+};
+const result = await Bun.build(buildOptions);
+if (!result.success) {
+    console.error('Build failed', result.logs ?? result);
+    process.exit(1);
+}
+console.log('Build succeeded:', result.outputs.map(output => output.path));

package/dist/source/cli.js

@@ -10,12 +10,19 @@ import { getImportService } from "./services/import/import.service.js";
 import { getWebServerManager } from "./services/web/web-server-manager.js";
 import { getWebStreamingService } from "./services/web/web-streaming.service.js";
 import { getVersionCheckService } from "./services/version-check/version-check.service.js";
+import { generateCompletion, } from "./services/completions/completions.service.js";
 import { getConfigService } from "./services/config/config.service.js";
 import { getPlayerService } from "./services/player/player.service.js";
 import { APP_VERSION } from "./utils/constants.js";
 import { ensurePlaybackDependencies } from "./services/player/dependency-check.service.js";
 import { getMusicService } from "./services/youtube-music/api.js";
+const isStandalone = process
+    .isStandaloneExecutable ||
+    globalThis.Bun?.isStandalone;
+const argv = isStandalone ? process.argv.slice(1) : process.argv.slice(2);
 const cli = meow(`
+	youtube-music-cli@${APP_VERSION}
+
 	Usage
 	  $ youtube-music-cli
 	  $ youtube-music-cli play <track-id|youtube-url>
@@ -53,6 +60,12 @@ const cli = meow(`
 	  --name               Custom name for imported playlist
 	  --help, -h           Show this help
 
+	Shell Completions
+	  $ youtube-music-cli completions bash
+	  $ youtube-music-cli completions zsh
+	  $ youtube-music-cli completions powershell
+	  $ youtube-music-cli completions fish
+
 	Examples
 	  $ youtube-music-cli
 	  $ youtube-music-cli play dQw4w9WgXcQ
@@ -61,8 +74,10 @@ const cli = meow(`
 	  $ youtube-music-cli plugins install adblock
 	  $ youtube-music-cli import spotify "https://open.spotify.com/playlist/..."
 	  $ youtube-music-cli --web --web-port 3000
+	  $ youtube-music-cli completions powershell | Out-File $PROFILE
 `, {
     importMeta: import.meta,
+    argv,
     flags: {
         theme: {
             type: 'string',
@@ -142,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) {
@@ -307,7 +323,17 @@ if (command === 'plugins') {
 }
 else {
     // Handle other direct commands
-    if (command === 'play' && args[0]) {
+    if (command === 'completions') {
+        const shell = args[0];
+        const validShells = ['bash', 'zsh', 'powershell', 'fish'];
+        if (!shell || !validShells.includes(shell)) {
+            console.error('Usage: youtube-music-cli completions <bash|zsh|powershell|fish>');
+            process.exit(1);
+        }
+        console.log(generateCompletion(shell));
+        process.exit(0);
+    }
+    else if (command === 'play' && args[0]) {
         // Play specific track
         cli.flags.playTrack = args[0];
     }

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/completions/completions.service.d.ts

@@ -0,0 +1,2 @@
+export type ShellType = 'bash' | 'zsh' | 'powershell' | 'fish';
+export declare function generateCompletion(shell: ShellType): string;

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

@@ -0,0 +1,313 @@
+const COMMANDS = [
+    'play',
+    'search',
+    'playlist',
+    'suggestions',
+    'pause',
+    'resume',
+    'skip',
+    'back',
+    'plugins',
+    'import',
+    'completions',
+];
+const PLUGINS_SUBCOMMANDS = [
+    'list',
+    'install',
+    'remove',
+    'uninstall',
+    'update',
+    'enable',
+    'disable',
+];
+const IMPORT_SUBCOMMANDS = ['spotify', 'youtube'];
+const COMPLETIONS_SUBCOMMANDS = [
+    'bash',
+    'zsh',
+    'powershell',
+    'fish',
+];
+const FLAGS = [
+    '--theme',
+    '--volume',
+    '--shuffle',
+    '--repeat',
+    '--headless',
+    '--web',
+    '--web-host',
+    '--web-port',
+    '--web-only',
+    '--web-auth',
+    '--name',
+    '--help',
+    '--version',
+];
+export function generateCompletion(shell) {
+    switch (shell) {
+        case 'bash':
+            return generateBashCompletion();
+        case 'zsh':
+            return generateZshCompletion();
+        case 'powershell':
+            return generatePowerShellCompletion();
+        case 'fish':
+            return generateFishCompletion();
+    }
+}
+function generateBashCompletion() {
+    const cmds = COMMANDS.join(' ');
+    const pluginsSubs = PLUGINS_SUBCOMMANDS.join(' ');
+    const importSubs = IMPORT_SUBCOMMANDS.join(' ');
+    const completionsSubs = COMPLETIONS_SUBCOMMANDS.join(' ');
+    const flags = FLAGS.join(' ');
+    return `# youtube-music-cli bash completion
+# Add to ~/.bashrc or ~/.bash_profile:
+#   source <(ymc completions bash)
+#   # or:
+#   ymc completions bash >> ~/.bash_completion
+
+_ymc_completions() {
+    local cur prev words cword
+    _init_completion || return
+
+    local commands="${cmds}"
+    local flags="${flags}"
+
+    case "$prev" in
+        plugins)
+            COMPREPLY=($(compgen -W "${pluginsSubs}" -- "$cur"))
+            return ;;
+        import)
+            COMPREPLY=($(compgen -W "${importSubs}" -- "$cur"))
+            return ;;
+        completions)
+            COMPREPLY=($(compgen -W "${completionsSubs}" -- "$cur"))
+            return ;;
+        --theme|-t)
+            COMPREPLY=($(compgen -W "dark light midnight matrix" -- "$cur"))
+            return ;;
+        --repeat|-r)
+            COMPREPLY=($(compgen -W "off all one" -- "$cur"))
+            return ;;
+    esac
+
+    if [[ "$cur" == -* ]]; then
+        COMPREPLY=($(compgen -W "$flags" -- "$cur"))
+    else
+        COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+    fi
+}
+
+complete -F _ymc_completions ymc youtube-music-cli
+`;
+}
+function generateZshCompletion() {
+    return `#compdef ymc youtube-music-cli
+# youtube-music-cli zsh completion
+# Add to your zsh config:
+#   source <(ymc completions zsh)
+#   # or copy to a directory in $fpath:
+#   ymc completions zsh > ~/.zsh/completions/_ymc
+
+_ymc() {
+    local -a commands subcommands flags
+
+    commands=(
+        'play:Play a track by ID or YouTube URL'
+        'search:Search for tracks'
+        'playlist:Play a playlist by ID'
+        'suggestions:Show music suggestions'
+        'pause:Pause playback'
+        'resume:Resume playback'
+        'skip:Skip to next track'
+        'back:Go to previous track'
+        'plugins:Manage plugins'
+        'import:Import playlists from Spotify or YouTube'
+        'completions:Generate shell completion scripts'
+    )
+
+    flags=(
+        '--theme[Theme to use]:theme:(dark light midnight matrix)'
+        '--volume[Initial volume (0-100)]:volume:'
+        '--shuffle[Enable shuffle mode]'
+        '--repeat[Repeat mode]:mode:(off all one)'
+        '--headless[Run without TUI]'
+        '--web[Enable web UI server]'
+        '--web-host[Web server host]:host:'
+        '--web-port[Web server port]:port:'
+        '--web-only[Run web server without CLI UI]'
+        '--web-auth[Authentication token for web server]:token:'
+        '--name[Custom name for imported playlist]:name:'
+        '--help[Show help]'
+        '--version[Show version]'
+    )
+
+    case $words[2] in
+        plugins)
+            local -a plugin_cmds
+            plugin_cmds=(
+                'list:List installed plugins'
+                'install:Install a plugin'
+                'remove:Remove a plugin'
+                'uninstall:Alias for remove'
+                'update:Update a plugin'
+                'enable:Enable a plugin'
+                'disable:Disable a plugin'
+            )
+            _describe 'plugin commands' plugin_cmds
+            return ;;
+        import)
+            local -a import_sources
+            import_sources=('spotify:Import from Spotify' 'youtube:Import from YouTube')
+            _describe 'import sources' import_sources
+            return ;;
+        completions)
+            local -a shells
+            shells=('bash:Bash completion' 'zsh:Zsh completion' 'powershell:PowerShell completion' 'fish:Fish completion')
+            _describe 'shells' shells
+            return ;;
+    esac
+
+    _arguments -s \\
+        $flags \\
+        '1:command:->cmd' \\
+        '*::args:->args'
+
+    case $state in
+        cmd)
+            _describe 'commands' commands ;;
+        args)
+            _message 'arguments' ;;
+    esac
+}
+
+_ymc
+`;
+}
+function generatePowerShellCompletion() {
+    const cmds = COMMANDS.map(c => `'${c}'`).join(', ');
+    const pluginsSubs = PLUGINS_SUBCOMMANDS.map(c => `'${c}'`).join(', ');
+    const importSubs = IMPORT_SUBCOMMANDS.map(c => `'${c}'`).join(', ');
+    const completionsSubs = COMPLETIONS_SUBCOMMANDS.map(c => `'${c}'`).join(', ');
+    const flags = FLAGS.map(f => `'${f}'`).join(', ');
+    return `# youtube-music-cli PowerShell completion
+# Add to your PowerShell profile ($PROFILE):
+#   ymc completions powershell | Out-File -Append $PROFILE
+#   # or:
+#   Invoke-Expression (ymc completions powershell | Out-String)
+
+$ymcCompleterBlock = {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $commands = @(${cmds})
+    $pluginsSubCommands = @(${pluginsSubs})
+    $importSubCommands = @(${importSubs})
+    $completionsSubCommands = @(${completionsSubs})
+    $flags = @(${flags})
+    $themes = @('dark', 'light', 'midnight', 'matrix')
+    $repeatModes = @('off', 'all', 'one')
+
+    $tokens = $commandAst.CommandElements
+    $prevToken = if ($tokens.Count -ge 2) { $tokens[$tokens.Count - 2].ToString() } else { '' }
+    $firstArg = if ($tokens.Count -ge 2) { $tokens[1].ToString() } else { '' }
+
+    # Context-aware completions
+    switch ($prevToken) {
+        'plugins' {
+            $pluginsSubCommands | Where-Object { $_ -like "$wordToComplete*" } |
+                ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            return
+        }
+        'import' {
+            $importSubCommands | Where-Object { $_ -like "$wordToComplete*" } |
+                ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            return
+        }
+        'completions' {
+            $completionsSubCommands | Where-Object { $_ -like "$wordToComplete*" } |
+                ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            return
+        }
+        { $_ -in '--theme', '-t' } {
+            $themes | Where-Object { $_ -like "$wordToComplete*" } |
+                ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            return
+        }
+        { $_ -in '--repeat', '-r' } {
+            $repeatModes | Where-Object { $_ -like "$wordToComplete*" } |
+                ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            return
+        }
+    }
+
+    if ($wordToComplete.StartsWith('-')) {
+        $flags | Where-Object { $_ -like "$wordToComplete*" } |
+            ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+    } elseif ($firstArg -eq $wordToComplete -or $tokens.Count -le 1) {
+        $commands | Where-Object { $_ -like "$wordToComplete*" } |
+            ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+    }
+}
+
+Register-ArgumentCompleter -Native -CommandName @('ymc', 'youtube-music-cli') -ScriptBlock $ymcCompleterBlock
+`;
+}
+function generateFishCompletion() {
+    const commandCompletions = COMMANDS.map(cmd => `complete -c ymc -n '__fish_use_subcommand' -f -a '${cmd}' -d '${getFishDescription(cmd)}'`).join('\n');
+    const pluginsCompletions = PLUGINS_SUBCOMMANDS.map(sub => `complete -c ymc -n '__fish_seen_subcommand_from plugins' -f -a '${sub}'`).join('\n');
+    const importCompletions = IMPORT_SUBCOMMANDS.map(sub => `complete -c ymc -n '__fish_seen_subcommand_from import' -f -a '${sub}'`).join('\n');
+    const completionsCompletions = COMPLETIONS_SUBCOMMANDS.map(sub => `complete -c ymc -n '__fish_seen_subcommand_from completions' -f -a '${sub}'`).join('\n');
+    return `# youtube-music-cli fish completion
+# Save to: ~/.config/fish/completions/ymc.fish
+#   ymc completions fish > ~/.config/fish/completions/ymc.fish
+
+# Disable file completions by default
+complete -c ymc -f
+
+# Main commands
+${commandCompletions}
+
+# Plugins subcommands
+${pluginsCompletions}
+
+# Import subcommands
+${importCompletions}
+
+# Completions subcommands
+${completionsCompletions}
+
+# Flags
+complete -c ymc -l theme -s t -d 'Theme to use' -r -a 'dark light midnight matrix'
+complete -c ymc -l volume -s v -d 'Initial volume (0-100)' -r
+complete -c ymc -l shuffle -s s -d 'Enable shuffle mode'
+complete -c ymc -l repeat -s r -d 'Repeat mode' -r -a 'off all one'
+complete -c ymc -l headless -d 'Run without TUI'
+complete -c ymc -l web -d 'Enable web UI server'
+complete -c ymc -l web-host -d 'Web server host' -r
+complete -c ymc -l web-port -d 'Web server port' -r
+complete -c ymc -l web-only -d 'Run web server without CLI UI'
+complete -c ymc -l web-auth -d 'Authentication token for web server' -r
+complete -c ymc -l name -d 'Custom name for imported playlist' -r
+complete -c ymc -l help -s h -d 'Show help'
+complete -c ymc -l version -d 'Show version'
+
+# Also register for youtube-music-cli
+complete -c youtube-music-cli -w ymc
+`;
+}
+function getFishDescription(cmd) {
+    const descriptions = {
+        play: 'Play a track by ID or YouTube URL',
+        search: 'Search for tracks',
+        playlist: 'Play a playlist by ID',
+        suggestions: 'Show music suggestions',
+        pause: 'Pause playback',
+        resume: 'Resume playback',
+        skip: 'Skip to next track',
+        back: 'Go to previous track',
+        plugins: 'Manage plugins',
+        import: 'Import playlists from Spotify or YouTube',
+        completions: 'Generate shell completion scripts',
+    };
+    return descriptions[cmd] ?? cmd;
+}

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

@@ -1,5 +1,5 @@
 export declare const APP_NAME = "@involvex/youtube-music-cli";
-export declare const APP_VERSION = "0.0.20";
+export declare const APP_VERSION: string;
 export declare const CONFIG_DIR: string;
 export declare const CONFIG_FILE: string;
 export declare const VIEW: {

package/dist/source/utils/constants.js

@@ -1,6 +1,33 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+function loadAppVersion() {
+    if (typeof VERSION !== 'undefined') {
+        return VERSION;
+    }
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 5; i++) {
+        try {
+            const content = readFileSync(resolve(dir, 'package.json'), 'utf8');
+            const pkg = JSON.parse(content);
+            if (typeof pkg.version === 'string' &&
+                pkg.name?.includes('youtube-music-cli')) {
+                return pkg.version;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return '0.0.0';
+}
 // Application constants
 export const APP_NAME = '@involvex/youtube-music-cli';
-export const APP_VERSION = '0.0.20';
+export const APP_VERSION = loadAppVersion();
 // Config directory
 export const CONFIG_DIR = process.platform === 'win32'
     ? `${process.env['USERPROFILE']}\\.youtube-music-cli`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.39",
+	"version": "0.0.45",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",
@@ -38,8 +38,8 @@
 	"scripts": {
 		"prebuild": "bun run format && bun run lint:fix && bun run typecheck",
 		"build": "tsc",
-		"bun:build": "bun build source/cli.tsx --outfile dist/index.js --target node",
-		"compile": "bun build --compile source/cli.tsx --outfile dist/youtube-music-cli.exe",
+		"bun:build": "bun build source/cli.tsx --outfile dist/index.js --target node --footer \"//Copyright (c) 2026 involvex\"",
+		"compile": "bun scripts/build-cli.ts",
 		"dev": "bun run --bun source/cli.tsx",
 		"dev:watch": "bun run --bun --watch source/cli.tsx",
 		"format": "prettier --write .",
@@ -54,7 +54,8 @@
 		"release": "powershell -File scripts/release.ps1",
 		"build:web": "cd web && bun run build",
 		"dev:web": "cd web && bun run dev",
-		"build:all": "bun run build && bun run build:web"
+		"build:all": "bun run build && bun run build:web",
+		"msix": "bun run compile && msix-packager-cli package --config ./msix-config.json --skip-build"
 	},
 	"prettier": "@vdemedes/prettier-config",
 	"ava": {
@@ -64,20 +65,21 @@
 	},
 	"dependencies": {
 		"@distube/ytdl-core": "^4.16.12",
+		"@types/bun": "^1.3.9",
 		"ansi-escapes": "^7.3.0",
+		"discord-rpc": "^4.0.1",
 		"ink": "^6.8.0",
 		"ink-table": "^3.1.0",
 		"ink-text-input": "^6.0.0",
 		"jiti": "^2.6.1",
 		"meow": "^14.1.0",
 		"node-notifier": "^10.0.1",
-		"discord-rpc": "^4.0.1",
 		"node-youtube-music": "^0.10.3",
 		"play-sound": "^1.1.6",
 		"react": "^19.2.4",
+		"ws": "^8.19.0",
 		"youtube-ext": "^1.1.25",
-		"youtubei.js": "^16.0.1",
-		"ws": "^8.19.0"
+		"youtubei.js": "^16.0.1"
 	},
 	"devDependencies": {
 		"@eslint/js": "^10.0.1",