ytmdesktop

ytmdesktopGPL-3.0活跃维护

把 YouTube Music 封装成桌面客户端,支持全局媒体快捷键、Discord 状态显示和 Last.fm 记录播放,弥补网页版缺少的系统集成。

A Desktop App for YouTube Music

v2.1.0发布于 2026-10-29 00:33 UTC6,735star +7 / 7 天644fork同步于 2026-11-10 17:34 UTC

怎么上手

由 README 提炼,执行前请确认
winget install "YouTube Music Desktop App"
硬件要求按 README 说明

README 未说明硬件要求;作为 Electron 桌面应用,需能运行图形界面的 Windows、Linux 或 macOS 环境。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

把 YouTube Music 装进桌面窗口的 Electron 客户端,免开浏览器听歌

把 YouTube Music 封装成桌面客户端,支持全局媒体快捷键、Discord 状态显示和 Last.fm 记录播放,弥补网页版缺少的系统集成。

核心能力

  • 基于 Electron 的桌面客户端,封装 YouTube Music 网页播放
  • 提供 Windows、Linux、macOS 三平台安装包与包管理器分发
  • 支持 Winget、Scoop、Brew、AUR 等渠道一键安装
  • 代码库已重写为全新 v2 架构

容易踩的坑

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

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v2.1.0
  1. 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
      • shuffleEnabled state 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

    Known Issues

    • Check for updates in About is non-functional. This was missed bef
  2. 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 off when 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.asc signed with https://github.com/NovusTheory.gpg

  3. 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.asc signed with https://github.com/NovusTheory.gpg

  4. 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.asc signed with https://github.com/NovusTheory.gpg

  5. 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.asc signed with https://github.com/NovusTheory.gpg

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    YouTube Music Desktop App

    Now with a Fresh new Codebase 😉

    YouTube Music Desktop App

    Discord Gitmoji GitHub license GitHub release Download

    ⬇️ Download at

    Windows
    Linux
    Mac

    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 fakeroot and dpkg
    • For building on RedHat based Linux Distros like Fedora, you will need to install rpm or rpm-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.