Netease Cloud Music CLI / 网易云音乐命令行工具
Search, play, download, and manage your library — all from the terminal with structured JSON output for scripting and AI agent integration.
- Search tracks, albums, artists, playlists
- Playback via mpv with IPC control (play/pause/stop/seek/volume/repeat)
- Track info, streaming URLs, lyrics, download
- Library management (liked tracks, recent history)
- Playlist browsing
- Browser cookie import from Chrome, Edge, Firefox, Safari via sweet-cookie
- Multi-profile support for multiple accounts
- Three output modes: colorized human-readable, JSON, plain text
- Debug/verbose logging (
-v,-d) - Cross-platform: macOS, Linux, Windows
Netease Cloud Music has no public API. The unofficial API endpoints require encrypted requests and valid session cookies. Instead of implementing a fragile login flow (SMS/QR code), neteasecli imports cookies directly from your browser:
- Multi-browser — Chrome, Edge, Firefox, Safari (auto-detected)
- No credentials stored — reads browser's encrypted cookie DB via OS keychain
- No captcha — skip SMS verification entirely
- Always fresh — re-run
auth loginanytime to refresh - One command —
neteasecli auth loginand you're in
# npm
npx neteasecli search track "Jay Chou" # Run without installing / 免安装运行
npm install -g neteasecli # Install globally / 全局安装
# pnpm
pnpm dlx neteasecli search track "Jay Chou"
pnpm add -g neteasecli
# bun
bunx neteasecli search track "Jay Chou"
bun add -g neteaseclineteasecli auth login # Import cookies from browser
neteasecli search track "Sunny Day" # Search
neteasecli track play 185868 # Play (requires mpv)
neteasecli player pause # Pause/resume
neteasecli player stop # Stopneteasecli auth login # Import cookies from browser / 从浏览器导入 Cookie
neteasecli auth login --profile X # Specify Chrome/Edge profile / 指定 Chrome/Edge Profile
neteasecli auth check # Check login status / 检查登录状态
neteasecli auth logout # Logout / 登出neteasecli search track <query> # Search tracks / 搜索歌曲
neteasecli search album <query> # Search albums / 搜索专辑
neteasecli search playlist <query> # Search playlists / 搜索歌单
neteasecli search artist <query> # Search artists / 搜索歌手Options: -l, --limit <n> (default 20), -o, --offset <n> (default 0)
neteasecli track detail <id> # Track metadata / 歌曲详情
neteasecli track url <id> # Streaming URL / 播放链接
neteasecli track lyric <id> # Lyrics / 歌词
neteasecli track download <id> # Download / 下载
neteasecli track play <id> # Play via mpv / 用 mpv 播放Options: -q, --quality <level> standard | higher | exhigh (default) | lossless | hires
neteasecli player status # Current playback status / 播放状态
neteasecli player pause # Toggle pause/resume / 暂停或继续
neteasecli player stop # Stop playback / 停止播放
neteasecli player seek <seconds> # Seek relative (e.g. 10, -10) / 快进快退
neteasecli player seek 30 --absolute # Seek to absolute position / 跳转到指定位置
neteasecli player volume [0-150] # Get or set volume / 音量
neteasecli player repeat [on|off] # Toggle or set repeat / 单曲循环neteasecli library liked # Liked tracks / 喜欢的音乐
neteasecli library like <id> # Like a track / 收藏
neteasecli library unlike <id> # Unlike / 取消收藏
neteasecli library recent # Recently played / 最近播放neteasecli playlist list # My playlists / 我的歌单
neteasecli playlist detail <id> # Playlist tracks / 歌单详情| Flag | Description |
|---|---|
--json |
Force JSON output (default when piped) / 强制 JSON 输出 |
--plain |
Plain text output (tab-separated) / 纯文本输出 |
--pretty |
Pretty-print JSON / 格式化 JSON |
--quiet |
Suppress output / 静默模式 |
--no-color |
Disable colors / 禁用颜色 |
--profile <name> |
Account profile (default: "default") / 账号配置 |
-v, --verbose |
Verbose output / 详细输出 |
-d, --debug |
Debug output (implies --verbose) / 调试输出 |
--timeout <seconds> |
Request timeout (default: 30) / 请求超时秒数 |
| Mode | When | Description |
|---|---|---|
| Human | TTY (default) | Colorized, readable / 彩色可读 |
| JSON | Piped or --json |
Structured { success, data, error } / 结构化 JSON |
| Plain | --plain |
Tab-separated, scriptable / 制表符分隔 |
# Colorized output in terminal / 终端彩色输出
neteasecli search track "Jay Chou"
# JSON for scripting / JSON 用于脚本
neteasecli --json search track "Jay Chou"
neteasecli search track "Jay Chou" | jq '.data.tracks[0]'
# Plain text for cut/awk / 纯文本用于文本处理
neteasecli --plain search track "Jay Chou" | cut -f1,2Exit codes: 0 success, 1 general error, 2 auth error, 3 network error.
neteasecli --profile work auth login # Login with "work" profile
neteasecli --profile work library liked # Use "work" profile
neteasecli auth login # Default profileProfiles are stored in ~/.config/neteasecli/profiles/<name>/.
- Node.js >= 24
- Chrome, Edge, Firefox, or Safari (for cookie import / 用于导入 Cookie)
- mpv (optional, for playback / 可选，用于播放)
- macOS, Linux, or Windows
This tool uses unofficial Netease Cloud Music API endpoints. Use responsibly and in accordance with Netease's Terms of Service.
本工具使用非官方网易云音乐 API，请合理使用并遵守网易云音乐服务条款。
MIT