^{Special thanks to:}

Warp is built for coding with multiple AI agents
^{Available for macOS, Linux, and Windows}

YesPlayMusic

A beautiful third-party NetEase Cloud Music player

🌎 Live Demo   |   📦 Download   |   💬 Community

[![Library Screenshot][library-screenshot]](https://music.qier222.com)

🚀 New Version

A brand-new YesPlayMusic 2.0 Alpha has been released. You can download it from the Releases page.

The current version is now in maintenance mode.

Only critical bug fixes will be provided, and no new features will be added.

✨ Features

(QR Code / Phone / Email)

Automatically replaces unavailable tracks (desktop only)

📦 Installation

The Electron version is maintained by @hawtim and @qier222.

Download installers from the 👉 Releases page

Package Managers

  brew install --cask yesplaymusic

  scoop install extras/yesplaymusic

🔁 Similar Projects

Feel free to submit a PR to add your project!

⚙️ Deploy to Vercel

You can deploy YesPlayMusic to Vercel or your own server.

The official demo (https://music.qier222.com) is hosted on Vercel.

Steps

1. Deploy the NetEase Cloud Music API 👉 Binaryify/NeteaseCloudMusicApi

2. Fork this repository to your GitHub account

3. Create a vercel.json file in the root:

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

4. Import the repository into Vercel

5. Add an Environment Variable:

6. Click Deploy

⚙️ Deploy to Your Own Server

1. Deploy NetEase Cloud Music API https://github.com/Binaryify/NeteaseCloudMusicApi

2. Clone the repository:

git clone --recursive https://github.com/qier222/YesPlayMusic.git

3. Install dependencies:

yarn install

4. (Optional) Configure Nginx reverse proxy for /api

5. Create .env from .env.example:

VUE_APP_NETEASE_API_URL=http://localhost:3000

6. Build the project:

yarn build

7. Upload /dist to your web server

🐳 Docker Deployment

docker build -t yesplaymusic .
docker run -d -p 80:80 --name yesplaymusic yesplaymusic

Or using Docker Compose:

docker-compose up -d

Access at: http://localhost

🧑‍💻 Build Desktop Client

If no installer fits your system, you can build it manually.

yarn install
yarn electron:build

Build outputs are located in /dist_electron.

🛠 Development Setup

yarn install
cp .env.example .env
 yarn serve              # Web
 yarn electron:serve     # Electron

Run API locally:

yarn netease_api:run

📜 License

This project is for personal learning and research only. Commercial and illegal use is prohibited.

Licensed under the MIT License.

🎨 Inspiration

🖼 Screenshots

![lyrics][lyrics-screenshot] ![library-dark][library-dark-screenshot] ![album][album-screenshot] ![home][home-screenshot]

Image References

[album-screenshot]: images/album.png [library-screenshot]: images/library.png [library-dark-screenshot]: images/library-dark.png [lyrics-screenshot]: images/lyrics.png [home-screenshot]: images/home.png