ncmdump - 网易云音乐NCM格式转换工具使用指南
项目地址: https://gitcode.com/gh_mirrors/nc/ncmdump 项目介绍
ncmdump是一个开源项目，专门用于转换网易云音乐的专有格式.ncm文件至通用的.mp3或.flac格式。该项目基于早期的C++版本开发，是市面上第一个支持NCM格式转换的程序。
该版本修复了多个重要问题，包括内存溢出问题和特殊字符文件名的支持，确保中文、日文、韩文等UTF-8字符都能正常解密。项目还提供了动态库libncmdump，便于在C#、Python、Java等多语言项目中的集成。
快速开始
安装方式
通过源码编译安装：
- 克隆项目到本地：
git clone https://gitcode.com/gh_mirrors/nc/ncmdump
- 使用CMake配置并编译：
cmake -DCMAKE_BUILD_TYPE=Release -B build
make
直接下载二进制文件： 可以从项目的发布页面下载对应操作系统的预编译二进制文件。
基本使用方法
转换单个或多个文件：
ncmdump file1.ncm file2.ncm
批量处理文件夹内所有ncm文件：
ncmdump -d path/to/ncm/folder
递归处理子文件夹：
ncmdump -d source_dir -r
删除源文件（处理成功后）：
ncmdump -m
指定输出目录：
ncmdump 1.ncm 2.ncm -o output_dir
功能特性
- 跨平台支持：支持Windows、macOS、Linux等多个操作系统
- 多语言集成：提供动态库支持C#、Python、Java等语言调用
- 完整字符支持：全面支持UTF-8字符，包括中文、日文、韩文等
- 批量处理：支持文件夹批量处理和递归处理
- 灵活输出：支持指定输出目录和保留目录结构
技术实现
ncmdump基于C++开发，使用了以下关键技术：
- AES加密解密：用于处理NCM文件的加密数据
- Base64编码解码：处理元数据信息
- TagLib库：用于音频文件的元数据处理
- 跨平台编译：通过CMake实现多平台构建
应用场景
个人音乐库管理
用户可以将下载的网易云音乐NCM文件批量转换为标准格式，方便在各种播放器和设备上使用。
自动化处理
结合脚本和任务计划程序，可以实现自动监控和转换新下载的NCM文件。
二次开发集成
通过libncmdump动态库，开发者可以在自己的应用中集成NCM转换功能。
注意事项
- 网易云音乐3.0之后的某些版本下载的NCM文件可能不包含专辑封面图片
- Windows环境下开发时，传递到库构造函数的文件名编码必须为UTF-8编码
- 建议使用最新版本以获得最佳兼容性和功能支持
编译说明
Windows环境
需要安装Visual Studio 2022、CMake和vcpkg，然后安装taglib静态库。
macOS环境
使用Homebrew安装taglib库后即可编译。
Linux环境
需要手动编译安装taglib 2.x版本，因为Ubuntu 24.04的仓库版本可能过旧。
项目结构
项目采用标准的CMake工程结构，主要包含：
src/：源代码目录include/：头文件目录lib/：库文件目录example/：使用示例test/：测试文件
ncmdump项目为网易云音乐用户提供了一个强大而便捷的工具，帮助用户摆脱格式限制，自由享受音乐。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
