简介这是一份面向macOS用户的QQ音乐QMC格式转换工具源码包可将qmcflac、mflac等格式还原为flac将qmc0、qmc3等转为mp3解决客户端加密音频无法在其他播放器中直接使用的痛点。项目基于Swift开发完整Xcode工程可直接构建运行适合需要批量转换音乐格式的普通用户也适合计算机、软件等专业学生作为Swift桌面开发、加密算法逆向与解码器设计的课设或毕设素材。资源共34个文件包含9个Swift核心源码文件、Xcode工程配置文件、Storyboard界面、资源图片及GIF演示动画压缩包仅946KB目录结构清晰便于阅读。已有1406人学习下载。通过该项目可掌握QMC格式解析、TeaCipher与QMCipher编解码流程以及macOS窗口应用的组织方式同时附有工程配置与演示录屏能帮助快速跑通从源码到可用转换工具的完整链路。1. QMC格式是QQ音乐在macOS上设的一道锁先搞懂再动手把QQ音乐下载的歌曲拖进自带播放器报错、丢进Final Cut Pro直接不识别这就是QMC格式在macOS上给本地文件带来的日常麻烦。qmcflac、qmc0、qmc3、mflac、mflac0这些后缀看着像音频格式实际上并不是编码格式而是QQ音乐客户端本地加密后的一种封装形态原始音频流被逐字节混淆只有自家播放器能解。这套仅支持macOS的QMC格式转换方案要做的就是识别加密类型、还原原始流、改成标准后缀让文件回归普通播放器、剪辑软件都能直接打开的常规格式。适合被QQ音乐下载绑定、又想在macOS上拿回文件自主权的用户也适合想把存量曲库搬进自建音乐库的人。2. 在macOS上准备QMC转换环境ffmpeg、权限与目录规划2.1 为什么这类转换偏爱命令行而不是图形软件macOS上有不少标榜“一键转换”的图形软件但遇到QMC这种小版本迭代勤快的格式GUI工具往往跟不上今天能解的qmcflac下个月QQ音乐客户端一更新同样的文件就提示“不支持该加密版本”。命令行脚本的迭代成本低、逻辑透明出问题能直接看报错定位到哪一步所以常见做法是工具包解压后是一个Python或Shell脚本配合ffmpeg完成解密后的校验。严格来说解密QMC不需要ffmpeg参与转码。QMC文件被还原后里面的原始流本身就是标准的FLAC或MP3数据脚本只需要把解密后的字节流落盘并改对后缀。ffmpeg在这里的角色是“验证者”转换完的文件如果容器头有轻微损坏可以用ffmpeg重新封装修复批量转换后也可以交给ffprobe检查流信息确认每一路输出都正常。所以环境准备阶段先把ffmpeg装上省得后面校验时再回来补。2.2 解压zip包与初始化macOS命令行环境工具包通常以zip形式分发双击会触发macOS的归档实用工具默认解压到当前目录。如果下载的文件被Gatekeeper拦截先用终端处理。# 进入下载目录并解压 cd ~/Downloads unzip QQ音乐QMC格式转换为普通格式(qmcflac转flacqmc0,qmc3转mp3, mflac,mflac0等转flac)仅支持macOS.zip -d qmc-tool cd qmc-tool # 查看包内文件结构 ls -la # 给脚本赋予执行权限 chmod x *.sh 2/dev/null || sudo chmod x *.sh # 检查 macOS 自带 python3 版本 python3 --version # 检查/安装 ffmpeg which ffmpeg || brew install ffmpeg这段命令做了四件事第一用unzip而不是双击解压路径可控避免归档工具在中文文件名上折腾出奇怪编码第二chmod x确保脚本有执行权限macOS从网上下载的文件默认可能没带可执行位第三确认python3存在macOS Mojave之后的系统自带python3但版本可能偏老低于3.8的可以考虑用brew install python升级第四which ffmpeg探测ffmpeg是否已存在不存在则通过Homebrew安装。注意brew install ffmpeg默认包含libmp3lame和libflac两个都和本文场景直接相关。如果你还没装Homebrew先用这条命令装它会同时解决ffmpeg和后续可能需要的Python依赖/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)装完Homebrew后终端会提示你执行两条eval $(/opt/homebrew/bin/brew shellenv)之类的配置命令这是为了让brew的路径进入当前shell环境不执行的话brew install会报“command not found”。Apple Silicon Mac和Intel Mac的brew路径不同前者是/opt/homebrew后者是/usr/local按安装结束后的提示走就行。2.3 规划输入输出目录避免把原文件弄乱QMC转换是文件级别的操作做得不好会把原始加密文件覆盖掉届时想重新下载都找不到原文件。我自己处理时会在工作目录下建三个子目录raw放QQ音乐导出的原始文件out放转换结果log放转换日志。mkdir -p qmc-work/{raw,out,log} mv ~/Music/QQMusic/*.qmcflac qmc-work/raw/ 2/dev/null mv ~/Music/QQMusic/*.qmc0 qmc-work/raw/ 2/dev/null mv ~/Music/QQMusic/*.mflac qmc-work/raw/ 2/dev/null这样规划的好处是转换脚本始终只需要扫描raw目录输出不会污染原目录出问题时对比raw和out能立刻判断是解密失败还是改名错误。另一个附带好处mv命令在同一个卷内是瞬时操作不占额外磁盘空间对动辄几十GB的曲库很友好。如果你的QQ音乐下载目录在别的路径把~/Music/QQMusic替换成实际位置即可。3. qmcflac转flac、qmc0/qmc3转mp3映射规则与最小实操3.1 后缀不是编码格式先识别QMC变体对应的真实音频流QMC系列后缀看着丰富实际对应的原始编码只有两大类FLAC和MP3。这个映射关系是本篇操作的核心依据先记住这张表再动手。原始QMC后缀实际音频编码目标后缀常见出现场景qmcflac / qmc2flacFLAC.flac无损会员下载较老客户端mflac / mflac0 / mflac1 / mflac2FLAC.flac新版客户端无损资源qmc0 / qmc3MP3.mp3标准音质老客户端qmcoggOGG少见.ogg个别特殊资源mgg / mgg1 / mgg0可能为MP3或OGG.mp3/.ogg新版客户端需要进一步探测判断逻辑很简单加密只是改变了字节没改变原始流的格式特征。FLAC文件开头固定是fLaC四个字节MP3文件往往以ID3开头或者以0xFF 0xFB等帧同步字节开头。转换前先看一眼文件头比猜后缀可靠得多# 查看 QMC 文件最初的 16 个字节 xxd raw/01 晴天.qmcflac | head -1 # 输出示例00000000: 8a 6d 1f 2c 3a 55 8b 2e ... # 正常 FLAC 应该以 66 4c 61 43fLaC开头密文状态下是乱码如果文件头不是fLaC或ID3说明它仍处于加密状态后续操作才有意义。反之如果你发现某个文件头已经是fLaC说明客户端可能只改了后缀没加密这种情况直接改名就行不需要走解密流程。这个检查步骤花不了十秒钟但能帮你避掉后续大量无用功。3.2 单文件转换演示qmcflac转flac的完整调用工具包中的核心脚本通常是一个Python解码器它负责读取QMC文件、提取嵌入在文件尾部的密钥、逐字节执行异或还原最后把原始流写入输出文件。调用方式如下# 进入工具包目录把待转换文件放到工作目录的 raw 子目录 cd qmc-tool # 单文件转换示例qmcflac - flac python3 qmc2flac.py \ --input ../qmc-work/raw/01 晴天.qmcflac \ --output ../qmc-work/out/01 晴天.flac # 单文件转换示例qmc0 - mp3 python3 qmc2mp3.py \ --input ../qmc-work/raw/02 告白气球.qmc0 \ --output ../qmc-work/out/02 告白气球.mp3脚本的工作逻辑可以分成四步第一步扫描输入文件头部魔数确认这个文件属于哪个QMC变体第二步读取文件末尾256字节区域从中定位实际密钥段不同版本的QMC在密钥的编码方式上有差异第三步用密钥对文件主体逐字节做异或还原部分变体还需要额外逆一次StegoBox掩码混淆第四步把还原后的字节流写入输出文件再校验文件头是否已经是fLaC或ID3是则改名保留否则报错。这里有两个参数值得注意--input和--output都建议写绝对路径因为Python脚本内部切换目录后相对路径容易错位输出文件名建议保留原文件的歌曲名但后缀必须按本节开头的映射表来改。如果包里的脚本没有--output参数而是自动在当前目录生成同名文件那就在执行前先cd到输出目录避免产物混进脚本目录。3.3 循环批量转换一行命令处理整个目录单个文件验证通过后直接上循环把raw目录下同后缀的文件全部处理掉cd qmc-tool mkdir -p ../qmc-work/out # qmcflac - flac 批量 for f in ../qmc-work/raw/*.qmcflac; do base$(basename $f .qmcflac) python3 qmc2flac.py --input $f --output ../qmc-work/out/$base.flac done # qmc0/qmc3 - mp3 批量 for f in ../qmc-work/raw/*.qmc0 ../qmc-work/raw/*.qmc3; do base$(basename $f) base${base%.qmc0} base${base%.qmc3} python3 qmc2mp3.py --input $f --output ../qmc-work/out/$base.mp3 done这段循环有几个macOS细节第一basename命令剥离后缀时.qmcflac、.qmc0、.qmc3这些都要写全省略点号会导致文件名残留数字第二变量$f和$base必须加双引号QQ音乐的下载文件名几乎都带中文和空格不加引号会被拆成多个参数传给脚本第三执行前先mkdir -p确保输出目录存在Python脚本不会自动创建不存在的目录缺失时直接报FileNotFoundError。如果工具包里的脚本没有区分qmc2flac.py和qmc2mp3.py而是只有一个通用的qmc_decoder.py就用这种方式调用for f in ../qmc-work/raw/*.qmcflac; do base$(basename $f .qmcflac) python3 qmc_decoder.py $f ../qmc-work/out/$base.flac done通用解码器内部会根据输入文件头自动判断输出格式优点是省心缺点是它输出的格式有可能和你预想不一致。比如某个.qmc0文件实际封装的是OGG而不是MP3解码器会忠实输出.ogg这时不要强行改后缀为.mp3后续播放会出怪声。4. QMC转换常见问题与排查macOS下最容易翻车的6个现场4.1 解密后文件头仍不是fLaC或ID3转换静默失败现象脚本执行后没有任何报错输出文件也生成了但用xxd检查文件头发现依旧是乱码双击播放器提示“文件已损坏”。原因最常见是密钥定位偏移出问题。QMC2变体的密钥藏在文件末尾256字节中但新版QQ音乐客户端对某些特殊歌曲启用了不同的密钥长度旧版脚本按固定偏移截取截到的密钥和加密时用的密钥不一致导致异或还原出来的流仍是密文。另一种原因是源文件损坏QQ音乐下载未完成就退出文件本来就缺尾部数据。解决先用ls -l检查源文件大小qq音乐下载的歌曲如果不足200KB且扩展名是qmcflac几乎可以判定下载不完整重新下载就行。文件大小正常的话换更新版本的工具包新版脚本通常针对客户端最新密钥派生逻辑做了适配。修改后重新执行命令不变。4.2 macOS提示“无法打开因为无法验证开发者”现象双击zip里的脚本文件系统弹窗提示无法打开或执行时提示“Operation not permitted”。原因macOS的Gatekeeper对从网络下载的文件附加了com.apple.quarantine扩展属性带有该属性的文件首次执行会触发安全拦截。这个拦截在命令行下表现得比GUI更隐蔽有时候chmod x成功但执行时仍被拒绝。解决# 移除隔离属性 xattr -d com.apple.quarantine qmc2flac.py qmc2mp3.py # 如果脚本目录整体都被隔离可以递归清理 xattr -dr com.apple.quarantine .去掉隔离属性后再执行脚本如果仍然被拦检查一下脚本是不是没有执行权限用ls -l确认权限位中是否有x。没有的话再跑一次chmod x。需要注意xattr -dr会去掉目录下所有文件的隔离标记只对你自己下载的、信任的工具包使用别对来历不明的文件乱跑。4.3 zsh下批量转换报“no matches found”现象按第3章的批量循环命令在终端执行zsh直接报zsh: no matches found: ../qmc-work/raw/*.qmcflac一行命令也没跑。原因macOS从Catalina开始默认shell是zshzsh的glob行为跟bash不一样通配符匹配不到任何文件时bash会把原样字符串传给命令zsh则直接报错终止。如果raw目录里恰好没有这个后缀的文件或者路径写错就会触发这个报错。解决切换为bash执行或者用find替代通配符# 方案一临时切换到 bash bash -c for f in ../qmc-work/raw/*.qmcflac; do echo $f; done # 方案二用 find 保证空目录也不报错 find ../qmc-work/raw -name *.qmcflac -print0 | while IFS read -r -d f; do base$(basename $f .qmcflac) python3 qmc2flac.py --input $f --output ../qmc-work/out/$base.flac done方案二更推荐因为find -print0配合read -d 可以安全处理带空格和换行的文件名IFS防止read把文件名按空格拆词。这是macOS命令行处理中文文件名的标准姿势不只是QMC转换会用到批量处理任何多媒体文件都能复用。4.4 文件名带Emoji或特殊符号导致脚本写文件失败现象QQ音乐某些歌曲名带有特殊Unicode字符比如“旅行的意义Live”脚本执行时报UnicodeEncodeError或输出文件名变成乱码。原因macOS文件系统使用NFD规范化存储中文文件名而脚本内部用python3处理字符串时默认编码是UTF-8两者在遇到特殊符号时可能出现编码不一致。另外部分脚本用print(base)往终端输出日志终端编码不对就会在写文件前就崩掉。解决执行脚本前先显式声明环境变量强制UTF-8输出export PYTHONIOENCODINGutf-8 export LANGzh_CN.UTF-8如果脚本仍然报错最简单的兜底方案是在批量循环里把输出名简化成“序号原扩展名”转换完成后再用macOS自带的“访达”统一改名。工具是为人服务的不要在文件名编码上跟它耗太久。4.5 新版QQ音乐下载的mflac文件用旧脚本解出来的是一堆噪声现象mflac转换成功文件头也是fLaC但播放时全是刺啦刺啦的爆音频谱上看整个声音都碎了。原因新版QQ音乐客户端对部分歌曲启用了加密RC4流异或还原只是第一层解密还需要对字节流做一次RC4逆运算才能得到真正的FLAC数据。旧脚本没有实现这层逻辑只解了第一层掩码。解决确认工具包是否标注支持mgg/mflac1/mflac2后缀这些变体几乎都带RC4二次加密。升级工具包版本新版脚本一般会先用文件尾的256字节判断加密类型再决定走XOR还原还是XORRC4双重还原。如果升级后仍失败可以尝试用ffmpeg强制重新封装一次部分情况能救回可播放的流ffmpeg -i 破损输出.flac -c:a copy 修复输出.flac这条命令不做重编码只是让ffmpeg按照FLAC容器的要求重新写一遍封装头。能修好说明原始流本身是完整的修不好就老老实实换工具版本。4.6 raw目录和out目录在同一个卷下转换后原文件消失了现象转换完成准备清理时发现raw目录里的qmcflac源文件没了。原因脚本处理逻辑里带了“成功后删除源文件”的清理动作或者你没注意为脚本设置了--delete-source参数。这类转换工具为了方便用户清理曲库默认可能会删源而你没有预期到这一步。解决在跑全量转换之前先复制三个样本文件做测试确认输出无误后再放开全部文件。批量命令上方加一行cp做备份更容易后悔药mkdir -p ../qmc-work/backup cp ../qmc-work/raw/*.qmcflac ../qmc-work/backup/ 2/dev/null跑完转换、用播放器抽检几十首之后再考虑是否删除backup目录。几十GB的备份确实占空间但总比曲库全军覆没好。5. 批量转换后的质量校验用ffprobe给每一首歌做体检转换完成不等于工作完成批量场景下必须逐文件验证流信息。QQ音乐下载的歌曲本身来自服务端源文件是完好的出问题几乎都出在解密环节而解密的结果用肉耳很难快速分辨好坏ffprobe能给出客观数据。cd ../qmc-work/out # 递归扫描所有 flac 文件并打印流信息 find . -name *.flac -exec ffprobe -v error \ -show_entries streamcodec_name,sample_rate,channels,bits_per_sample \ -of defaultnoprint_wrappers1 {} \; # 只统计异常文件找不到音频流或编码器异常 for f in $(find . -name *.flac -o -name *.mp3); do codec$(ffprobe -v error -show_entries streamcodec_name \ -of defaultnoprint_wrappers1:nokey1 $f 2/dev/null | head -1) if [ $codec ! flac ] [ $codec ! mp3 ]; then echo 疑似损坏: $f (codec$codec) fi done第一段命令适合抽查它会列出每个文件的编码格式、采样率、声道数和位深一眼就能看出是不是转成了正确的FLAC。第二段命令适合全量巡检它把凡是探测不到音频流的文件都列出来这些文件多半解密失败或输出截断。校验时重点关注两个数字FLAC文件的采样率应该在44100Hz或48000Hz位深16bit或24bitMP3文件的采样率可能是44100Hz或48000Hz。如果看到32000Hz这类非标准采样率说明字节流已经错位播放器能出声但音调是歪的。我在这类转换任务里吃过最大的亏就是没做校验直接同步到手机结果五十多首“转换成功”的歌在车上播放全是噪声最后还得重新回电脑排查。现在的习惯是批量转换完成后强制跑一遍ffprobe巡检把异常文件单独摘出来重新处理确认全部通过后再做后续归档。这样看似多了一步实际省下的重试时间远比一步校验的成本高。如果你打算长期维护曲库建议再加一步用find命令按flac和mp3分目录归档把不同编码的文件分开存放再配合macOS自带的“音乐”App导入。这样做的好处是后续无论用Infuse、Plex还是其他播放器流信息都是规整的不会再出现播放器识别错乱的情况。希望这篇笔记能帮你从QMC的加密泥潭里顺利上岸让下载的歌真正归你所有。本文还有配套的精品资源点击获取