ncm-cli setup

🎵 网易云音乐 CLI 一键部署

一键部署网易云音乐 CLI 工具,支持搜索播放、歌单管理,需 Node.js 18+ 及 mpv 播放器配合

收藏
2.7k
安装
1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

ncm-cli-setup 是一个自动化部署脚本,用于安装和配置 ncm-cli——网易云音乐的命令行客户端。该工具支持音乐搜索、播放控制、歌单管理及 TUI 界面操作。

完整安装流程包括四步
1. 环境准备:通过 npm 全局安装 ncm-cli,并检测/安装 mpv 播放器(跨平台脚本自动识别包管理器)

2. API 配置:在网易云音乐开放平台申请 appId 和 privateKey 并配置

3. 播放器选择:可选轻量跨平台的 mpv 或 macOS 专属的 orpheus(网易云音乐客户端)

4. 账户登录:执行登录命令完成授权

显著优点

  • 全平台支持:安装脚本智能识别 macOS/Homebrew、Linux(apt/dnf/pacman)、Windows(winget/Scoop) 等环境
  • 灵活部署:服务器环境可跳过播放器安装,保留搜索/歌单管理等核心功能
  • 双播放器方案:mpv 轻量通用,orpheus 深度集成官方客户端

潜在局限

  • 依赖门槛:需 Node.js >= 18,且 mpv 安装可能因系统权限或网络问题失败
  • API 申请繁琐:必须注册网易云开放平台开发者账号,存在审核周期
  • 登录稳定性:登录超时问题需手动重试,无自动重连机制

适合人群

  • 命令行爱好者、开发者、服务器运维人员
  • 追求轻量化音乐播放的 macOS/Linux 用户
  • 需要后台音乐服务或自动化歌单管理的场景

常规风险

  • npm 全局安装可能引发权限问题,建议使用 nvm 或检查 PATH 配置
  • mpv 安装脚本需 Python 3 环境,部分精简系统可能缺失
  • API Key 涉及个人账户授权,需妥善保管 privateKey

ncm-cli setup 内容

scripts文件夹
手动下载zip · 3.4 kB
install_mpv.pytext/plain
请选择文件