How do I install YesPlayMusic on Linux?

You can download the Linux .deb package from the GitHub Releases page, or use the provided Electron build commands for ARM-based systems like Raspberry Pi. Alternatively, run it as a PWA in a supported browser.

Does YesPlayMusic work without a NetEase account?

No, you need a NetEase Cloud Music account to log in via QR code, phone, or email to access your library, playlists, and personalized features. It acts as a client for that service only.

YesPlayMusic vs official NetEase app: what's the difference?

YesPlayMusic offers an ad-free, social-feature-free interface with better customization and UnblockNeteaseMusic integration for restricted songs, but lacks official support, social features, and may have API instability compared to the official app.

How to deploy YesPlayMusic on my own server?

Clone the repository, install dependencies with Yarn, set up the NeteaseCloudMusicApi backend, configure environment variables in a .env file, build the project, and serve the dist folder using a web server like Nginx. Detailed steps are in the README for Vercel, Docker, or manual setups.

Can I use YesPlayMusic with YouTube Music or Spotify?

No, YesPlayMusic is exclusively designed for NetEase Cloud Music and does not support other streaming services. It's built around NetEase's API and catalog, so you'd need a different client for other platforms.

Is YesPlayMusic safe for my NetEase account?

It uses official login methods, but as a third-party client, there's inherent risk; the project is open-source, allowing code inspection, but users should be cautious and avoid sharing sensitive credentials. No major security issues are reported, but it's unofficial.

How to fix grayed-out songs in YesPlayMusic?

In the desktop app, enable the UnblockNeteaseMusic integration to automatically fetch alternative sources from providers like YouTube. For the web version, this feature is not supported, so you may need to use the desktop app or rely on NetEase's availability.

Open-Awesome

YesPlayMusic

MITVuev0.4.11

A high‑quality third‑party NetEase Cloud Music player with a clean UI, available as a web app and desktop client.

Visit Website GitHub

33.4k stars4.7k forks0 contributors

What is YesPlayMusic?

YesPlayMusic is an open‑source third‑party client for NetEase Cloud Music that provides a high‑quality, ad‑free interface for streaming music. It solves the problem of cluttered official apps by removing social features and focusing purely on music playback, with support for lyrics, MV playback, and personalized recommendations.

Target Audience

Users of NetEase Cloud Music who want a cleaner, distraction‑free player, as well as developers interested in self‑hosting a music streaming client or contributing to a Vue.js/Electron project.

Value Proposition

Developers choose YesPlayMusic for its sleek design, privacy‑focused approach (no social features), and flexibility—it can be used as a web PWA, a desktop app, or self‑hosted on a private server with full control over the experience.

Overview

高颜值的第三方网易云播放器，支持 Windows / macOS / Linux :electron:

Use Cases

Best For

Replacing the official NetEase Cloud Music app with a cleaner, ad‑free interface
Self‑hosting a personal music streaming client on a VPS or home server
Accessing NetEase Cloud Music catalog from regions with playback restrictions
Building a custom music player with Vue.js and Electron
Streaming music without social features or distractions
Playing grayed‑out songs via UnblockNeteaseMusic integration

Not Ideal For

Users who rely on NetEase Cloud Music's social features like comments, sharing, or community interactions
Projects needing a universal music player that supports multiple streaming services (e.g., Spotify, Apple Music)
Teams requiring guaranteed API stability and official support without self-hosting dependencies
Casual users who want a zero-configuration, out-of-the-box music app without technical setup

Pros & Cons

Pros

Ad-Free Experience

YesPlayMusic removes all advertisements from NetEase Cloud Music, providing a clean interface focused solely on music playback without distractions.

Cross-Platform Availability

It offers a PWA for web browsers and an Electron desktop app for Windows, macOS, and Linux, ensuring wide accessibility and offline use.

Unblocked Playback Integration

The desktop app integrates UnblockNeteaseMusic to automatically replace grayed-out songs with alternative sources, bypassing regional restrictions for many users.

Customization and Privacy

Features like light/dark theme auto-switch, custom keyboard shortcuts, and Last.fm scrobbling allow personalization while stripping social features for a privacy-focused experience.

Cons

Web Version Limitations

The PWA web version does not support the UnblockNeteaseMusic feature, limiting its ability to bypass song restrictions compared to the desktop app, as noted in the README.

Unofficial API Dependency

It relies on the third-party NeteaseCloudMusicApi, which is unofficial and subject to breaking changes or takedowns, potentially affecting reliability and requiring manual updates.

Complex Self-Hosting Setup

Deploying a self-hosted instance involves multiple steps like configuring API backends, environment variables, and build processes, which can be technical and time-consuming for non-developers.

Frequently Asked Questions

Related Projects

slidev

Presentation Slides for Developers

Stars49,170

Forks2,241

Last commit4 days ago

Wiki.js

Wiki.js | Next Generation Open Source Wiki

Open Source eCommerce & Multi-Vendor Marketplace Platform Built with Laravel for Enterprise-Scale Commerce, Supporting 10M+ SKUs

Stars28,270

Forks3,343