Skip to content
Get packs

Guide · Open source

How to use YesPlayMusic: install, log in and play

Updated · written with AI from the project's own documentation and checked against our catalogue data

YesPlayMusic is a third-party music player that plays songs from the NetEase Cloud Music (网易云音乐) service, with a custom interface. This guide covers how to install the desktop app, log in with your own NetEase account, and use its main features such as lyrics, MV playback and daily recommendations. It also explains the limits, including that the project has no social features and its README restricts use to personal study and research.

YesPlayMusicqier222/YesPlayMusic · ★ 33.5k · MIT

Quick start

  1. 1Download the app. Install with brew install --cask yesplaymusic on macOS or scoop install extras/yesplaymusic on Windows, or download a package from the Releases page.
  2. 2Open the player. Launch YesPlayMusic from your applications or start menu.
  3. 3Log in. Sign in with your NetEase Cloud Music account using QR code, phone or email.
  4. 4Browse your music. Use the library, search and daily recommendations to find songs.
  5. 5Show lyrics or MV. Open a song to view lyrics or play its MV where available.
  6. 6Set shortcuts. Customise keyboard shortcuts or set global shortcuts to control playback.

What YesPlayMusic does and who it suits

YesPlayMusic plays songs from NetEase Cloud Music. It runs as a desktop app on Windows, macOS and Linux via Electron, and it can also run in a browser or be self-hosted as a website. You need your own NetEase account to use it.

It suits existing NetEase Cloud Music users who want a different player interface, and people who want lyrics, MV playback and daily recommendations in a separate app. It is not useful if you do not use NetEase Cloud Music, because it only plays that service's catalog.

Install YesPlayMusic on macOS, Windows or Linux

The project's install method is a downloadable app. The README points to the Releases page on GitHub for installer packages covering macOS, Windows and Linux. The README lists no prerequisites for the app install.

On macOS you can use Homebrew. On Windows you can use Scoop. Both commands are copied from the README.

  • Download the installer from the Releases page of the qier222/YesPlayMusic repository if you prefer a manual install.
  • If the Releases page has no package for your device, the README describes building your own Electron client.
brew install --cask yesplaymusic scoop install extras/yesplaymusic

Log in with your NetEase Cloud Music account

YesPlayMusic supports NetEase account login by QR code scan, phone number or email, according to the README feature list. Log in with your own account to use the player.

The README also lists a daily check-in feature, but it is struck through in the feature list, so do not count on it.

  • Choose QR code, phone or email login.
  • Use your existing NetEase Cloud Music account.

Use lyrics, MV playback and daily recommendations

The README lists lyrics display, MV playback, and private FM with daily recommended songs as features. These are the core parts of the player beyond basic playback.

Other listed features include Light and Dark Mode that switch automatically, custom and global keyboard shortcuts, Mpris support, Last.fm Scrobble and a music cloud drive (音乐云盘).

  • Lyrics display (支持歌词显示)
  • MV playback (支持 MV 播放)
  • Private FM and daily recommendations (私人 FM / 每日推荐歌曲)
  • Custom keyboard shortcuts and global shortcuts
  • Last.fm Scrobble
  • Touch Bar lyrics display

Unblock greyed-out songs with UnblockNeteaseMusic

The README says YesPlayMusic supports UnblockNeteaseMusic, which automatically replaces greyed-out song links with sources from the default source list. This feature is not supported in the web version.

For YouTube sources you must install yt-dlp yourself, according to the README.

  • Desktop app only: the web version does not support this.
  • YouTube sources require a separate yt-dlp install.

Run YesPlayMusic in a browser or self-host it

The README describes deploying to Vercel, your own server, Docker, Replit and Baota panel. The core steps are to deploy the NetEase Cloud Music API, then set VUE_APP_NETEASE_API_URL to that API address. The API is provided by the NeteaseCloudMusicApi project.

For a local web build, the README shows copying the example env file, installing dependencies and building. Replace the API address with your own deployment before use.

  • Copy .env.example to .env and set VUE_APP_NETEASE_API_URL.
  • Run yarn install, then yarn run build for a static build.
  • Upload the files in the dist directory to your web server.
  • Docker: docker build -t yesplaymusic . then docker run -d --name YesPlayMusic -p 80:80 yesplaymusic
cp .env.example .env yarn install yarn run build docker build -t yesplaymusic . docker run -d --name YesPlayMusic -p 80:80 yesplaymusic

Know the limits before you rely on it

The README states there are no social features. The project is licensed under MIT, but the README also says it is for personal study and research only and prohibits commercial and illegal use. The 2.0 Alpha is available, but the README says the current version will move into maintenance mode, with only major bug fixes.

Because the player depends on NetEase's service and an external API, behaviour is tied to those services.

  • No social or sharing features
  • Personal study and research use only, per the README
  • Current version in maintenance mode, per the README

What people use it for

  • Playing your NetEase Cloud Music library in a different interface
  • Reading synced lyrics while listening
  • Listening to daily recommended songs and private FM
  • Running a self-hosted music web player for your own NetEase account

Frequently asked questions

Is YesPlayMusic free?

The project is released under the MIT licence, according to the README. The README also says it is for personal study and research and prohibits commercial and illegal use.

How do I install YesPlayMusic on Mac?

The README gives the Homebrew command brew install --cask yesplaymusic. You can also download an installer from the Releases page on GitHub.

How do I install YesPlayMusic on Windows?

The README gives the Scoop command scoop install extras/yesplaymusic. You can also download an installer from the Releases page.

Does YesPlayMusic work without a NetEase account?

The README says you log in with your NetEase Cloud Music account to use the player. The source does not describe a mode without an account.

What is YesPlayMusic an alternative to, and what are the comparable projects?

The README lists AlgerMusicPlayer, MusicBox and wmplayer as comparable projects, without ranking them. Choose one based on which features and platforms you need.

Why are some songs greyed out, and how can I fix it?

The README says the UnblockNeteaseMusic feature replaces greyed-out song links with other sources in the desktop app. It is not supported in the web version, and YouTube sources need yt-dlp installed separately.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

YesPlayMusic suits people who already use NetEase Cloud Music and want a different player with lyrics, MV playback and daily recommendations. It is a poor choice if you do not use NetEase, need social or sharing features, or need a supported commercial product.

Install options & downloads