Metadata-Version: 2.4
Name: vncmd
Version: 1.0.1
Summary: NetEase Cloud Music CLI Tool — search, preview, download, and tracker.
Author-email: Vanadiry <v@vanadiry.com>
License-Expression: AGPL-3.0-or-later
Project-URL: Documentation, https://magic.vanadiry.com/wiki/vncmd
Project-URL: Repository, https://github.com/Vanadiry/vncmd
Keywords: cli,download,lyrics,metadata,music,netease
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: filelock>=4.2.0
Requires-Dist: mutagen>=1.48.1
Requires-Dist: pillow>=12.3.0
Requires-Dist: prompt-toolkit>=3.0.53
Requires-Dist: questionary>=2.1.1
Requires-Dist: requests>=2.34.2
Requires-Dist: rich>=15.0.0
Requires-Dist: tzdata>=2026.5
Dynamic: license-file

# vncmd

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

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

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

[GitHub](https://github.com/Vanadiry/vncmd)｜[PyPI](https://pypi.org/project/vncmd/)｜[Blog](https://magic.vanadiry.com/wiki/vncmd/)｜[LICENSE](LICENSE)

## 功能

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

以及更多附加功能...

## 快速开始

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

初次使用，请至少阅读[详细指南](doc/guide.md)。
从 0.x 升级请阅读[迁移说明](MIGRATION.md)。

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

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

```bash
# 搜索
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 提供不依赖 Python 环境的二进制程序，打包了所有依赖，能够直接运行。  
你可以在 [GitHub Releases](https://github.com/Vanadiry/vncmd/releases) 下载，使用方式与 pip/uv 安装的无差别。
