QMC Decoder 安装和配置指南

1. 项目基础介绍和主要的编程语言

项目基础介绍

QMC Decoder 是一个用于将 QQ 音乐的 QMC 格式加密音频文件转换为标准 MP3 或 FLAC 格式的开源工具。该项目采用高效的解密算法，能够快速处理 QMC3、QMC0 和 QMCFLAC 格式的音频文件，帮助用户摆脱平台限制，自由使用音乐文件。

主要的编程语言

该项目主要使用 C++ 编程语言进行开发，利用 C++ 的高性能和底层操作能力实现音频文件的快速解码处理。

2. 项目使用的关键技术和框架

关键技术

• C++17 标准：项目采用现代 C++ 标准，使用智能指针、STL 容器等特性
• 自定义解密算法：通过 seed.hpp 中的种子映射表实现 QMC 文件的解密
• 跨平台文件系统操作：使用 ghc::filesystem 库处理不同操作系统的文件路径
• 正则表达式匹配：自动识别和分类不同格式的 QMC 文件

框架和依赖

• CMake：跨平台构建系统，支持 Linux、macOS 和 Windows
• ghc::filesystem：C++17 文件系统库的向后兼容实现
• 标准 C++ 库：使用 iostream、regex、vector 等标准库组件

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统已经安装了以下工具和依赖：

基础要求：

• Git：用于克隆项目仓库
• CMake 2.9 或更高版本：用于构建项目
• C++ 编译器：GCC、Clang 或 MSVC

各平台额外要求：

• Linux：安装 build-essential 或相应开发工具包
• macOS：安装 Xcode Command Line Tools 和 Homebrew
• Windows：安装 Visual Studio 或 MSVC 编译器

安装步骤

1. 克隆项目仓库

使用 Git 克隆 QMC Decoder 项目到本地：

git clone https://gitcode.com/gh_mirrors/qm/qmc-decoder.git
cd qmc-decoder

2. 初始化子模块

项目依赖于文件系统子模块，需要初始化：

git submodule update --init

3. 创建构建目录

创建专门的构建目录以避免污染源代码：

mkdir build
cd build

4. 配置和构建项目

使用 CMake 配置项目并进行编译：

Linux/macOS：

cmake ..
make

Windows：

cmake -G "NMake Makefiles" .. -DCMAKE_BUILD_TYPE=Release
nmake

5. 验证构建结果

构建完成后，在 build 目录下会生成可执行文件 qmc-decoder（Linux/macOS）或 qmc-decoder.exe（Windows）。

4. 使用方法和示例

命令行使用

将构建好的可执行文件复制到包含 QMC 文件的目录中，然后运行：

# 转换单个文件
./qmc-decoder /PATH/TO/SONG.qmc3

# 批量转换当前目录所有 QMC 文件
./qmc-decoder

支持的文件格式

• .qmc3 → .mp3
• .qmc0 → .mp3
• .qmcflac → .flac
• .qmcogg → .ogg

使用示例

假设您有一个音乐文件 song.qmc3，运行以下命令进行转换：

./qmc-decoder song.qmc3

转换完成后会在同目录生成 song.mp3 文件。

5. 项目结构说明

qmc-decoder/
├── CMakeLists.txt    # CMake 构建配置文件
├── src/
│   ├── decoder.cpp   # 主程序文件，包含解密逻辑
│   └── seed.hpp      # 解密种子定义文件
├── 3rdparty/
│   └── filesystem/   # 文件系统库依赖
└── README.md         # 项目说明文档

6. 常见问题解决

构建问题

• CMake 找不到：请安装 CMake 并确保在 PATH 中
• 编译器错误：检查编译器版本是否支持 C++11 或更高标准
• 文件权限问题：确保对目标目录有读写权限

使用问题

• 转换失败：检查输入文件是否为有效的 QMC 格式
• 输出文件不存在：检查磁盘空间和文件权限

7. 技术原理简介

QMC Decoder 使用预定义的种子映射表对加密的音频数据进行异或运算解密。核心算法在 seed.hpp 中实现，通过特定的位移和索引计算生成解密掩码，然后与原始数据逐字节进行异或操作，恢复出原始的音频数据。

通过以上步骤，您可以成功安装和配置 QMC Decoder 项目，开始解码 QQ 音乐的加密音频文件。该工具简单易用，转换速度快，是处理 QMC 格式文件的理想选择。