diff --git a/astro.config.mjs b/astro.config.mjs index 772ccefaa..1db071d0b 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -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' }, diff --git a/public/assets/icons/netease-cloud-music-icon.png b/public/assets/icons/netease-cloud-music-icon.png new file mode 100644 index 000000000..e2db1c23b Binary files /dev/null and b/public/assets/icons/netease-cloud-music-icon.png differ diff --git a/src/content/docs/music-providers/netease-cloud-music-zh.md b/src/content/docs/music-providers/netease-cloud-music-zh.md new file mode 100644 index 000000000..3ccd08f4f --- /dev/null +++ b/src/content/docs/music-providers/netease-cloud-music-zh.md @@ -0,0 +1,62 @@ +--- +title: "网易云音乐" +--- + +# 网易云音乐 NetEase Cloud Music icon + +**语言:** [English](/music-providers/netease-cloud-music/) | **中文** + +Music Assistant 已支持 网易云音乐。 +由 xiasi0 贡献与维护。 + +网易云音乐是中国大陆主要流媒体平台之一,提供中文曲库、推荐内容与歌词能力。 + +> [!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: +home-assistant-addon#16 + +### 扫码登录流程(网易云 App) + +1. 打开 **设置 -> 音乐源 -> 添加音乐源 -> 网易云音乐**。 +2. 将 **API base URL** 设置为你的本地 API 服务地址。 +3. 点击 **QR Login**,会弹出新的二维码页面。 +4. 使用 **网易云音乐 App** 扫码,并在 App 内确认登录。 +5. 关闭二维码页面。 +6. 回到 Music Assistant 点击 **Save**。 + +## 合规与说明 + +- 播放严格遵循上游返回的账号与歌曲权限。 +- 对无权益内容可能返回试听/受限播放,或返回不可播放 URL。 +- 不使用任何解锁、破解或绕过订阅限制的逻辑。 + diff --git a/src/content/docs/music-providers/netease-cloud-music.md b/src/content/docs/music-providers/netease-cloud-music.md new file mode 100644 index 000000000..bef23e3d5 --- /dev/null +++ b/src/content/docs/music-providers/netease-cloud-music.md @@ -0,0 +1,62 @@ +--- +title: "NetEase Cloud Music" +--- + +# NetEase Cloud Music NetEase Cloud Music icon + +**Language:** **English** | [中文](/music-providers/netease-cloud-music-zh/) + +Music Assistant has support for NetEase Cloud Music. +Contributed and maintained by xiasi0. + +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: +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. +