YesPlayMusic README

The project's README from github.com/qier222/YesPlayMusic. As one markdown file: README.md.

Special thanks to:
Warp sponsorship
Warp is built for coding with multiple AI agents
Available for macOS, Linux and Windows


Logo

YesPlayMusic

高颜值的第三方网易云播放器
🌎 访问DEMO  |   📦️ 下载安装包  |   💬 加入交流群

Library

全新版本

全新 2.0 Alpha 测试版已发布，欢迎前往 Releases 页面下载。 当前版本将会进入维护模式，除重大 bug 修复外，不会再更新新功能。

✨ 特性

📦️ 安装

Electron 版本由 @hawtim 和 @qier222 适配并维护，支持 macOS、Windows、Linux。

访问本项目的 Releases 页面下载安装包。

同类项目（排名无先后）

欢迎大家通过 PR 分享你的项目，让更多人看到！

⚙️ 部署至 Vercel

除了下载安装包使用，你还可以将本项目部署到 Vercel 或你的服务器上。下面是部署到 Vercel 的方法。

本项目的 Demo (https://music.qier222.com) 就是部署在 Vercel 上的网站。

Powered by 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 地址：

{
  "rewrites": [
    {
      "source": "/api/:match*",
      "destination": "https://your-netease-api.example.com/:match*"
    }
  ]
}

  1. 打开 Vercel.com，使用 GitHub 登录。

  2. 点击 Import Git Repository 并选择你刚刚复制的仓库并点击 Import。

  3. 点击 PERSONAL ACCOUNT 旁边的 Select。

  4. 点击 Environment Variables，填写 Name 为 VUE_APP_NETEASE_API_URL，Value 为 /api，点击 Add。最后点击底部的 Deploy 就可以部署到 Vercel 了。

⚙️ 部署到自己的服务器

除了部署到 Vercel，你还可以部署到自己的服务器上

  1. 部署网易云 API，详情参见 Binaryify/NeteaseCloudMusicApi
  2. 克隆本仓库
git clone --recursive https://github.com/qier222/YesPlayMusic.git
  1. 安装依赖
yarn install

  1. （可选）使用 Nginx 反向代理 API，将 API 路径映射为 /api，如果 API 和网页不在同一个域名下的话（跨域），会有一些 bug。

  2. 复制 /.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
  1. 编译打包
yarn run build
  1. 将 /dist 目录下的文件上传到你的 Web 服务器

⚙️ 宝塔面板 docker 应用商店 部署

  1. 安装宝塔面板，前往宝塔面板官网 ，选择正式版的脚本下载安装。

  2. 安装后登录宝塔面板，在左侧导航栏中点击 Docker，首次进入会提示安装 Docker 服务，点击立即安装，按提示完成安装

  3. 安装完成后在应用商店中找到 YesPlayMusic，点击安装，配置域名、端口等基本信息即可完成安装。

  4. 安装后在浏览器输入上一步骤设置的域名即可访问。

⚙️ Docker 部署

  1. 构建 Docker Image
docker build -t yesplaymusic .
  1. 启动 Docker Container
docker run -d --name YesPlayMusic -p 80:80 yesplaymusic
  1. Docker Compose 启动
docker-compose up -d

YesPlayMusic 地址为 http://localhost

⚙️ 部署至 Replit

  1. 新建 Repl，选择 Bash 模板

  2. 在 Replit shell 中运行以下命令

bash <(curl -s -L https://raw.githubusercontent.com/qier222/YesPlayMusic/main/install-replit.sh)

  1. 首次运行成功后，只需点击绿色按钮 Run 即可再次运行

  2. 由于 replit 个人版限制内存为 1G（教育版为 3G），构建过程中可能会失败，请再次运行上述命令或运行以下命令：

cd /home/runner/${REPL_SLUG}/music && yarn install && yarn run build

👷‍♂️ 打包客户端

如果在 Release 页面没有找到适合你的设备的安装包的话，你可以根据下面的步骤来打包自己的客户端。

  1. 打包 Electron 需要用到 Node.js 和 Yarn。可前往 Node.js 官网 下载安装包。安装 Node.js 后可在终端里执行 npm install -g yarn 来安装 Yarn。

  2. 使用 git clone --recursive https://github.com/qier222/YesPlayMusic.git 克隆本仓库到本地。

  3. 使用 yarn install 安装项目依赖。

  4. 复制 /.env.example 文件为 /.env 。

  5. 选择下列表格的命令来打包适合的你的安装包，打包出来的文件在 /dist_electron 目录下。了解更多信息可访问 electron-builder 文档

命令 说明
yarn electron:build --windows nsis:ia32 Windows 32 位
yarn electron:build --windows nsis:arm64 Windows ARM
yarn electron:build --linux deb:armv7l Debian armv7l（树莓派等）
yarn electron:build --macos dir:arm64 macOS ARM

:computer: 配置开发环境

本项目由 NeteaseCloudMusicApi 提供 API。

运行本项目

# 安装依赖
yarn install

# 创建本地环境变量
cp .env.example .env

# 运行（网页端）
yarn serve

# 运行（electron）
yarn electron:serve

本地运行 NeteaseCloudMusicApi，或者将 API 部署至 Vercel

# 运行 API （默认 3000 端口）
yarn netease_api:run

☑️ Todo

查看 Todo 请访问本项目的 Projects

欢迎提 Issue 和 Pull request。

📜 开源许可

本项目仅供个人学习研究使用，禁止用于商业及非法用途。

基于 MIT license 许可进行开源。

灵感来源

API 源代码来自 Binaryify/NeteaseCloudMusicApi

🖼️ 截图

lyrics library-dark album home-2 artist search home explore

YesPlayMusic (qier222/YesPlayMusic)

Searching Database…

33.4K ·GitHub
YesPlayMusic
Что это такое?Аккуратно сделанный сторонний плеер для NetEase Cloud Music (网易云音乐) на стеке Vue.js — десктопное приложение для Windows, macOS и Linux плюс веб-версия, из которой полностью убраны социальные функции. Ссылка на живое демо есть в начале README.
Это программа для компьютера или сайт?И то, и другое. Она распространяется как десктопное приложение на Electron и одновременно работает в браузере, где её можно установить как PWA прямо из Chrome или Edge.
Мне нужен аккаунт NetEase Cloud Music, чтобы пользоваться этим?Да — вход выполняется через аккаунт NetEase Cloud Music: по QR-коду, номеру телефона или электронной почте.
Текущая версия ещё активно разрабатывается?Актуальная линейка 1.x находится в режиме поддержки: исправляются только серьёзные баги, новых функций не появляется. Новая версия 2.0 Alpha уже доступна на странице Releases.
Можно запустить её как веб-приложение на своём сервере, а не устанавливать?Да — помимо десктопного приложения её можно развернуть на Vercel, на своём сервере, в Docker, в магазине приложений панели BT или на Replit. Предварительно нужно развернуть бэкенд NetEaseCloudMusicApi (Binaryify/NeteaseCloudMusicApi) и указать фронтенду адрес вашего API.
Что она умеет, кроме воспроизведения музыки?Проигрывает клипы (MV) и показывает тексты песен, есть приватная FM-станция и ежедневные рекомендации, поддерживается скробблинг на Last.fm и облачный диск NetEase, а также свои глобальные горячие клавиши, поддержка Touch Bar и Mpris и автоматическое переключение светлой и тёмной темы.
Что происходит с песнями, которые отображаются серыми?Встроенная интеграция с UnblockNeteaseMusic (включена по умолчанию) автоматически подменяет ссылки на серые треки другими источниками звука. Для источника YouTube нужно самостоятельно установить yt-dlp, а веб-версия этого вообще не поддерживает.
Она работает для пользователей за пределами Китая?Да — зарубежные пользователи могут слушать треки напрямую, как только войдут в свой аккаунт NetEase Cloud Music.
Есть ли интеграция с Discord?Да, в приложении Electron уже входит зависимость discord-rich-presence, поэтому оно может показывать, что вы слушаете, через Discord Rich Presence.
What are similar projects?folia-major, AlgerMusicPlayer, vue2-manage, vue-hackernews-2.0, vue-element-admin, vue-admin-template, pear-desktop, vue2-happyfri
Which topics is it in?streaming-audio, vue-cli, progressive-web-app, vue-router, vuex, player, mac, music-player, vercel, pwa, discord, music
Creator
qier222
Size
48.1 MB
Stars
33.4K
Updated
CommitOct 10Releasev0.4.11Oct 10
Age
6y
Commits · 90 Days