Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,7 @@ export default defineConfig({
{ label: 'Plex', slug: 'music-providers/plex' },
{ label: 'Podcast Index', slug: 'music-providers/podcast-index' },
{ label: 'Podcast RSS Feed', slug: 'music-providers/podcastfeed' },
{ label: 'NetEase Cloud Music', slug: 'music-providers/netease-cloud-music' },
{ label: 'Qobuz', slug: 'music-providers/qobuz' },
{ label: 'Radio Browser', slug: 'music-providers/radio-browser' },
{ label: 'Radio Paradise', slug: 'music-providers/radio-paradise' },
Expand Down
Binary file added public/assets/icons/netease-cloud-music-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
62 changes: 62 additions & 0 deletions src/content/docs/music-providers/netease-cloud-music-zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
title: "网易云音乐"
---

# 网易云音乐 <img src="/assets/icons/netease-cloud-music-icon.png" alt="NetEase Cloud Music icon" style="width: 70px; float: right;" loading="lazy" />

**语言:** [English](/music-providers/netease-cloud-music/) | **中文**

Music Assistant 已支持 <a href="https://music.163.com/" target="_blank" rel="noopener noreferrer">网易云音乐</a>。
由 <a href="https://github.com/xiasi0" target="_blank" rel="noopener noreferrer">xiasi0</a> 贡献与维护。

网易云音乐是中国大陆主要流媒体平台之一,提供中文曲库、推荐内容与歌词能力。

> [!NOTE]
> - 需要网易云音乐账号。
> - 当前该提供商依赖本地运行的 NeteaseCloudMusicApi 兼容服务。
> - 本提供商不会绕过平台权限校验。

## 功能

| | |
|:-----------------------|:---------------------:|
| 免费订阅可用 | 否 |
| 本地自托管媒体 | 否 |
| 支持媒体类型 | 歌手、专辑、歌曲、歌单、电台 |
| [发现推荐](/ui/#view-home) | 支持 |
| 歌词 | 支持 |
| [电台模式](/ui/#track-menu) | 支持 |
| 最高音质 | Hi-Res FLAC(取决于上游接口返回) |
| 登录方式 | 网易云 App 扫码登录 |

### 其他

- 支持搜索:歌曲、歌手、专辑、歌单
- 支持同步:喜欢/收藏内容与用户歌单
- 动态推荐/电台条目包括:每日推荐歌曲、每日推荐歌单、私人 FM、心动模式
- 库同步当前按单向(网易云音乐 -> Music Assistant)使用

## 配置

### 后端 API 服务

该提供商需要可访问的 NeteaseCloudMusicApi 兼容 HTTP 服务(默认:`http://127.0.0.1:3000`)。

Home Assistant 用户可参考配套 add-on PR:
<a href="https://github.com/music-assistant/home-assistant-addon/pull/16" target="_blank" rel="noopener noreferrer">home-assistant-addon#16</a>

### 扫码登录流程(网易云 App)

1. 打开 **设置 -> 音乐源 -> 添加音乐源 -> 网易云音乐**。
2. 将 **API base URL** 设置为你的本地 API 服务地址。
3. 点击 **QR Login**,会弹出新的二维码页面。
4. 使用 **网易云音乐 App** 扫码,并在 App 内确认登录。
5. 关闭二维码页面。
6. 回到 Music Assistant 点击 **Save**。

## 合规与说明

- 播放严格遵循上游返回的账号与歌曲权限。
- 对无权益内容可能返回试听/受限播放,或返回不可播放 URL。
- 不使用任何解锁、破解或绕过订阅限制的逻辑。

62 changes: 62 additions & 0 deletions src/content/docs/music-providers/netease-cloud-music.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
title: "NetEase Cloud Music"
---

# NetEase Cloud Music <img src="/assets/icons/netease-cloud-music-icon.png" alt="NetEase Cloud Music icon" style="width: 70px; float: right;" loading="lazy" />

**Language:** **English** | [中文](/music-providers/netease-cloud-music-zh/)

Music Assistant has support for <a href="https://music.163.com/" target="_blank" rel="noopener noreferrer">NetEase Cloud Music</a>.
Contributed and maintained by <a href="https://github.com/xiasi0" target="_blank" rel="noopener noreferrer">xiasi0</a>.

NetEase Cloud Music is a major streaming platform in Mainland China with a large Chinese catalog, recommendations, and lyrics support.

> [!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](/ui/#view-home) Supported | Yes |
| Lyrics Supported | Yes |
| [Radio Mode](/ui/#track-menu) | 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:
<a href="https://github.com/music-assistant/home-assistant-addon/pull/16" target="_blank" rel="noopener noreferrer">home-assistant-addon#16</a>

### 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.