SkillsAdd

netease/skills

ncm-cli-setup

安? ncm-cli、? mpv 播放器，或排查安?

Trending #8826 First seen Mar 23, 2026

Installation

$ npx skills add netease/skills --skill ncm-cli-setup
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

airunway-aks-setup Similar name
microsoft/azure-skills

Set up AI Runway on AKS — from bare cluster to running model. Covers cluster verification, cont…

314.8K installs
prisma-database-setup Similar name
prisma/skills

Guides for configuring Prisma with different database providers (PostgreSQL, MySQL, SQLite, Mon…

269.8K installs
prisma-postgres-setup Similar name
prisma/skills

Set up a new Prisma Postgres database and connect it to a local project using the Management AP…

257.4K installs
xcode-project-setup Similar name
firebase/agent-skills

Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill …

104.1K installs
expo-tailwind-setup Similar name
expo/skills 54.3K installs
clerk-setup Similar name
clerk/skills 42.6K installs

Also in this package

Other skills from netease/skills.

npx skills add netease/skills
netease-music-cli 14 netease-music-assistant 13

Browse all from netease/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 237
Default branch master
Open issues 13
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,668 B
  • docs SUMMARY.md 196 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 846 installs

SKILL.md

ncm-cli 安装配置

ncm-cli 是网易云音乐的 CLI 工具（音乐搜索、播放控制、歌单管理、TUI 播放器）。

安装流程

第一步：安装 ncm-cli、mpv

1.1 安装 ncm-cli

npm install -g @music163/ncm-cli

验证安装：

ncm-cli --version

1.2 安装 mpv

播放功能需要 mpv 播放器。先检测是否已安装：

mpv --version

macOS / Windows：若未安装，直接执行安装脚本：

python3 scripts/install_mpv.py

Linux：询问用户是否需要播放功能：

  • 如果是桌面环境、需要本地播放 → 执行 python3 scripts/install_mpv.py
  • 如果是服务器环境、不需要播放 → 跳过，搜索/歌单等命令仍可正常使用

安装脚本会自动识别包管理器：

  • macOS：Homebrew（brew install mpv）或 MacPorts
  • Linux：apt / dnf / pacman / zypper
  • Windows：winget / Chocolatey / Scoop

第二步：配置 API Key

使用 ncm-cli 需要先设置API Key：

ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的PrivateKey>

如果还没有 API Key，请先前往网易云音乐开放平台申请 API Key（appId 和
privateKey）。

第三步：配置默认播放器

询问用户选择默认播放器：

  • mpv（内置播放器）：轻量、跨平台，需先完成第一步中的 mpv 安装
  • orpheus（云音乐 App）：调用本地网易云音乐客户端播放，仅支持 macOS

根据用户选择执行：

ncm-cli config set player mpv      # 选择内置播放器
ncm-cli config set player orpheus  # 选择云音乐 App

第四步：登录

登录是必须的，请使用：

ncm-cli login --background

常见问题

问题 解决方法
ncm-cli: command not found 检查 npm 全局 bin 是否在 PATH 中：npm bin -g
mpv not found 重新运行 python3 scripts/install_mpv.py 或手动安装：https://mpv.io
登录超时 重新执行 ncm-cli login --background

基本信息

  • 需要 Node.js >= 18