NetEase Cloud Music

Language: English | 中文

Music Assistant has support for NetEase Cloud Music. NetEase Cloud Music is a major streaming platform in Mainland China with a large Chinese catalog, recommendations, and lyrics support. Contributed and maintained by xiasi0.

NOTE

• A NetEase Cloud Music account is required
• This provider currently requires a local NeteaseCloudMusicApi-compatible backend service
• This provider does not bypass entitlement checks

Features

Subscription FREE	No
Self-Hosted Local Media	No
Media Types Supported	Artists, Albums, Tracks, Playlists, Radio
Recommendations Supported	Yes
Lyrics Supported	Yes
Radio Mode	Yes
Maximum Stream Quality	Hi-Res FLAC (upstream response dependent)
Login Method	NetEase App QR Code

Other

• Search support for tracks, artists, albums, and playlists
• Library sync for liked/favorited content and user playlists
• Dynamic recommendation/radio entries include Daily songs, Daily playlists, Private FM, and Heart Mode
• Library sync is currently one-way (NetEase Cloud Music -> Music Assistant)

Configuration

Backend API Service

This provider requires a running NeteaseCloudMusicApi-compatible HTTP service (default: http://127.0.0.1:3000).

For Home Assistant users, see the companion add-on PR:
home-assistant-addon#16

QR Login Flow (NetEase App)

1. Open Settings -> Music Sources -> Add Music Source -> NetEase Cloud Music
2. Set API base URL to your local API service
3. Click QR Login. A new QR page will open
4. Scan with the NetEase Cloud Music app and confirm login in the app
5. Close the QR page
6. Click Save

Compliance / Notes

• Playback strictly follows upstream account and track entitlement
• Non-entitled tracks may return preview/limited playback or no playable URL
• No unlock/crack/bypass logic is used for subscription-locked content