Skip to main content

vncmd

网易云音乐 CLI 下载工具。

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

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

GitHub|PyPI|Blog

功能

  • 搜索单曲(同时支持预览歌词)
  • 下载单曲/歌单/专辑(元数据嵌入、Cookie 高音质/VIP)
  • 以交错/合并/原始模式处理双语歌词
  • 追踪歌单等多来源,自动同步和批量下载
  • 支持仅下载歌词/封面
  • 并发下载,断点续传,自动重试,完整性校验
  • 歌词增强解析,以及附加修正功能

快速开始

pip install vncmd
vncmd init

初次使用,请至少阅读详细指南。

配置和缓存默认放在 ~/.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 -n 5  # 下载歌单前5首
vncmd album 405493 -d       # 下载专辑

# 设置 Cookie
vncmd cookie "..."

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

# 音频完整性检查
vncmd check ~/Music

二进制

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

Metadata

Release files for vncmd 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vncmd 0.4.1
File Size Uploaded
vncmd-0.4.1.tar.gz 41.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vncmd 0.4.1
File Interpreter ABI Platform
vncmd-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 88.6 kB

Release files / vncmd-0.4.1.tar.gz

Download URL vncmd-0.4.1.tar.gz
Size 41.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b1edf14c8d1b6b2b321ab9835553edd94f2c41397b6f8e59467104f6897c1c0a
BLAKE2b-256 checksum
How to use checksums
1ccb267268626ae8b8bfa404e1c24f2419ef99cc7c62c44440dce81fe62137ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / vncmd-0.4.1-py3-none-any.whl

Download URL vncmd-0.4.1-py3-none-any.whl
Size 47.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7e5e75a019e770f75f2d23ed12a259722c30fe0a16c43386ce04ca77e51be12c
BLAKE2b-256 checksum
How to use checksums
ec2b7e1b4b10bb8b74ef16cc07ed090d76a82d5a4179a676503a13993f715e2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

0.4.2

2 release files

This release

0.4.1 This release

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.7

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page