NetEase Cloud Music

From its catalog listing

NetEase Cloud Music (网易云音乐) mini player in the Hermes Desktop status bar, in the spirit of the built-in Radio plugin: a compact themed popover with Now Playing (cover + scrolling synced lyrics with the current line highlighted), search for songs and playlists, daily picks / recommended playlists / Personal FM, favorites (heart / Liked Music), browsing and in-panel playback of your own playlists, play/pause/skip/progress/volume with outline-style controls, loop modes (list loop, single loop, shuffle), plus a mini control cluster on the status bar itself with a like/unlike heart, prev/next transport, a live audio-spectrum dot visualiser driven by the Web Audio analyser, and a vinyl-record Now-Playing visual whose articulated tonearm drops on the record while playing and parks off it when paused (v0.5.0). Also offers phone-number + SMS verification-code sign-in as a second login method. Desktop-only UI (desktop/plugin.js on the plugin SDK surface) plus a local FastAPI backend (dashboard/plugin_api.py) that implements NetEase's weapi/eapi request signing (AES-CBC/ECB + RSA) with the Python standard library only — no build step, no extra Python dependencies.

Good to know before installing

unofficial NetEase Cloud Music client: the backend calls only NetEase hosts (music.163.com, interface3.music.163.com, and the p*.music.163.com CDNs for covers and audio) using NetEase's own web/PC client identity (Chrome User-Agent, music.163.com Referer/Origin, eapi os=pc/appver headers, x-os/x-login-chain-id QR-login headers with a locally generated anonymous browser-style cookie set; SMS verification-code login calls NetEase web endpoints /api/sms/captcha/sent and /api/w/login/cellphone with the phone number you type); after you log in, your NetEase session cookie (MUSIC_U) is stored in the plugin's own data/cookie.json and sent only to NetEase hosts, and 'Log out' deletes it; while logged in it reports each played track to NetEase (feedback/webenergy play history) and the heart button likes/unlikes songs on your account; no other third-party services and no telemetry; QR and SMS sign-in may be blocked by NetEase risk control (the panel then surfaces a one-click button to NetEase's official account-verification page); pasting the MUSIC_U cookie remains the documented fallback; VIP songs stream through your own VIP session.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install netease-cloud
  2. Said no? Turn it on later:
    hermes plugins enable netease-cloud
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Languages & regions · Web, research & browsing · Hermes Desktop add-ons
Maintained by
BoosterCore (Community)
Needs
No API keys declared
Works on
linux, macos, windows
Needs Hermes
0.21.5 or newer
Version
0.5.0
In the catalog
2026-11-07, updated 2026-11-11

Known issues (from its catalog listing)

  • QR and SMS sign-in can be blocked by NetEase risk control (「检测到当前设备环境异常」/「安全风险」); the panel then shows an 打开验证页面 button for NetEase's official unblock page, or paste the MUSIC_U cookie on the 账号 tab instead (README has a 3-step Chinese guide).
  • Playlists load the first 1000 tracks; the panel shows the real total (e.g. 共1859首·显示前1000).
  • Audio quality follows your NetEase account (VIP → higher bitrate); the plugin requests exhigh and falls back to standard.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in languages & regions

All languages & regions plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins