自行构建需先装 Git 与 Node.js v20,并用 corepack enable 启用 Yarn;Windows 打包需额外安装 @electron/build-tools 及 Visual Studio、Python 等工具链;Linux 打包需按发行版安装 fakeroot/dpkg 或 rpm/rpm-build。

ytmdesktop
ytmdesktopGPL-3.0活跃维护把 YouTube Music 封装成桌面客户端,支持全局媒体快捷键、Discord 状态显示和 Last.fm 记录播放,弥补网页版缺少的系统集成。
A Desktop App for YouTube Music
winget install "YouTube Music Desktop App"README 未说明硬件要求;作为 Electron 桌面应用,需能运行图形界面的 Windows、Linux 或 macOS 环境。
把 YouTube Music 装进桌面窗口的 Electron 客户端,免开浏览器听歌
把 YouTube Music 封装成桌面客户端,支持全局媒体快捷键、Discord 状态显示和 Last.fm 记录播放,弥补网页版缺少的系统集成。
核心能力
- 基于 Electron 的桌面客户端,封装 YouTube Music 网页播放
- 提供 Windows、Linux、macOS 三平台安装包与包管理器分发
- 支持 Winget、Scoop、Brew、AUR 等渠道一键安装
- 代码库已重写为全新 v2 架构
容易踩的坑
- v2.1.0最新正式版2026-10-29 · 2026-10-29 00:33 UTC
What's Changed
This is a big one and a lot of things have changed but most will not be user facing. This release changes a lot of the internals of the application which will help us maintain things better, faster, and hopefully provide more features quicker over time. Many features have been rewritten because of this change and may provide a better user experience.
With that said this release does contain a lot of new features and other changes.
Features
- Timed lyrics when available for the current video. We source this from YTM directly and replace the lyrics tab
- Experimental enhanced media service (default enabled with this release) powered by Xosms. If you encounter issues you can disable it under Integrations -> Enhanced media service
- On Windows this allows us to provide more information and functionality if you use a third party flyout program such as Fluent Flyouts.
- On Linux this allows us to provide our own MPRIS based service (org.mpris.MediaPlayer2.ytmdesktop). Enhanced functionality is provided such as scroll to adjust player volume, shuffle, and repeat actions.
- macOS support exists but is far more experimental and not as thoroughly tested.
- Miniplayer that can be opened from the top when you don't want a large YTM window taking up your space and something you can pin on top to control the player.
- Note: If you are on linux using wayland you will need to use your native window manager to pin the miniplayer always on top.
- More shortcuts for managing the player.
- Note: If you are on linux using wayland this feature will not likely work correctly for now.
- More context menu actions for ease of use
- Opening the context menu on an image allows opening it in your browser
- Opening the context menu on a text box will provide undo, redo, copy, cut, paste, and select all actions.
Developer Features
- Companion Server
shuffleEnabledstate is now provided.- Queue modification commands are now provided allowing you to arbitrarily add videos or playlists via id to the queue in any position. You can also remove or move videos around in the queue.
- When the user is offline (no internet) thumbnails for the current song may be provided as a base64 data url containing the image instead of a link to the thumbnail.
- mDNS broadcasting provided for the companion server under the name
_ytmdesktop._tcp. If you are making a third party application such as a mobile app to control YTMDesktop you can use mDNS to find the player instead of scanning IPs or asking the user for an IP.
- Read-only IPC server that allows receiving the player's current state in real-time without using socket.io.
- All new features and how to use the Companion Server API are documented at https://ytmdesktop.github.io/developer/
Fixed
- Changes to YTM preventing the app from loading. This will also no longer happen and the app will continue to allow you to use YTM even if our hooks fail. The app will run in a degraded state with some features unavailable or not functional. Please open an issue on the GitHub if you encounter this popup as it should never happen and indicates changes that need to be made.
- For more fixes view the full changelog
Miscellaneous
- Changelog window popup when the app updates containing the latest release notes
- Changes which comply with electron's security recommendations
- View the full changelog
Known Issues
- Check for updates in About is non-functional. This was missed bef
- Timed lyrics when available for the current video. We source this from YTM directly and replace the lyrics tab
- v2.0.122026-09-08 · 2026-09-08 22:51 UTC
查看更新说明
What's Changed
General improvements and fixes to the app
Fixed
- Fix for changes to YouTube Music preventing the app from loading
- Fixes for
Continue where you left offwhen a now unavailable video is loaded.- Note: If you are signed into a Google account for YTM you should not need this feature anymore as Google will save your last video and across mobile devices.
Miscellaneous
- Upgrade dependencies
Full Changelog: https://github.com/ytmdesktop/ytmdesktop/compare/v2.0.11...v2.0.12
CHECKSUMS.sha256.ascsigned with https://github.com/NovusTheory.gpg - Fix for changes to YouTube Music preventing the app from loading
- v2.0.112026-02-12 · 2026-02-12 16:45 UTC
查看更新说明
What's Changed
General improvements and fixes to the app
Fixed
- Fix for changes to YouTube Music preventing the app from loading
- Potential fix for a crash related to #1588.
- Fix extra library button added to the player bar.
- The icons for this might not match what YTM normally does and look off but YTM doesn't provide a new icon to represent being added to your library
Features
- Updates Discord rich presence to match closer to Spotify.
- Title, Artist and Album are now links to their respective pages.
- Artist will now show in the side menu instead of YouTube Music
Miscellaneous
- Upgrade dependencies
Full Changelog: https://github.com/ytmdesktop/ytmdesktop/compare/v2.0.10...v2.0.11
CHECKSUMS.sha256.ascsigned with https://github.com/NovusTheory.gpg - Fix for changes to YouTube Music preventing the app from loading
- v2.0.102025-09-04 · 2025-09-04 21:29 UTC
查看更新说明
What's Changed
General improvements and fixes to the app
Fixed
- Fix for changes to YouTube Music preventing the app from loading
- Sleep timer icon missing
Miscellaneous
- Upgrade dependencies
Full Changelog: https://github.com/ytmdesktop/ytmdesktop/compare/v2.0.9...v2.0.10
CHECKSUMS.sha256.ascsigned with https://github.com/NovusTheory.gpg - v2.0.92025-06-05 · 2025-06-05 19:53 UTC
查看更新说明
What's Changed
General improvements and fixes to the app
Fixed
- Fix for changes to YouTube Music preventing the app from loading
- YouTube Music changed components that we utilized in this app to provide a more native experience
Miscellaneous
- Upgrade dependencies
Full Changelog: https://github.com/ytmdesktop/ytmdesktop/compare/v2.0.8...v2.0.9
CHECKSUMS.sha256.ascsigned with https://github.com/NovusTheory.gpg - Fix for changes to YouTube Music preventing the app from loading
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
YouTube Music Desktop App
Now with a Fresh new Codebase 😉

⬇️ Download at
Windows
- Winget:
winget install "YouTube Music Desktop App"orwinget install Ytmdesktop.Ytmdesktop - Scoop:
scoop bucket add extrasthenscoop install ytmdesktop(Community Maintained) - Binaries: https://github.com/ytmdesktop/ytmdesktop/releases
Linux
- Arch Linux (AUR): https://aur.archlinux.org/packages/ytmdesktop (Community Maintained)
- Binaries: https://github.com/ytmdesktop/ytmdesktop/releases
Mac
- Brew:
brew install --cask ytmdesktop-youtube-music(Community Maintained) - Binaries: https://github.com/ytmdesktop/ytmdesktop/releases
Developing
To clone and run this repository you'll need Git and Node.js (v20) (which comes with npm) installed on your computer. From your command line:
# Clone this repository
git clone https://github.com/ytmdesktop/ytmdesktop.git
# Go into the directory
cd ytmdesktop
And:
# If you do not have Yarn Installed / New to Node as a whole you can enable Yarn with:
corepack enable
# Install dependencies
yarn install
# Run the app
yarn start
Building the Project
To build for your platform you need to run yarn make, however please see the information below regarding the required additionally Software, Tools and Packages which are needed to successfully package into a nice installer file.
Windows
To download the full suite of Tools/Software needed to build the app it is recommended to install the suite of build tools that electron provide which includes Visual Studio, Python and other tools.
npm i -g @electron/build-tools
This will start downloading and installing, and may require a few prompts here and there to finalise everything.
Linux
Building the project on Linux only requires you to install:
- For building on Debian based Linux Distros like Ubuntu, you will need to install
fakerootanddpkg - For building on RedHat based Linux Distros like Fedora, you will need to install
rpmorrpm-build
please note that by default both packages are built if you try building this application on a linux distro
Contributors
A Thank you to all the contributors throughout the project, without their work this project would have just been a small project and never expanded to where it is now.