NCMconverter 使用指南

项目概述

NCMconverter 是一个开源工具，它能够将网易云音乐的 .ncm 文件转换为常见的 .mp3 或 .flac 格式。该项目借鉴了 yoki123/ncmdump 的实现，经过重构并加入了多线程支持，以提升转换效率。

项目目录结构及介绍

下面是 NCMconverter 项目的基本目录结构说明：

NCMconverter/
├── converter      # 转换逻辑相关的源码文件
│   └── ...        # 具体的转换处理函数等
├── gitignore      # Git 忽略文件
├── LICENSE        # 开源许可证文件，遵循 GPL-3.0 许可证
├── README.md      # 项目说明文档，包括基本使用方法
├── go.mod         # Go项目的依赖管理文件
├── go.sum         # Go依赖的校验文件
├── main.go        # 主入口文件，程序启动的地方
└── makefile       # 构建脚本，用于简化编译过程

• converter: 包含所有与 ncms 文件转换相关的功能实现。
• gitignore: 列出了在提交时不希望被Git跟踪的文件类型或文件。
• LICENSE: 明确了项目使用的许可协议。
• README.md: 用户指南，提供了安装和基本使用步骤。
• go.mod 和 go.sum: Go语言特有的依赖管理和安全验证文件。
• main.go: 应用程序的主要入口点，负责调用转换逻辑并启动程序。
• makefile: 方便开发者通过简单的命令执行构建、测试等操作。

项目的启动文件介绍

• main.go

主程序文件，其中包含了程序初始化和执行流程的控制逻辑。当你运行这个程序时，它会根据提供的命令行参数来执行 .ncm 文件的转换工作。用户通过指定不同的命令行选项来控制输出目录、是否添加元数据、搜索文件的深度以及并行处理的线程数等。

项目的配置文件介绍

NCMconverter 本身不直接使用传统意义上的配置文件。它的配置主要是通过命令行参数进行设置的。以下是主要的命令行参数示例：

• -o 或 --output: 指定转换后音频文件的输出目录，默认情况下，输出文件保存在原音频文件的同一目录下。
• -t 或 --tag: 尝试添加元数据至转换后的文件（注意，存在已知bug，可能不可用）。
• -d 或 --depth: 搜索目录的深度，决定了从当前目录开始查找ncm文件的层次，默认为0，即只搜索当前目录。
• -n 或 --thread: 设置转换时使用的线程数量，优化转换速度。
• -h 或 --help: 显示帮助信息。
• -v 或 --version: 显示软件的版本信息。

由于没有独立的配置文件，这些设置需在每次执行命令时指定或调整。用户可以根据实际需求，通过终端直接输入这些参数来定制转换行为。