8000 GitHub - zksbx/TuneFree: mflac / mgg 转 FLAC、MP3 — 解密 QQ音乐加密歌曲,全程本地、不上传 · GitHub
[go: up one dir, main page]

Skip to content
zksbxPublic

About

mflac / mgg 转 FLAC、MP3 — 解密 QQ音乐加密歌曲,全程本地、不上传

Topics

Resources

Stars

185 stars

Watchers

1 watching

Forks

Repository files navigation

TuneFree

把 QQ音乐下载的加密歌曲(.mflac / .mgg)一键变成任何播放器都能放的 MP3 或 FLAC。

Release Downloads Stars License Platform QQ群

不需要会员,不需要上传,全程在你自己的电脑上完成。

⬇️ 下载最新版 · 🌐 官网与使用帮助 · ☁️ 蓝奏云备用下载(提取码 0211)· 💬 QQ 群:1067975918 · English


它解决什么问题

在 QQ音乐里下载的部分歌曲是加密格式:

后缀 实际内容 常见场景
.mflac 加密的 FLAC(无损) 无损音质下载
.mgg 加密的 OGG 部分版权歌曲

这些文件只有 QQ音乐能放,拷到车机、MP3、其他播放器里全是「格式不支持」。

TuneFree 做的事很简 8000 单:在 QQ音乐进程内调用它自己的解密函数,把文件还原成正常的 FLAC/OGG,再用 FFmpeg 转成 MP3。

.mflac / .mgg  ──解密──▶  .flac / .ogg  ──转码──▶  .mp3

三步就能用

  1. 打开 QQ音乐并登录,保持运行(不用播放歌曲)
  2. 双击 TuneFree.exe,选择存放 .mflac或.mgg 文件的目录
  3. 点「开始执行」,等进度跑完,去输出目录拿 MP3

转换出来的文件名和原曲一致,可以直接拷进手机或车机。

赞赏

TuneFree 完全免费,没有广告,也不会做任何限制功能来收费。如果 TuneFree 确实帮到了您,您可以选择请作者喝杯奶茶:

左边微信赞赏码,右边支付宝收款码

不想花钱也完全没关系——点个 Star 或者把它告诉需要的人,同样是很大的帮助。

是不是病毒?先看这个

上一版 v2.0.0 于 2026-06-30 发布,到 2026-10-31 在蓝奏云上被下载了 3660 次(数字由蓝奏云后台统计,作者改不了)。几千个人装过、用过的工具,真有问题是藏不住的。

蓝奏云后台截图(2026-10-31):TuneFree-2.0.0.exe 下载量 3660

程序确实会被杀软报警——因为它用 Frida 往 QQ音乐进程里注入代码,这个动作和恶意软件一模一样。区别在于源码全部公开,你可以自己看它在做什么。

功能

  • 🎵 支持 .mflac / .mgg 批量解密,自动递归子文件夹
  • 🎚 三种输出:只要 MP3、只要无损 FLAC、或者两个都留
  • ⚡ 断点续跑:中途关掉,重跑会跳过已经完成的文件
  • 📊 实时进度条,卡在哪一步一目了然
  • 🔔 自动检查更新
  • 🔒 不联网、不上传,除了检查更新不会连接任何服务器

系统要求

  • Windows 10 / 11 64 位
  • QQ音乐客户端(需要登录)
  • 歌曲音质只支持「标准 / HQ / SQ」三档。Hi-Res(臻品音质)、臻品母带、杜比全景声这类格式不在支持范围内,解密会失败。

常见问题

双击提示「Windows 已保护你的电脑」,蓝色窗口不让运行

那是 SmartScreen 的「未知发布者」提示,不是报毒——没买代码签名证书的 exe 第一次运行都会被拦。

蓝窗口里点「更多信息」,再点右下角「仍要运行」。同一份文件点一次就够。

杀毒软件报毒怎么办?

程序用 Frida 往 QQ音乐进程里注入代码——这个行为本身就跟病毒一模一样,所以杀软基本都会报。

解决办法:把 TuneFree 目录加入杀软信任区。源码完全公开,你可以自己看每一行在做什么。

提示「请确保 QQ音乐客户端正在运行后重试」

先把 QQ音乐打开并登录,再点开始。解密依赖 QQ音乐进程里的密钥,它没运行就没有密钥可用。

解密报 invalid size 或「QQ音乐版本不匹配」

QQ音乐更新后改了内部函数名,当前版本注入不进去。

  • 把 QQ音乐降级到已知可用的版本,或者
  • 等 TuneFree 适配新版本(关注 Release)

解密成功,但转 MP3 全部失败

多数是安全软件禁止 ffmpeg.exe 创建文件。程序会自动改用「管道输出 + 由程序落盘」的方式重试,通常能过。

如果还是失败,把 TuneFree 目录加入信任区再试。

有少数歌死活转不出来

先看音质。程序只支持 标准 / HQ / SQ 三档,如果这首歌在 QQ音乐里下的是 Hi-Res(臻品音质)、臻品母带、杜比全景声,拿到的就不是普通音频流,转换必然失败——把那首歌的音质改成 SQ 或更低,重新下载一次即可。

确认是标准 / HQ / SQ 还转不出来,多半需要先在 QQ音乐里播放一遍,让它完成解密加载,再运行 TuneFree。

支持 Mac / Linux 吗?

暂时只有 Windows。核心逻辑不依赖 Windows,但注入目标 QQ音乐只有 Windows 版。

从源码运行

# 1. 装依赖
pip install -r requirements.txt

# 2. 把 ffmpeg.exe 放到本目录(程序会在这个目录找它)
#    Windows 版下载:https://www.gyan.dev/ffmpeg/builds/ (选 release essentials)

# 3. 启动图形界面
python app.py

# 或者用命令行(app.py 和 main.py 都行)
python app.py --cli -i "D:\下载" -o "D:\音乐" -b 320k
python main.py -i "D:\下载" -o "D:\音乐" -b 320k

命令行参数:

参数 说明
-i, --input 输入目录,默认当前目录
-o, --output 输出目录,默认 ./output
--mp3-dir / --flac-dir 分别指定 MP3 / FLAC 输出位置
-b, --bitrate MP3 比特率,默认 192k
--keep-flac 保留解密出的 FLAC
--no-mp3 只输出 FLAC,不转 MP3
--force 已存在的 MP3 也重新生成
-v, --version 显示版本号

项目结构

app.py               唯一入口:不带参数开界面,带 --cli 走命令行
TuneFree.py          图形界面(PySide6)
main.py              命令行 / 后端:注入、解密、转码
hook_qq_music.js     Frida 注入脚本(解密核心)
version.py           版本号与仓库地址的唯一来源
version.json         给国内用户用的更新源(经 jsDelivr)
TuneFree.spec        PyInstaller 打包配置(只产出一个 TuneFree.exe)
docs/                官网(静态单页)
发版清单.md           发版流程备忘

免责声明

本工具仅供个人学习交流使用,用于解密本机已合法下载的音乐文件,方便在自己拥有的设备上播放。

请勿用于传播、二次分发或商业用途。使用产生的一切法律责任由使用者自行承担。

许可

代码以 MIT License 开源,欢迎 fork、修改、二次开发。

需要提醒的是:MIT 授权的是代码,不改变上面免责声明里对使用场景的限制。

鸣谢

支持

About

mflac / mgg 转 FLAC、MP3 — 解密 QQ音乐加密歌曲,全程本地、不上传

Topics

Resources

Stars

185 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0