# YouTube Music Desktop: A native desktop app for YouTube Music

> YouTube Music Desktop is a desktop application that wraps YouTube Music in a native window. It provides keyboard shortcuts, media controls, and system notifications for YouTube Music on Windows, macOS, and Linux.

**ytmdesktop/ytmdesktop** — A Desktop App for YouTube Music

- Repository: https://github.com/ytmdesktop/ytmdesktop
- Website: https://ytmdesktop.github.io/
- Stars: 6,559 · Forks: 626
- Language: TypeScript
- License: GPL-3.0
- Published: 2026-09-22 · Updated: 2026-09-22 · Language: en
- Canonical page: https://hysenlabs.com/projects/ytmdesktop-ytmdesktop

## An Electron wrapper around the YouTube Music web interface

YouTube Music Desktop is a native desktop application built on Electron that runs the YouTube Music web interface in its own window. Instead of using YouTube Music in a browser tab, you launch it as a standalone app with native integration for your operating system. The application is written in TypeScript and uses Vue 3 for the interface. This Electron-based approach gives you the same music library and playlists as the web player, but with keyboard shortcuts, system notifications, and media player controls that integrate with your desktop environment. You can control playback without switching to a browser tab or window and receive notifications when songs change. The app is lightweight compared to running YouTube Music in a full browser instance, since Electron bundles only Chromium and the Node.js runtime. The project is community-maintained and not an official Google product, published under the GPL-3.0 license. The latest release is version 2.0.12, published on 2026-09-08. The development branch receives regular updates; the last push was on 2026-09-13. The project lists numerous community contributors throughout its history.

## Keyboard shortcuts and system integration

YouTube Music Desktop provides keyboard shortcuts for common playback actions like play, pause, next, and previous. System media keys work natively without configuration: buttons on keyboards and headphones control the app even when the window is not focused or minimized. The app shows the current song in a system notification, so you know what is playing without bringing the window to focus. System tray integration appears on Windows and macOS, allowing you to control playback from the menu bar or system tray. On macOS, the app adds controls to the menu bar. On Windows, similar controls appear in the taskbar system tray. These notifications use your operating system's native notification system, so they respect your global notification settings.

## Installing on Windows, macOS and Linux

Download YouTube Music Desktop from the GitHub repository releases page. For Windows, use Winget, the system package manager:

```bash
winget install "YouTube Music Desktop App"
```

or

```bash
winget install Ytmdesktop.Ytmdesktop
```

The Scoop package manager is another option; add the extras bucket first:

```bash
scoop bucket add extras
scoop install ytmdesktop
```

Direct binaries are available from the releases page. For macOS, use Homebrew to install from the cask:

```bash
brew install --cask ytmdesktop-youtube-music
```

DMG images are also available on the releases page. For Linux, the Arch Linux User Repository (AUR) provides the ytmdesktop package. Debian-based systems can install DEB packages or AppImage binaries. The project builds on Node.js v20 and Electron version 44.3.0, using TypeScript and Vue 3.

After installation, launch the app and log in with your Google account. Your YouTube Music library, playlists, and listening history load automatically from your Google account. The app runs independently and does not require any web browser to be open. The system tray integration on macOS and Windows allows playback control without bringing the window to focus.

## Breaking changes when YouTube Music updates

YouTube Music Desktop wraps the YouTube Music web interface, so the app is tightly coupled to YouTube's frontend. When YouTube rolls out interface changes or modifies the underlying HTML structure, the app may break until a new version is released. This happened during the shift from the old YouTube Music interface to the current version; the developer notes that v2 is a complete rewrite with a fresh codebase to handle ongoing compatibility challenges. As a community-maintained project under GPL-3.0 license, fixes depend on maintainer availability and community contributions. The project accepts pull requests from developers who can fix issues or add features. You still need an internet connection and a Google account to use the app; it is not a standalone music player. Your music catalog and subscription status are determined by your Google account. Authentication flows through your existing YouTube Music login, and the app does not store private credentials, making it safer than downloading or caching alternatives.

## Building from source

To compile YouTube Music Desktop for your platform, clone the repository from GitHub, install Node.js v20, and run the build tool. The README specifies that the project uses Yarn for dependency management. You can enable Yarn using corepack if it is not already installed. Run yarn install to fetch dependencies, then yarn make to build the installer for your platform. On Linux, building Debian packages requires fakeroot and dpkg; building RPM packages requires rpm or rpm-build. The default configuration builds both DEB and RPM packages when you run make on Linux. On Windows, install the full build tools suite recommended by Electron, which includes Visual Studio Build Tools, Python, and other prerequisites. Start with npm i -g @electron/build-tools, which downloads and installs the necessary tools automatically. macOS building is documented in the repository configuration. The entire build process uses electron-forge, which handles creating platform-specific installers and distributable binaries for each operating system.

## YouTube Music Desktop versus the web player

The main alternative is using YouTube Music in your web browser. The web player works without installing anything new; you simply visit music.youtube.com in Firefox, Chrome, Safari or any browser. The web player offers the full feature set and updates instantly when YouTube rolls out changes. However, it runs inside a browser tab, which means you must switch focus or tabs to control playback, and keyboard shortcuts do not work the same way. The browser version lacks native system integration: no menu bar controls on macOS, no system tray on Windows, and no media key support by default. If you have many browser tabs open, the web player consumes additional memory and CPU. YouTube Music Desktop avoids tab switching and provides dedicated system controls, but it depends on community maintenance and breaks when YouTube's interface changes significantly.

## Who should use YouTube Music Desktop

Use YouTube Music Desktop if you already subscribe to YouTube Music and want keyboard shortcuts and media controls without switching browser windows. It suits people who listen to music while working and need quick playback control. The native notification support is valuable if you work with the app minimized and want to see song changes without clicking. The cross-platform support means you get the same experience on Windows, macOS, and Linux with the same shortcuts. Do not use it if you do not use YouTube Music, prefer the web browser interface, need offline playback, or run into compatibility issues after YouTube updates. Building from source on Windows requires Python and Visual Studio build tools, which adds setup friction compared to downloading a prebuilt binary. Before adopting, check that the latest release works with your YouTube Music account on your operating system.

## Conclusion

Use YouTube Music Desktop if you already subscribe to YouTube Music and want keyboard shortcuts and media controls without switching browser windows. The app excels for workers who need quick playback control while keeping YouTube Music separate from their browser. Do not use it if you need offline playback or your system lacks Python and build tools for compiling platform-specific installers. Before adopting, verify that the latest version still works with your YouTube Music account, since updates to YouTube Music occasionally break compatibility and fix cycles depend on maintainer availability.

## FAQ

### Is ytmdesktop safe to use?

Yes. The app uses your existing YouTube Music login through the standard web interface and does not store private credentials. It does not require additional permissions beyond what the YouTube Music web app requires.

### How do I install ytmdesktop?

On Windows, use winget install "YouTube Music Desktop App" or install via Scoop or direct binaries. On macOS, use brew install --cask ytmdesktop-youtube-music. On Linux, use the AUR package or download DEB or AppImage binaries from the releases page.

### Is ytmdesktop ad free?

The app inherits YouTube Music's ad policy from your account. Free accounts show ads between songs; Premium accounts play ad-free. YouTube Music ads cannot be disabled by third-party tools.

### What is the difference between ytmdesktop and YouTube Music in the browser?

ytmdesktop runs the YouTube Music web interface in a native window with system integration: keyboard shortcuts, system notifications, and media controls work without switching focus or minimizing windows. The browser version requires switching tabs or windows.

## Sources

- [License: GPL-3.0](https://github.com/ytmdesktop/ytmdesktop/blob/development/LICENSE)
- [Project website](https://ytmdesktop.github.io/)
- [README](https://github.com/ytmdesktop/ytmdesktop/blob/development/README.md)
- [Releases](https://github.com/ytmdesktop/ytmdesktop/releases)
- [ytmdesktop/ytmdesktop on GitHub](https://github.com/ytmdesktop/ytmdesktop)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/ytmdesktop-ytmdesktop