vncmd 0.1.7

NetEase Cloud Music CLI Tool — search, preview, download, and tracker.

项目尚未完成，功能和调用方式可能随时变化，请知悉。

vncmd，网易云音乐 CLI 下载工具。
之前用的下载器不好使了，又找不到其他能嵌入元数据，还方便的工具，所以自己造了一个。

本项目不提供越权操作，如果你想下载 VIP 音乐，那你要确保你是 VIP。
本项目仅供学习交流，严禁用于商业用途。使用本项目获取的数据，请于 24 小时内删除。

功能

• 搜索单曲（同时支持预览歌词）
• 下载单曲/歌单/专辑（支持元数据嵌入，支持使用 Cookie 下载高音质/会员曲目）
• 以交错/合并/原始模式处理双语歌词
• 追踪歌单等多来源，自动同步和批量下载
• 支持仅下载歌词/封面
• 断点续传，下载列表时自动记录进度

快速开始

确保你已安装好Python，并配置了环境变量。
如果运行pip和python时提示找不到命令，尝试改为pip3和python3。
克隆项目之后，确保 cd 到项目文件夹里。

# 克隆项目
git clone https://github.com/Vanadiry/vNetEaseMusicDownloader.git
cd vNetEaseMusicDownloader

# 安装
pip install .

# 搜索
vncmd search "Beyond"

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

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

基本命令

读完下面的部分，建议再完整看下 doc/command，和 doc/config。

命令	说明
search <关键词>	搜索单曲
song <ID>	预览单曲
playlist <ID>	预览歌单
album <ID>	预览专辑
tracker <名称>	新建/查看追踪

对于 song/playlist/album 的参数：

• -d：后面加入 -d 即为下载。
• -n：使用 -n <数字> 可以限制下载或查询的数量。 若不加这个参数，查询模式默认为 10，下载模式默认为全量。

追踪列表

tracker 功能用来方便地追踪和同步歌单。

这功能类似 Git，本地储存了一份追踪列表，里面记录了歌单信息。
你可以拉取远端歌单，并手动解决和本地的冲突（当然了，也可以完全镜像远端）。
你可以创建多个追踪列表，并且每个列表里可以任意记录单曲、歌单、专辑，没有限制。

使用 vncmd tracker [名称] 来新建一个追踪列表。若列表存在，这个命令会输出列表简介。
然后编辑 tracker/<名称>/settings.toml 填入要追踪的单曲/歌单/专辑 ID 即可。

命令：

• -f：拉取，交互式解决冲突。
• --fetch-auto：镜像远端列表。
• -d：下载追踪列表中的全部曲目。
• -d --diff：下载自上次拉取以来新增的曲目。

Cookie

下载 VIP 曲目，或者更高音质内容，需要 Cookie。
请自行搜索如何获取 Cookie，并将获取到的内容复制到 config/cookie 文件中。

如何获取 ID

单曲、歌单、专辑的 ID，均位于链接的 id 参数内。
就像这样：https://.../song?id=409926。

如果你用官方的客户端，在客户端使用分享，分享链接。拿到的链接里应当有 id 参数。
对于手机客户端，链接可能是短链。你可以把链接复制到浏览器打开，待浏览器跳转之后，复制地址栏的链接。 对于网页版，直接在地址栏就能看到了。

其他

预览和下载内容时，会在预设目录 cache/ 中写入缓存。
你可以删掉这个文件夹，下次运行时仍会自动创建。