@involvex/youtube-music-cli 0.0.24 → 0.0.25

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.0.25](https://github.com/involvex/youtube-music-cli/compare/v0.0.24...v0.0.25) (2026-02-20)
+
+### Features
+
+- add Shift+Q/R shortcuts and improve help view navigation ([0d68ad0](https://github.com/involvex/youtube-music-cli/commit/0d68ad0f6aa2e379b164a4b35a452a592e2ae421))
+
 ## [0.0.24](https://github.com/involvex/youtube-music-cli/compare/v0.0.23...v0.0.24) (2026-02-20)
 
 ### Features

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

@@ -3,8 +3,16 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { useTheme } from "../../hooks/useTheme.js";
 import { useNavigation } from "../../hooks/useNavigation.js";
+import { useKeyBinding } from "../../hooks/useKeyboard.js";
+import { KEYBINDINGS } from "../../utils/constants.js";
+import { useCallback } from 'react';
 export default function Help() {
     const { theme } = useTheme();
-    const { dispatch: _dispatch } = useNavigation();
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, padding: 1, children: [_jsx(Box, { borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Keyboard Shortcuts" }) }), _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Global" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "q" }), " - Quit", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "?" }), " - Help", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "/" }), " - Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+P" }), " - Playlists", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "p" }), " - Plugins", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "g" }), " - Suggestions", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "," }), " - Settings"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Player" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Space" }), " - Play/Pause", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "n" }), " - Next", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "b" }), " - Previous", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "=" }), " - Volume Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "-" }), " - Volume Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+S" }), " - Toggle Shuffle", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "r" }), " - Toggle Repeat"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Navigation" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Up" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "k" }), " - Move Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Down" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "j" }), " - Move Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Enter" }), " - Select", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Go Back"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Search" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Tab" }), " - Switch Search Type", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "m" }), " - Create Mix Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " - Download selection", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Clear Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "[ / ]" }), " - Results Limit"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Playlist" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "a" }), " - Add to Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "d" }), " - Remove from Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "c" }), " - Create Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " - Download Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "D" }), " - Delete Playlist"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "View" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "M" }), " - Toggle Mini Player", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "l" }), " - Lyrics", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "T" }), " - Trending", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "e" }), " - Explore"] }) }), _jsxs(Text, { color: theme.colors.dim, children: ["Press ", _jsx(Text, { color: theme.colors.text, children: "Esc" }), " or", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), " to close"] })] })] }));
+    const { dispatch } = useNavigation();
+    const closeHelp = useCallback(() => {
+        dispatch({ category: 'GO_BACK' });
+    }, [dispatch]);
+    useKeyBinding(KEYBINDINGS.BACK, closeHelp);
+    useKeyBinding(KEYBINDINGS.SELECT, closeHelp);
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, padding: 1, children: [_jsx(Box, { borderStyle: "single", borderColor: theme.colors.secondary, paddingX: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Keyboard Shortcuts" }) }), _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Text, { bold: true, color: theme.colors.secondary, children: "Global" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "q" }), " - Quit", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "?" }), " - Help", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "/" }), " - Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+P" }), " - Playlists", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "p" }), " - Plugins", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "g" }), " - Suggestions", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "," }), " - Settings", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+Q" }), " - Background Play", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+R" }), " - Resume Control"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Player" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Space" }), " - Play/Pause", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "n" }), " - Next", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "b" }), " - Previous", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "=" }), " - Volume Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "-" }), " - Volume Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+S" }), " - Toggle Shuffle", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "r" }), " - Toggle Repeat"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Navigation" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Up" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "k" }), " - Move Up", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Down" }), " /", _jsx(Text, { children: " " }), _jsx(Text, { color: theme.colors.text, children: "j" }), " - Move Down", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Enter" }), " - Select", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Go Back"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Search" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "Tab" }), " - Switch Search Type", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "m" }), " - Create Mix Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " - Download selection", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Esc" }), " - Clear Search", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "[ / ]" }), " - Results Limit"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "Playlist" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "a" }), " - Add to Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "d" }), " - Remove from Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "c" }), " - Create Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "Shift+D" }), " - Download Playlist", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "D" }), " - Delete Playlist"] }) }), _jsx(Text, { bold: true, color: theme.colors.secondary, children: "View" }), _jsx(Box, { paddingX: 2, children: _jsxs(Text, { children: [_jsx(Text, { color: theme.colors.text, children: "M" }), " - Toggle Mini Player", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "l" }), " - Lyrics", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "T" }), " - Trending", _jsx(Text, { children: " | " }), _jsx(Text, { color: theme.colors.text, children: "e" }), " - Explore"] }) }), _jsxs(Text, { color: theme.colors.dim, children: ["Press ", _jsx(Text, { color: theme.colors.text, children: "Esc" }), ",", ' ', _jsx(Text, { color: theme.colors.text, children: "Enter" }), ",", ' ', _jsx(Text, { color: theme.colors.text, children: "q" }), ", or", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), " to close"] })] })] }));
 }

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

@@ -27,7 +27,7 @@ export default function ShortcutsBar() {
     useKeyBinding(KEYBINDINGS.SHUFFLE, toggleShuffle);
     useKeyBinding(KEYBINDINGS.REPEAT, toggleRepeat);
     // Note: SETTINGS keybinding handled by MainLayout to avoid double-dispatch
-    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsx(Text, { color: theme.colors.text, children: "\u2420" }), playerState.isPlaying ? '⏸️' : '▶️', " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2190" }), "\u23EA\uFE0F |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2192" }), "\u23ED\uFE0F |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u21E7S" }), "\uD83D\uDD00 |", ' ', _jsx(Text, { color: theme.colors.text, children: "R" }), "\uD83D\uDD04 |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u21E7P" }), "\uD83D\uDCDA |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u21E7D" }), "\u2B07 |", ' ', _jsx(Text, { color: theme.colors.text, children: "m" }), "\uD83C\uDFB6 |", ' ', _jsx(Text, { color: theme.colors.text, children: "/" }), "\uD83D\uDD0E |", ' ', _jsx(Text, { color: theme.colors.text, children: "?" }), "\u2753 |", ' ', _jsx(Text, { color: theme.colors.text, children: "Q" }), "\u23FB"] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: playerState.shuffle ? theme.colors.primary : theme.colors.dim, children: "\uD83D\uDD00" }), ' ', _jsx(Text, { color: playerState.repeat === 'off'
+    return (_jsxs(Box, { borderStyle: "single", borderColor: theme.colors.dim, paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.colors.dim, children: [_jsx(Text, { color: theme.colors.text, children: "\u23EF [Space]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u23EE [B/\u2190]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u23ED [N/\u2192]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD00 [Shift+S]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD01 [R]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDCDA [Shift+P]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2B07 [Shift+D]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD0E [/]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u2753 [?]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDEF0 [Shift+Q]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\uD83D\uDD0C [Shift+R]" }), " |", ' ', _jsx(Text, { color: theme.colors.text, children: "\u23FB [Q]" })] }), _jsxs(Text, { color: theme.colors.text, children: [_jsx(Text, { color: playerState.shuffle ? theme.colors.primary : theme.colors.dim, children: "\uD83D\uDD00" }), ' ', _jsx(Text, { color: playerState.repeat === 'off'
                             ? theme.colors.dim
-                            : theme.colors.secondary, children: playerState.repeat === 'one' ? '🔂' : '🔄' }), ' ', _jsx(Text, { color: theme.colors.dim, children: "\uD83D\uDD0A [=/" }), "-", _jsx(Text, { color: theme.colors.dim, children: "]" }), ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
+                            : theme.colors.secondary, children: playerState.repeat === 'one' ? '🔂' : '🔄' }), ' ', _jsx(Text, { color: theme.colors.dim, children: "\uD83D\uDD0A [=/-]" }), ' ', _jsxs(Text, { color: theme.colors.primary, children: [playerState.volume, "%"] })] })] }));
 }

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

@@ -27,9 +27,11 @@ import { Box } from 'ink';
 import { useTerminalSize } from "../../hooks/useTerminalSize.js";
 import { getPlayerService } from "../../services/player/player.service.js";
 import { getConfigService } from "../../services/config/config.service.js";
+import { usePlayer } from "../../hooks/usePlayer.js";
 function MainLayout() {
     const { theme } = useTheme();
     const { state: navState, dispatch } = useNavigation();
+    const { resume } = usePlayer();
     const { columns } = useTerminalSize();
     // Responsive padding based on terminal size
     const getPadding = () => (columns < 100 ? 0 : 1);
@@ -50,8 +52,12 @@ function MainLayout() {
         dispatch({ category: 'NAVIGATE', view: VIEW.SETTINGS });
     }, [dispatch]);
     const goToHelp = useCallback(() => {
+        if (navState.currentView === VIEW.HELP) {
+            dispatch({ category: 'GO_BACK' });
+            return;
+        }
         dispatch({ category: 'NAVIGATE', view: VIEW.HELP });
-    }, [dispatch]);
+    }, [dispatch, navState.currentView]);
     const handleQuit = useCallback(() => {
         // From player view, quit the app
         if (navState.currentView === VIEW.PLAYER) {
@@ -91,6 +97,23 @@ function MainLayout() {
         // Exit the app
         process.exit(0);
     }, []);
+    const handleResumeBackground = useCallback(() => {
+        const player = getPlayerService();
+        const config = getConfigService();
+        const backgroundState = config.getBackgroundPlaybackState();
+        if (!backgroundState.enabled || !backgroundState.ipcPath) {
+            return;
+        }
+        void player
+            .reattach(backgroundState.ipcPath)
+            .then(() => {
+            resume();
+            config.clearBackgroundPlaybackState();
+        })
+            .catch(() => {
+            config.clearBackgroundPlaybackState();
+        });
+    }, [resume]);
     const togglePlayerMode = useCallback(() => {
         dispatch({ category: 'TOGGLE_PLAYER_MODE' });
     }, [dispatch]);
@@ -108,6 +131,7 @@ function MainLayout() {
     useKeyBinding(['e'], goToExplore);
     useKeyBinding(['i'], goToImport);
     useKeyBinding(KEYBINDINGS.DETACH, handleDetach);
+    useKeyBinding(KEYBINDINGS.RESUME_BACKGROUND, handleResumeBackground);
     // Memoize the view component to prevent unnecessary remounts
     // Only recreate when currentView actually changes
     const currentView = useMemo(() => {

package/dist/source/main.js

@@ -15,7 +15,6 @@ import { usePlayer } from "./hooks/usePlayer.js";
 import { useYouTubeMusic } from "./hooks/useYouTubeMusic.js";
 import { VIEW } from "./utils/constants.js";
 import { getConfigService } from "./services/config/config.service.js";
-import { getPlayerService } from "./services/player/player.service.js";
 import { getNotificationService } from "./services/notification/notification.service.js";
 function Initializer({ flags }) {
     const { dispatch } = useNavigation();
@@ -24,20 +23,12 @@ function Initializer({ flags }) {
     useEffect(() => {
         // Check for background playback state on startup
         const config = getConfigService();
-        const player = getPlayerService();
         const backgroundState = config.getBackgroundPlaybackState();
         if (backgroundState.enabled) {
             // Show notification about background playback
             const notification = getNotificationService();
             notification.setEnabled(true);
-            void notification.notify('Background Playback Active', 'Press R to resume control');
-            // Try to reattach to the existing mpv process
-            if (backgroundState.ipcPath) {
-                void player.reattach(backgroundState.ipcPath).catch(() => {
-                    // Reattach failed, clear the state
-                    config.clearBackgroundPlaybackState();
-                });
-            }
+            void notification.notify('Background Playback Active', 'Press Shift+R to resume control');
         }
         if (flags?.showSuggestions) {
             dispatch({ category: 'NAVIGATE', view: VIEW.SUGGESTIONS });

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

@@ -235,7 +235,11 @@ class PlayerService {
                 mpvArgs.push(playUrl);
                 // Capture process in local var so stale exit handlers from a killed
                 // process don't overwrite state belonging to a newly-spawned process.
-                const spawnedProcess = spawn(this.getMpvCommand(), mpvArgs);
+                const spawnedProcess = spawn(this.getMpvCommand(), mpvArgs, {
+                    detached: true,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                    windowsHide: true,
+                });
                 this.mpvProcess = spawnedProcess;
                 if (!spawnedProcess.stdout || !spawnedProcess.stderr) {
                     throw new Error('Failed to create mpv process streams');
@@ -373,6 +377,10 @@ class PlayerService {
             ipcPath: this.ipcPath,
             currentUrl: this.currentUrl,
         };
+        if (this.mpvProcess) {
+            // Allow detached mpv process to survive after CLI exits.
+            this.mpvProcess.unref();
+        }
         // Clear references but DON'T kill mpv process - it keeps playing
         this.mpvProcess = null;
         this.ipcSocket = null;

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

@@ -37,6 +37,7 @@ export declare const KEYBINDINGS: {
     readonly SETTINGS: readonly [","];
     readonly PLUGINS: readonly ["p"];
     readonly DETACH: readonly ["shift+q"];
+    readonly RESUME_BACKGROUND: readonly ["shift+r"];
     readonly PLAY_PAUSE: readonly [" "];
     readonly NEXT: readonly ["n", "right"];
     readonly PREVIOUS: readonly ["b", "left"];

package/dist/source/utils/constants.js

@@ -45,6 +45,7 @@ export const KEYBINDINGS = {
     SETTINGS: [','],
     PLUGINS: ['p'],
     DETACH: ['shift+q'],
+    RESUME_BACKGROUND: ['shift+r'],
     // Player
     PLAY_PAUSE: [' '],
     NEXT: ['n', 'right'],

package/package.json

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

package/readme.md

@@ -105,7 +105,7 @@ brew install involvex/youtube-music-cli/youtube-music-cli
 winget install Involvex.YoutubeMusicCLI
 ```
 
-> Maintainers: tag pushes trigger `.github/workflows/homebrew-publish.yml` and `.github/workflows/winget-publish.yml`. Homebrew uses the tap format `involvex/youtube-music-cli/youtube-music-cli`, so ensure the formula file exists on the default branch at `Formula/youtube-music-cli.rb` for the tap installation to work. Set `WINGETCREATE_TOKEN` and make sure `Involvex.YoutubeMusicCLI` exists in winget-pkgs for automated updates.
+> Maintainers: tag pushes trigger `.github/workflows/homebrew-publish.yml` and `.github/workflows/winget-publish.yml`. Homebrew uses the tap format `involvex/youtube-music-cli/youtube-music-cli`, so ensure the formula file exists on the default branch at `Formula/youtube-music-cli.rb` for the tap installation to work. Winget needs `WINGETCREATE_TOKEN` (GitHub PAT with `public_repo`) and a one-time initial submission to winget-pkgs before automated updates can run.
 
 ### From Source