ypshidifu 3af7501b47 修复 vipsong.py 多处错误
1. 修复 Line 277 语法错误:output_path")" 多余引号导致的 SyntaxError
2. 添加缺失的 META_KEY 常量(NCM 元数据 AES 密钥,16 字节)
3. 添加缺失的 KUGOU_KEY_PATH 常量(指向 kugou_key.xz)
4. 添加缺失的 stats 和 kgm_decoder 模块级初始化
5. 添加缺失的 import io(用于 _convert_audio 的 BytesIO)
6. 添加缺失的 _sniff_container 函数(音频容器魔术字节检测)
7. 添加缺失的 _extension_for 函数(格式到扩展名映射)
8. 添加缺失的 _convert_audio 函数(原始音频转码)
9. 修复 print("\n") 为 print()(恢复更清洁的输出格式)
2026-09-17 13:22:49 +08:00
2026-09-17 13:22:49 +08:00

vipsong - 酷狗/网易云音乐加密格式转码工具

CLI 工具,将酷狗加密格式 (.kgm/.kgma/.vpr) 和网易云加密格式 (.ncm) 解密转码为常见音频格式。

安装依赖

pip install -r requirements.txt

确保系统已安装 FFmpeg(用于格式转换)。

酷狗密钥

首次使用前,需获取酷狗密钥文件 kugou_key.xz:

curl -o kugou_key.xz https://raw.githubusercontent.com/HRuiCcc/music-geshizhuanhuan/master/assets/kugou_key.xz

使用方法

命令行模式

python vipsong.py .ncm python vipsong.py ./music/song.kgm python vipsong.py .ncm -f flac -d python vipsong.py song.ncm -d python vipsong.py ./downloads/.ncm ./music/.kgm

交互模式

python vipsong.py

vipsong> *.ncm # 转换当前目录全部 ncm 文件 vipsong> ./xx/xx/xx.kgm # 转换指定 kgm 文件 vipsong> song.ncm -d # 转码后删除原 ncm 文件 vipsong> /get # 查看转码统计 vipsong> /exit # 退出

命令说明

命令/参数 说明
*.ncm 转换当前目录全部 ncm 文件
./xx/xx/xx.kgm 转换指定路径的文件
-f <格式> 指定输出格式:mp3/flac/wav/ogg/m4a/original(默认 mp3)
-d 转码成功后删除原加密文件
/exit 退出交互模式
/get 显示转码统计(成功数、失败数、文件列表)

支持格式

输入格式 说明 输出格式
.ncm 网易云音乐加密格式 mp3/flac/wav/ogg/m4a
.kgm/.kgma/.vpr 酷狗音乐加密格式 (v3/v4) mp3/flac/wav/ogg/m4a

注意

  • 转换后保留原始 ID3 标签(歌名、艺术家、专辑、封面)
  • KGM 格式需要 kugou_key.xz 密钥文件(存放在项目根目录)
  • 仅支持 KGM v3/v4,v5 需要客户端密钥暂不支持
S
Description
No description provided
Readme
224 KiB
Languages
Python 76.3%
HTML 23.7%