将 QQ音乐加密文件 (.mflac) 一键转换为 MP3 / FLAC — 图形界面版
TuneFree 是一款专为 QQ音乐下载的加密音频文件设计的转换工具。它能够自动解密文件，并将其转换为通用的 MP3 格式，同时支持保留无损 FLAC 格式。最新版本提供了图形界面 (GUI)，操作更直观，无需记忆命令行参数。你也可以继续使用命令行版本获得最大灵活性。
- 图形界面 可视化设置输入目录、输出模式、比特率、输出格式，实时显示命令预览和运行日志。
- 三种输出格式 仅 MP3、仅 FLAC、两者均保留，满足不同需求。
- 两种输出模式 根目录模式（自动创建 mp3/flac 子文件夹）或独立目录模式（完全自定义输出路径）。
- 一键转换 双击运行，自动处理当前文件夹（及子文件夹）中的所有
.mflac文件。 - 实时进度 处理过程中实时显示解密和转码进度，日志窗口实时刷新。
- 轻量便携 单个
.exe文件，无需安装，内置 ffmpeg 和必要的解密脚本。
- 操作系统: Windows 10 / 11（64位）
- 运行环境: 必须提前启动 QQ音乐电脑客户端 并保持运行状态（程序需要注入进程进行解密）。
- 磁盘空间: 至少 100MB 可用空间（用于临时文件），输出文件大小取决于音频时长。
⚠️ 重要: 解密过程依赖 QQMusic.exe 进程，如果未启动程序，会提示“请确保QQ音乐客户端正在运行后重试”并退出。所以，请务必先打开 QQ音乐客户端 ，再运行本工具。
⚠️ 重要: 请确保程序所在路径为纯英文，否则程序可能无法正常运行。
启动 TuneFreeGUI.exe 后，你会看到以下界面区域：
- 参数设置：选择输入目录、输出模式、MP3比特率、输出格式（仅MP3/仅FLAC/两者）。
- 输出模式：根目录输出（自动创建 mp3/flac 子文件夹）或独立输出目录（分别指定MP3和FLAC输出位置）。
- 执行预览：实时显示即将执行的命令行，便于核对。
- 运行日志：显示转换过程中的详细信息（解密进度、转码进度、错误信息）。
- 按钮：
开始执行启动转换，清空日志清除日志窗口，帮助打开本说明文档。
操作步骤：
- 点击“浏览”选择包含
.mflac文件的文件夹（留空则使用程序所在目录）。 - 选择输出模式（建议根目录模式），如需自定义则勾选“使用独立输出目录”。
- 设置 MP3 比特率（默认 192k）。
- 选择输出格式（仅 MP3 / 仅 FLAC / 两者均保留）。
- 点击“开始执行”，耐心等待转换完成。
- 转换完成后，在输出目录中找到生成的文件。
若文件数量较多，转换时间可能较长，请耐心等待，转换过程中不要关闭程序窗口。
- 读取文件：自动扫描输入目录中的所有 .mflac 文件
- 解密为 FLAC：通过 Frida 注入 QQMusic 进程，解密为 FLAC
- 转码 MP3：调用 ffmpeg 将 FLAC 转换为 MP3
- 输出文件：根据选择，输出 MP3 和/或 FLAC 到指定目录
程序自动处理，实时显示进度
- **启动 QQ音乐：**打开 QQ音乐客户端，登录你的账号，保持它在后台运行（不需要播放歌曲）。
- **双击运行 GUI：**双击
TuneFreeGUI.exe，按上述操作设置参数并点击“开始执行”。 - **查看结果：**转换完成后，在输出目录中找到生成的音频文件。
如果你需要更灵活的控制（如脚本批量处理），也可以直接使用命令行版本 TuneFree.exe。图形界面的所有功能均可通过命令行实现，参数说明如下：
| 参数 | 说明 | 示例 |
|---|---|---|
-i 或 --input |
指定输入目录（默认为当前目录） | TuneFree -i "D:\音乐\专辑" |
-o 或 --output |
指定输出根目录（默认为当前目录下的 output），其下自动创建 mp3 子文件夹；若同时使用 --keep-flac，还会创建 flac 子文件夹 |
TuneFree -o "E:\转换结果" |
--flac-dir |
独立指定 FLAC 输出目录（仅在 --keep-flac 时有效） |
TuneFree --keep-flac --flac-dir "D:\FLAC库" |
--mp3-dir |
独立指定 MP3 输出目录（覆盖默认） | TuneFree --mp3-dir "D:\MP3库" |
-b 或 --bitrate |
设置 MP3 比特率，可选 128k、192k、320k 等（默认 192k） |
TuneFree -b 320k |
--keep-flac |
保留解密后的 FLAC 文件（默认不保留） | TuneFree --keep-flac |
--no-mp3 |
不生成 MP3，仅保留 FLAC（忽略 --keep-flac） |
TuneFree --no-mp3 |
示例组合：
TuneFree -i "D:\下载" -o "D:\我的音乐" -b 320k --keep-flac
这条命令会处理 D:\下载 中的所有 .mflac 文件，输出MP3到 D:\我的MP3 文件夹，并保留 FLAC 到 D:\我的音乐\flac，MP3 比特率为 320kbps。
由于程序使用了 Frida 动态注入技术（用于与 QQ音乐进程通信），部分杀毒软件可能会误报为风险程序。这是正常现象，请将 TuneFree.exe 和 TuneFreeGUI.exe 添加至杀毒软件的信任区，或暂时关闭杀毒软件后再运行。
解密过程依赖 QQMusic.exe 进程，如果未启动程序，会提示“未找到 QQMusic.exe 进程”并退出。请务必先打开 QQ音乐客户端。
程序会自动保留原文件名（仅扩展名变为 .flac 和 .mp3）。如果文件名包含特殊字符（如 &、[），也能正常处理。
默认只输出 MP3，所需空间较小。如果使用 --keep-flac，FLAC 文件约为原 MFLAC 大小，MP3 约为其 1/5 到 1/3，请预留足够空间。
本工具仅供解密个人合法购买的 QQ音乐文件，请勿用于传播或商业用途。使用本工具产生的法律责任由用户自行承担。
-
Q: 运行后提示“未找到 QQMusic.exe 进程”
A: 请确保 QQ音乐客户端已启动并保持运行。如果已启动仍报错，尝试以管理员身份运行TuneFreeGUI.exe。 -
Q: 解密失败，提示
invalid size或类似错误
A: 可能是 QQ音乐更新了加密算法，导致内置的hook_qq_music.js不兼容，可以联系我们处理。 -
Q: 转换后的 MP3 音质不佳
A: 默认比特率为192k，可在 GUI 中或命令行通过-b 320k参数提高音质。更高的比特率会生成更大的文件。 -
Q: 可以处理子文件夹中的文件吗？
A: 可以。程序会递归遍历输入目录下的所有子文件夹，找到所有.mflac文件进行处理。 -
Q: 程序运行时弹出命令行窗口，可以隐藏吗？
A: GUI 版默认隐藏命令行窗口，仅显示图形界面。命令行版会显示窗口以显示进度。 -
Q: 如何保留 FLAC 文件？
A: 在 GUI 中选择输出格式“两者均保留”，或在命令行中使用--keep-flac参数。 -
Q: 可以只输出 FLAC 而不输出 MP3 吗？
A: 可以，在 GUI 中选择输出格式“仅 FLAC”，或在命令行中使用--no-mp3参数。
TuneFree 的诞生离不开以下优秀的开源项目和贡献者，在此表示诚挚的感谢：
- Frida：强大的动态代码注入框架，使解密过程能够与 QQMusic 进程无缝交互。
- FFmpeg：业界领先的多媒体处理工具，负责将 FLAC 高效转换为 MP3。
- music-decryptor：由 ericjuice 开发的 QQ音乐解密工具，提供了核心解密脚本
hook_qq_music.js。 - PyInstaller：将 Python 脚本打包成独立可执行文件的利器，让 TuneFree 能够轻松分发。
- Python：程序的编写语言，让这一切有可能。
- 解锁音乐社区 (Unlock Music)：众多逆向爱好者的共同努力，使得 QQ音乐等平台的加密格式得以解析。
- DeepSeek：为实际资源整合中遇到的技术问题提供了解决思路以及方法、本说明文档框架的搭建以及内容的编写。
- 豆包：提供了程序图标、参与了起名工作。
- 花红大裤衩：参与了测试工作。
- 陌离：提供了初版GUI程序。
- Sparkle: 少数情况下，下载的歌曲需要先播放一遍才能正常转码。
- Github：发行平台。
感谢所有开源贡献者的智慧和付出，让技术真正服务于自由与分享。
如果你在使用过程中遇到任何问题，或有改进建议，请联系发行者：
📧 邮箱：2505923037@qq.com
🐧 QQ群：1067975918
🐙 GitHub：https://github.com/zksbx/TuneFree
感谢使用 TuneFree，祝你听歌愉快！ 🎧
© 2026 曾 · 使用说明 v1.1