vncmd

网易云音乐 CLI 下载与管理工具。

之前用的下载器不好用了，又找不到其他能嵌入元数据，又方便的工具，所以自己写了一个。

本项目不提供越权操作，下载 VIP 音乐需要确保账号有 VIP 权限。
本项目仅供学习交流，使用本项目获取的数据，请于 24 小时内删除。

GitHub｜PyPI｜Wiki｜cmd_helper｜LICENSE

功能

• 搜索单曲，预览详情与歌词
• 下载单曲/歌单/专辑（使用 Cookie 以下载高音质/VIP）
• 从歌词等来源解析并嵌入元数据
• 以交错/合并/拆分/原始模式处理双语歌词
• 追踪歌单等多来源，自动同步和批量下载
• 支持仅下载歌词/封面
• 并发下载，断点续传，自动重试，完整性校验

以及更多附加功能...

快速开始

pip install vncmd
uv tool install vncmd # 如果你使用 uv，推荐用此
vncmd --init

初次使用，请至少阅读详细指南。
从 0.x 升级请阅读迁移说明。

我制作了命令构造器的交互式页面，希望帮你快速上手。

配置和缓存默认放在 ~/.vSoft/vncmd/，可通过环境变量 VNCMD_HOME 自定义。
下载目录默认 ~/Downloads/vncmd-dl/，在配置文件中可修改。

vncmd 有各种方便的功能，但可能不适合所有用户，因此默认关闭。
请阅读配置来了解功能运作方式，以及配置方法。

# 搜索
vncmd search "Beyond"

# 使用数字曲目 ID，专辑歌单同理。加入 -d 参数即为下载。
# 单曲：song｜歌单：playlist｜专辑：album。
vncmd song 409926           # 预览单曲
vncmd song 409926 -d        # 下载单曲
vncmd playlist 17647459371  # 预览歌单
vncmd playlist 17647459371 -d -c 5  # 下载歌单前 5 首
vncmd album 405493 -d       # 下载专辑

# 设置 Cookie
vncmd cookie "..."

# Tracker
vncmd tracker my-list       # 新建/查看 Tracker
vncmd tracker my-list -f    # 交互式更新

# 其他功能
vncmd tool check ~/Music    # 音频完整性校验
vncmd doctor                # 检查配置

二进制

vncmd 提供不依赖 Python 环境的二进制程序，打包了所有依赖，能够直接运行。
你可以在 GitHub Releases 下载，使用方式与 pip/uv 安装的无差别。