Skip to content

YesPlayMusic

A third-party desktop and web player for NetEase Cloud Music with a clean interface.

Stars
33.5k
Forks
4.7k
Licence
MIT
Language
Vue
Last update
27 days ago
Type
App

What it is

YesPlayMusic is a music player that plays songs from the NetEase Cloud Music (网易云音乐) service, with a custom interface. It runs as a desktop app on Windows, macOS and Linux via Electron, and can also run in a browser or be self-hosted as a website. You log in with your own NetEase account to use it.

  • Play your NetEase library and daily recommendations in a standalone window
  • Show synced lyrics or Touch Bar lyrics on macOS
  • Install it as a PWA in Chrome or Edge from the browser
  • Self-host the web player on your own server or Vercel

Great for

  • Existing NetEase Cloud Music users who want a different player interface
  • Chinese-speaking users who use NetEase Cloud Music daily
  • People who want lyrics, MV playback and daily recommendations in a separate app
  • Developers who want to self-host a Vue-based music web player

Not ideal for

  • People who do not use NetEase Cloud Music, since it only plays that service's catalog
  • Users who need a social or sharing features, because the README states there are none
  • Anyone needing a supported commercial product; the README limits use to personal study and research
Step-by-step guide: how to use YesPlayMusicInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Download the app

    macOS via Homebrew

    brew install --cask yesplaymusic

    Windows via Scoop

    scoop install extras/yesplaymusic
  2. 2

    Run it

    • Download the installer for your system from the Releases page, or use Homebrew or Scoop above.
    • Open YesPlayMusic and log in with your NetEase Cloud Music account (QR code, phone or email).
    • Browse your library, daily recommendations or private FM from the main screen.
  3. 3

    Get the most out of it

    • Install yt-dlp if you want the YouTube unblocking source for greyed-out songs, as the README notes
    • Use the PWA install option in Chrome or Edge if you prefer a browser-based window
    • Customize keyboard and global shortcuts in settings, per the feature list
    • Enable Last.fm scrobbling if you use Last.fm

Downloads

Strengths

  • Free and open source under the MIT license, with a large community (about 33k stars)
  • Supports Windows, macOS and Linux, plus browser and PWA use
  • Includes lyrics, MV playback, Last.fm scrobbling and global shortcuts per the README

Trade-offs

  • Depends on the NetEase Cloud Music API, so it can break if that service changes
  • The README says the current version is in maintenance mode, with a 2.0 Alpha announced
  • Some features such as the unblocking sources need extra setup, like installing yt-dlp for YouTube sources

How it compares

ProjectStarsTypeLevelUpdatedBest for
YesPlayMusic (this)33.5kAppbeginner27 days agoExisting NetEase Cloud Music users who want a different player interface
AlgerMusicPlayer17.2kAppbeginner9 days agoChinese-speaking users who want a desktop music player with a separate desktop lyrics window
vue-admin-template20.4kLibraryintermediate2.5 years agoDevelopers starting a new internal admin panel or back-office tool in Vue
koel17.3kAppintermediate4 days agoPeople who want to listen to their own music library from a browser
vuestic-admin11kAppintermediate8 months agoDevelopers starting a new internal admin or dashboard in Vue
iview-admin16.3kAppintermediate4.5 years agoDevelopers building an internal admin panel on Vue 2

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.