QMC Decoder 安装和配置指南

2026-02-06 04:32:43作者：宣利权Counsellor

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         # 项目说明文档