qmc-decoder：QMC加密音乐格式转换工具，实现音频文件的自由播放与管理

价值定位：重新定义加密音乐文件的可用性

在数字音乐收藏管理中，QMC加密格式（如QMC3、QMC0、QMCFLAC）常因版权保护机制限制了文件的跨平台使用。qmc-decoder作为一款轻量级命令行工具，通过高效的XOR位运算解密算法，将加密音频文件转换为通用的MP3、FLAC或OGG格式，解决了加密音乐在多设备间播放、音频编辑处理及长期归档存储等核心需求。

[!NOTE] 本工具仅用于个人合法拥有的音频文件解密，使用前请确保遵守相关版权法规。

技术解析：解密核心与实现原理

核心解密机制

qmc-decoder采用种子密钥动态生成技术，通过预设的种子序列（seed.hpp中定义）与加密文件数据进行逐字节异或运算。核心解密逻辑位于sub_process函数中，其工作流程如下：

1. 读取加密文件到内存缓冲区
2. 初始化种子生成器（seed_对象）
3. 对每个字节执行buffer[i] = seed_.next_mask() ^ buffer[i]运算
4. 将解密后的数据写入目标格式文件

格式识别与转换规则

工具通过正则表达式自动识别文件类型：

• qmc3|qmc0 → 转换为MP3格式
• qmcflac → 转换为FLAC无损格式
• qmcogg → 转换为OGG格式

文件系统操作采用C++17标准的filesystem库（或ghc/filesystem兼容层），确保跨平台文件处理的一致性。

场景实践：从安装到高级应用

环境准备与安装

[!TIP] 编译前请确保系统已安装CMake 3.10+和C++17兼容编译器（GCC 7+或Clang 5+）

Linux/macOS系统：

# 获取源码
git clone https://gitcode.com/gh_mirrors/qm/qmc-decoder
cd qmc-decoder

# 初始化子模块
git submodule update --init

# 编译构建
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)  # 使用所有可用CPU核心加速编译

Windows系统（需MSVC 2017+环境）：

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

mkdir build && cd build
cmake .. -G "Visual Studio 16 2019"
msbuild qmc-decoder.sln /p:Configuration=Release

基础使用场景

单文件解密：

# 解密单个QMC3文件
./qmc-decoder ~/Music/encrypted/song.qmc3
# 输出：生成同目录下的song.mp3

批量处理整个目录：

# 递归处理Music目录下所有QMC文件
./qmc-decoder ~/Music/collection
# 输出：所有解密文件保存在原文件相同位置

进阶应用案例

1. 音乐库自动化整理 结合shell脚本实现解密+格式转换+元数据整理的工作流：

#!/bin/bash
find ~/Music/qmc_files -name "*.qmc*" | while read file; do
  ./qmc-decoder "$file" && \
  mv "${file%.*}.*" ~/Music/library/ && \
  echo "Processed: $file"
done

2. 媒体服务器集成 在Plex/Emby媒体服务器中配置自动解密服务：

1. 将qmc-decoder部署为系统服务
2. 监控下载目录新文件
3. 自动解密后移动到媒体库目录

[!TIP] 使用inotifywait工具监控文件系统变化，实现实时解密：

inotifywait -m -r -e create ~/Downloads | while read dir events file; do
  if [[ $file == *.qmc* ]]; then
    ./qmc-decoder "$dir/$file"
  fi
done

扩展指南：开发者视角

代码结构与扩展点

项目核心代码位于src/目录：

• decoder.cpp：主程序逻辑，包含文件处理与解密流程
• seed.hpp：种子密钥生成算法

主要扩展方向：

• 新增加密格式支持：修改正则表达式与对应的解密算法
• 元数据修复：集成taglib库添加MP3/FLAC标签信息恢复
• GUI界面开发：基于Qt或Electron封装图形化操作界面

性能优化建议

对于大规模音乐库处理，可考虑：

1. 实现多线程并行解密（当前为单线程处理）
2. 添加文件缓存机制避免重复处理
3. 优化内存使用，支持大文件流式处理

常见问题排查

• 权限错误：确保对输入文件有读取权限，输出目录有写入权限
• 格式识别失败：检查文件扩展名是否符合qmc3/qmc0/qmcflac/qmcogg规范
• 编译错误：确认编译器支持C++17标准，子模块已正确初始化

通过qmc-decoder，用户可以突破加密格式限制，实现音频文件的自由管理与跨平台使用。无论是个人音乐收藏整理，还是媒体服务构建，这款工具都能提供高效可靠的技术支持。