qier222 /YesPlayMusic
高颜值的第三方网易云播放器,支持 Windows / macOS / Linux :electron:
★ 33,633⑂ 4,676👁 220⑃ 453● 1,852▤ 33
33,633
stars
4,676
forks
220
watchers
453
prs
1,852
issues
33
releases
README
Special thanks to:
Warp is built for coding with multiple AI agents
Available for macOS, Linux and Windows
---
YesPlayMusic
高颜值的第三方网易云播放器
🌎 访问DEMO |
📦️ 下载安装包 |
💬 加入交流群
[![Library][library-screenshot]](https://music.qier222.com)
全新版本
全新 2.0 Alpha 测试版已发布,欢迎前往 Releases 页面下载。
当前版本将会进入维护模式,除重大 bug 修复外,不会再更新新功能。
✨ 特性
- ✅ 使用 Vue.js 全家桶开发
- 🔴 网易云账号登录(扫码/手机/邮箱登录)
- 📺 支持 MV 播放
- 📃 支持歌词显示
- 📻 支持私人 FM / 每日推荐歌曲
- 🚫🤝 无任何社交功能
- 🌎️ 海外用户可直接播放(需要登录网易云账号)
- 🔐 支持 UnblockNeteaseMusic,自动使用各类音源替换变灰歌曲链接 (网页版不支持)
- 「各类音源」指默认启用的音源。
- YouTube 音源需自行安装 yt-dlp。
- ~~✔️ 每日自动签到(手机端和电脑端同时签到)~~
- 🌚 Light/Dark Mode 自动切换
- 👆 支持 Touch Bar 歌词显示
![Library][touchbar-screenshot]
- 🖥️ 支持 PWA,可在 Chrome/Edge 里点击地址栏右边的 ➕ 安装到电脑
- 🟥 支持 Last.fm Scrobble
- ☁️ 支持音乐云盘
- ⌨️ 自定义快捷键和全局快捷键
- 🎧 支持 Mpris
- 🛠 更多特性开发中
📦️ 安装
Electron 版本由 @hawtim 和 @qier222 适配并维护,支持 macOS、Windows、Linux。
访问本项目的 Releases
页面下载安装包。
- macOS 用户可以通过 Homebrew 来安装:brew install --cask yesplaymusic
- Windows 用户可以通过 Scoop 来安装:scoop install extras/yesplaymusic
同类项目(排名无先后)
欢迎大家通过 PR 分享你的项目,让更多人看到!
- algerkong/AlgerMusicPlayer
- asxez/MusicBox
- lianchengwu/wmplayer
⚙️ 部署至 Vercel
除了下载安装包使用,你还可以将本项目部署到 Vercel 或你的服务器上。下面是部署到 Vercel 的方法。
本项目的 Demo (https://music.qier222.com) 就是部署在 Vercel 上的网站。
1. 部署网易云 API,详情参见 Binaryify/NeteaseCloudMusicApi
。你也可以将 API 部署到 Vercel。
2. 点击本仓库右上角的 Fork,复制本仓库到你的 GitHub 账号。
3. 点击仓库的 Add File,选择 Create new file,输入 vercel.json,将下面的内容复制粘贴到文件中,并将 https://your-netease-api.example.com 替换为你刚刚部署的网易云 API 地址:
json
{
"rewrites": [
{
"source": "/api/:match",
"destination": "https://your-netease-api.example.com/:match"
}
]
}
4. 打开 Vercel.com,使用 GitHub 登录。
5. 点击 Import Git Repository 并选择你刚刚复制的仓库并点击 Import。
6. 点击 PERSONAL ACCOUNT 旁边的 Select。
7. 点击 Environment Variables,填写 Name 为 VUE_APP_NETEASE_API_URL,Value 为 /api,点击 Add。最后点击底部的 Deploy 就可以部署到
Vercel 了。
⚙️ 部署到自己的服务器
除了部署到 Vercel,你还可以部署到自己的服务器上
1. 部署网易云 API,详情参见 Binaryify/NeteaseCloudMusicApi
2. 克隆本仓库
sh
git clone --recursive https://github.com/qier222/YesPlayMusic.git
3. 安装依赖
sh
yarn install
4. (可选)使用 Nginx 反向代理 API,将 API 路径映射为 /api,如果 API 和网页不在同一个域名下的话(跨域),会有一些 bug。
5. 复制 /.env.example 文件为 /.env,修改里面 VUE_APP_NETEASE_API_URL 的值为网易云 API 地址。本地开发的话可以填写 API 地址为 http://localhost:3000,YesPlayMusic 地址为 http://localhost:8080。如果你使用了反向代理 API,可以填写 API 地址为 /api。
VUE_APP_NETEASE_API_URL=http://localhost:3000
6. 编译打包
sh
yarn run build
7. 将 /dist 目录下的文件上传到你的 Web 服务器
⚙️ 宝塔面板 docker 应用商店 部署
1. 安装宝塔面板,前往宝塔面板官网 ,选择正式版的脚本下载安装。
2. 安装后登录宝塔面板,在左侧导航栏中点击 Docker,首次进入会提示安装 Docker 服务,点击立即安装,按提示完成安装
3. 安装完成后在应用商店中找到 YesPlayMusic,点击安装,配置域名、端口等基本信息即可完成安装。
4. 安装后在浏览器输入上一步骤设置的域名即可访问。
⚙️ Docker 部署
1. 构建 Docker Image
sh
docker build -t yesplaymusic .
2. 启动 Docker Container
sh
docker run -d --name YesPlayMusic -p 80:80 yesplaymusic
3. Docker Compose 启动
sh
docker-compose up -d
YesPlayMusic 地址为Top issues
#2383大家用最新的v0.4.9版本现在不会封号了吧?55 comments · 2025-05-09#126希望提供本地播放功能23 comments · 2021-01-29#2395无法登录17 comments · 2025-07-23#928[bug]0.41云盘功能无法上传,代码413。设备m1 macbookair16 comments · 2021-09-26#2342v0.4.9 为什么只有源代码了14 comments · 2024-11-14#2130希望下一个版本能够增加和qq音乐一样的菜单栏歌词,逼格贼高15 comments · 2023-09-05#1925希望能够提供 Windows ARM64 的独立安装包15 comments · 2023-01-28#231810.14 网易云音乐账号被封,沟通客服,仍需等待三天14 comments · 2024-10-15
Discussions
#2489分享 Sonar:用 SwiftUI 实现的 iPhone / Mac 音乐播放器0 comments · 2026-10-06#2478分享一个 Tauri 2 + Rust Sidecar 重构的 fork:迷你播放条、菜单栏歌词,还有 ypm TUI3 comments · 2026-08-10#2473Fork ~ 现代化到vue3 ,使用vite,修复了登录问题,增加了网页登录0 comments · 2026-06-29#2452automix feature0 comments · 2026-02-01#2418操作逻辑0 comments · 2025-11-05#2409#2403 中未经测试的docker、replit部署文件的修改1 comments · 2025-10-11#2394一起听0 comments · 2025-07-19#2369添加 6K Labs Amuse 服务的魔改版 YesPlayMusic0 comments · 2025-02-05
Latest release
0.4.11 v0.4.11 2026-10-10更新日志 ✨ 新特性 - Touch Bar 歌词:在配备 Touch Bar 的 MacBook 上,播放时 Touch Bar 中间会实时显示当前歌词(原有的前进 / 后退、搜索和播放列表按钮已移除,以留出显示空间),感谢 @KawakazeNotFound(2407) - 主题颜色:设置页新增「主题颜色」选项,除原始颜色外,还提供日落、海洋、森林三种渐变配色,感谢 @wuzhi456(2461) - 托盘图标颜色:设置页新增「托盘图标颜色」选项,可选择自动、浅色或深色,让托盘图标在不同系统主题和任务栏背景下都清晰可见,感谢 @657kbps(2414) - 云盘歌曲内嵌歌词:播放未与网易云曲库关联的云盘歌曲时,会显示上传音频文件中内嵌的歌词,感谢 @Cinvin(2419) - 每日推荐一键播放:每日推荐页面新增「播放」按钮,可直接播放全部推荐歌曲,感谢 @Utopia-V(2482) 🐛 修复 - 修复听歌记录无法同步到网易云音乐的问题:网易云已不再统计旧接口上报的播放记录,现改为与官方客户端相同的上报方式,「最近播放」与「听歌排行」恢复正常更新;同时修复一首歌自然播放结束时被重复上报、以及未实际播放的歌曲也被上报的问题,感谢 @LucasYanzy(2485) - 修复歌曲缓存上限不生效、缓存会无限增长的问题,感谢 @fatelove42(2430) - 修复