ncmdump - 网易云音乐NCM格式转换工具使用指南

项目介绍

ncmdump是一个开源项目，专门用于转换网易云音乐的专有格式.ncm文件至通用的.mp3或.flac格式。该项目基于早期的C++版本开发，是市面上第一个支持NCM格式转换的程序。

该版本修复了多个重要问题，包括内存溢出问题和特殊字符文件名的支持，确保中文、日文、韩文等UTF-8字符都能正常解密。项目还提供了动态库libncmdump，便于在C#、Python、Java等多语言项目中的集成。

快速开始

安装方式

通过源码编译安装：

1. 克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/nc/ncmdump

2. 使用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项目为网易云音乐用户提供了一个强大而便捷的工具，帮助用户摆脱格式限制，自由享受音乐。