@involvex/youtube-music-cli 0.0.38 → 0.0.44

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+## [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
+
+- add visual flash feedback when shortcuts are pressed ([dc3efa8](https://github.com/involvex/youtube-music-cli/commit/dc3efa8f642619ad2e9ce937528e76f4d388e4dc))
+
 ## [0.0.38](https://github.com/involvex/youtube-music-cli/compare/v0.0.36...v0.0.38) (2026-02-22)
 
 ### Bug Fixes

package/dist/package.json

@@ -0,0 +1,120 @@
+{
+    "name": "@involvex/youtube-music-cli",
+    "version": "0.0.44",
+    "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',
@@ -307,7 +322,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/common/ShortcutsBar.js

@@ -1,16 +1,27 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 // Shortcuts bar component
+import { useState } from 'react';
 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";
+const FLASH_DURATION_MS = 300;
 export default function ShortcutsBar() {
     const { theme } = useTheme();
     const { state: playerState, pause, resume, next, previous, volumeUp, volumeDown, volumeFineUp, volumeFineDown, toggleShuffle, toggleRepeat, } = usePlayer();
+    const [flashState, setFlashState] = useState({});
+    const flash = (key) => {
+        setFlashState(prev => ({ ...prev, [key]: true }));
+        setTimeout(() => {
+            setFlashState(prev => ({ ...prev, [key]: false }));
+        }, FLASH_DURATION_MS);
+    };
+    const shortcutColor = (key) => flashState[key] ? theme.colors.success : theme.colors.text;
     // Register key bindings globally
     const handlePlayPause = () => {
+        flash('playPause');
         if (playerState.isPlaying) {
             pause();
         }
@@ -19,16 +30,51 @@ export default function ShortcutsBar() {
         }
     };
     useKeyBinding(KEYBINDINGS.PLAY_PAUSE, handlePlayPause);
-    useKeyBinding(KEYBINDINGS.NEXT, next);
-    useKeyBinding(KEYBINDINGS.PREVIOUS, previous);
-    useKeyBinding(KEYBINDINGS.VOLUME_UP, volumeUp);
-    useKeyBinding(KEYBINDINGS.VOLUME_DOWN, volumeDown);
-    useKeyBinding(KEYBINDINGS.VOLUME_FINE_UP, volumeFineUp);
-    useKeyBinding(KEYBINDINGS.VOLUME_FINE_DOWN, volumeFineDown);
-    useKeyBinding(KEYBINDINGS.SHUFFLE, toggleShuffle);
-    useKeyBinding(KEYBINDINGS.REPEAT, toggleRepeat);
+    useKeyBinding(KEYBINDINGS.NEXT, () => {
+        flash('next');
+        next();
+    });
+    useKeyBinding(KEYBINDINGS.PREVIOUS, () => {
+        flash('prev');
+        previous();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_UP, () => {
+        flash('volume');
+        volumeUp();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_DOWN, () => {
+        flash('volume');
+        volumeDown();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_FINE_UP, () => {
+        flash('volume');
+        volumeFineUp();
+    });
+    useKeyBinding(KEYBINDINGS.VOLUME_FINE_DOWN, () => {
+        flash('volume');
+        volumeFineDown();
+    });
+    useKeyBinding(KEYBINDINGS.SHUFFLE, () => {
+        flash('shuffle');
+        toggleShuffle();
+    });
+    useKeyBinding(KEYBINDINGS.REPEAT, () => {
+        flash('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: [_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' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
+    const shuffleColor = flashState['shuffle']
+        ? theme.colors.success
+        : playerState.shuffle
+            ? theme.colors.primary
+            : theme.colors.dim;
+    const repeatColor = flashState['repeat']
+        ? theme.colors.success
+        : playerState.repeat !== 'off'
+            ? theme.colors.secondary
+            : theme.colors.dim;
+    const volumeColor = flashState['volume']
+        ? theme.colors.success
+        : theme.colors.primary;
+    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: shortcutColor('playPause'), children: [playerState.isPlaying ? ICONS.PAUSE : ICONS.PLAY_PAUSE_ON, " [Space]"] }), ' ', "| ", _jsxs(Text, { color: shortcutColor('prev'), children: [ICONS.PREV, " [B/\u2190]"] }), " |", ' ', _jsxs(Text, { color: shortcutColor('next'), children: [ICONS.NEXT, " [N/\u2192]"] }), " |", ' ', _jsxs(Text, { color: shuffleColor, children: [ICONS.SHUFFLE, " [Shift+S]"] }), " |", ' ', _jsxs(Text, { color: repeatColor, children: [playerState.repeat === 'one' ? ICONS.REPEAT_ONE : 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: shuffleColor, children: ICONS.SHUFFLE }), ' ', _jsx(Text, { color: repeatColor, children: playerState.repeat === 'one' ? ICONS.REPEAT_ONE : ICONS.REPEAT_ALL }), ' ', _jsxs(Text, { color: theme.colors.dim, children: [ICONS.VOLUME, " [+/-]"] }), ' ', _jsxs(Text, { color: volumeColor, children: [playerState.volume, "%"] })] })] }));
 }

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/player/player.service.js

@@ -218,6 +218,7 @@ class PlayerService {
             case 'eof-reached':
                 event.eof = message.data;
                 if (event.eof) {
+                    this.isPlaying = false;
                     logger.info('PlayerService', 'End of file reached');
                 }
                 break;

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

@@ -23,6 +23,7 @@ class WebServerManager {
         shuffle: false,
         isLoading: false,
         error: null,
+        playRequestId: 0,
     };
     constructor() {
         // Load config or use defaults

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

@@ -23,6 +23,7 @@ const initialState = {
     shuffle: false,
     isLoading: false,
     error: null,
+    playRequestId: 0,
 };
 // Get player service instance
 const playerService = getPlayerService();
@@ -35,6 +36,7 @@ export function playerReducer(state, action) {
                 isPlaying: true,
                 progress: 0,
                 error: null,
+                playRequestId: state.playRequestId + 1,
             };
         case 'PAUSE':
             return { ...state, isPlaying: false };
@@ -62,6 +64,7 @@ export function playerReducer(state, action) {
                     currentTrack: state.queue[randomIndex] ?? null,
                     isPlaying: true,
                     progress: 0,
+                    playRequestId: state.playRequestId + 1,
                 };
             }
             // Sequential mode
@@ -74,6 +77,7 @@ export function playerReducer(state, action) {
                         currentTrack: state.queue[0] ?? null,
                         isPlaying: true,
                         progress: 0,
+                        playRequestId: state.playRequestId + 1,
                     };
                 }
                 return state;
@@ -84,6 +88,7 @@ export function playerReducer(state, action) {
                 currentTrack: state.queue[nextPosition] ?? null,
                 isPlaying: true,
                 progress: 0,
+                playRequestId: state.playRequestId + 1,
             };
         }
         case 'PREVIOUS':
@@ -95,6 +100,7 @@ export function playerReducer(state, action) {
                 return {
                     ...state,
                     progress: 0,
+                    playRequestId: state.playRequestId + 1,
                 };
             }
             return {
@@ -102,6 +108,7 @@ export function playerReducer(state, action) {
                 queuePosition: prevPosition,
                 currentTrack: state.queue[prevPosition] ?? null,
                 progress: 0,
+                playRequestId: state.playRequestId + 1,
             };
         case 'SEEK':
             return {
@@ -174,6 +181,7 @@ export function playerReducer(state, action) {
                     queuePosition: action.position,
                     currentTrack: state.queue[action.position] ?? null,
                     progress: 0,
+                    playRequestId: state.playRequestId + 1,
                 };
             }
             return state;
@@ -207,6 +215,7 @@ export function playerReducer(state, action) {
                 hasTrack: !!action.currentTrack,
                 queueLength: action.queue.length,
             });
+            playerService.setVolume(action.volume);
             return {
                 ...state,
                 currentTrack: action.currentTrack,
@@ -292,6 +301,7 @@ function PlayerManager() {
         };
     }, [dispatch, playerService]);
     // Handle track changes
+    const lastPlayedRequestId = useRef(-1);
     useEffect(() => {
         const track = state.currentTrack;
         if (!track) {
@@ -306,14 +316,17 @@ function PlayerManager() {
             });
             return;
         }
-        // Guard: Only play if track actually changed
+        // Guard: Don't replay same track unless a new play request was explicitly dispatched
         const currentTrackId = playerService.getCurrentTrackId?.() || '';
-        if (currentTrackId === track.videoId) {
+        const isSameTrack = currentTrackId === track.videoId;
+        const isNewPlayRequest = state.playRequestId !== lastPlayedRequestId.current;
+        if (isSameTrack && !isNewPlayRequest) {
             logger.debug('PlayerManager', 'Track already playing, skipping', {
                 videoId: track.videoId,
             });
             return;
         }
+        lastPlayedRequestId.current = state.playRequestId;
         logger.info('PlayerManager', 'Loading track', {
             title: track.title,
             videoId: track.videoId,
@@ -424,7 +437,13 @@ function PlayerManager() {
         void loadAndPlayTrack();
         // Note: state.volume intentionally excluded - volume changes should not restart playback
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [state.currentTrack, state.isPlaying, dispatch, musicService]);
+    }, [
+        state.currentTrack,
+        state.isPlaying,
+        state.playRequestId,
+        dispatch,
+        musicService,
+    ]);
     // Handle progress tracking
     useEffect(() => {
         if (state.isPlaying && state.currentTrack) {

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

@@ -13,5 +13,6 @@ export interface PlayerState {
     shuffle: boolean;
     isLoading: boolean;
     error: string | null;
+    playRequestId: number;
 }
 export type PlayerAction = PlayAction | PauseAction | ResumeAction | StopAction | NextAction | PreviousAction | SeekAction | SetVolumeAction | VolumeUpAction | VolumeDownAction | VolumeFineUpAction | VolumeFineDownAction | ToggleShuffleAction | ToggleRepeatAction | SetQueueAction | AddToQueueAction | RemoveFromQueueAction | ClearQueueAction | SetQueuePositionAction | UpdateProgressAction | SetDurationAction | TickAction | SetLoadingAction | SetErrorAction | RestoreStateAction | SetSpeedAction;

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.38",
+	"version": "0.0.44",
 	"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",