English | 简体中文
面向音频工作流的轻量级格式转换与解密工具。
桌面端基于 JavaScript 解码管线 + Electron + FFmpeg 转码后端构建；
Android 端基于 Jetpack Compose + 纯 Kotlin 解码器 + FFmpegKit 架构实现。
- 隐私至上，完全离线：所有的解密、转码与处理均完全在本地设备上运行。不上传任何音频数据，零网络交互，安全可靠。
- 真实音频转码 (FFmpeg)：并非简单重命名或提取，内置 FFmpeg / FFmpegKit 转码后端，支持转码为 MP3 / FLAC / WAV / M4A / OGG，并可根据需要自由选择输出码率（如 320k, 256k 等）。
- 更简洁的 UI 设计：桌面端引入悬浮转换按钮；Android 端采用卡片式
List-group约束排版。 - 更强大的密钥扫描：Windows 端现已支持 WMI 驱动的全盘暴力扫描机制，确保无论酷狗客户端安装在哪个盘符都能精准定位并提取解密密钥。
| 格式扩展名 | 对应来源平台 |
|---|---|
.ncm |
网易云音乐 |
.kwm |
酷我音乐 |
.kgm / .kgma / .vpr 等 |
酷狗音乐 |
.kgg / .kgg.flac |
酷狗音乐（v5：在设置中导入 kgg.key 文件；目前仅windows桌面端均支持，并且音频必须本地酷狗下载 ） |
.mgg / .mgg1 / .bkc 等 |
QQ音乐 |
.mp3 / .flac / .wav 等明文音频 |
任何平台 |
从 Releases 页面 下载对应系统的最新安装包：
# AppImage 安装与运行（推荐）
chmod +x openconverter-v***-linux-x64.AppImage
./openconverter-v***-linux-x64.AppImage
# Deb包安装 (注意：OpenConverter 在 Linux 下需要系统 PATH 存在 ffmpeg)
sudo apt install ffmpeg
sudo apt install ./openconverter-v***-linux-amd64.deb- 便携版（推荐）：
openconverter-v***-windows-x64-portable.exe双击直接运行，可随身携带。 - NSIS 安装包：
openconverter-v***-windows-x64-setup.exe双击根据向导安装。 - 提示：Windows 端已内置
ffmpeg.exe与ffprobe.exe，无需手动安装 FFmpeg。首次启动若弹出 Windows Defender 未签名提示，点击“更多信息” -> “仍要运行”即可。
从 Releases 页面 下载最新的 APK 文件安装：
- arm64-v8a：
openconverter-v***-android-arm64-v8a.apk(推荐，适合绝大多数现代智能手机) - x86_64：
openconverter-v***-android-x86_64.apk(适合在 Android 模拟器上运行与调试)
Android 的 KGG v5 解密需要该文件对应的逐文件密钥。请在设置页通过系统文件选择器导入来自用户本人酷狗环境的 KGMusicV3.db，或导入便携的 kgg.key。映射只在本设备应用沙箱内合并保存；项目不附带、上传或在线查询数据库、账号及密钥。
Important
Android 端 KGG 解密限制与应对策略：
- 系统权限限制：在未 Root 的手机上，Android 的安全沙盒机制严格禁止任何应用（包括本应用和 ADB shell）直接读取酷狗的私有数据库
kugou_music_v2.db，因此无法直接在手机上自动扫描提取密钥。 - 免 Root 导入方案：在电脑端，酷狗音乐会将解密密钥数据库
KGMusicV3.db存储在系统公共目录下（例如 Windows 路径为C:\Users\Public\KuGou\KGMusic\KGMusicV3.db）。您只需将这个KGMusicV3.db文件通过数据线传输或云同步到手机的公共存储区域（例如“下载”文件夹），然后在手机端的 OpenConverter 设置页面中选择“导入数据库”功能并选中此文件。导入成功后，手机端即可一劳永逸地直接本地解密对应的 KGG 歌曲，无需 Root 权限，也无需每次手动导入。
| 格式后缀 | 对应版本及音质 | 手机端解密是否需要密钥数据库？ | 结论与使用建议 |
|---|---|---|---|
.kgm |
早期格式，标准或高品质 MP3 | ❌ 不需要 (免 Root / 免导入) | 完全可解。可直接在手机版 OpenConverter 中进行一键转换。 |
.kgma |
早期格式，超高品质或无损 FLAC | ❌ 不需要 (免 Root / 免导入) | 完全可解。可直接在手机版 OpenConverter 中进行一键转换。 |
.vpr |
酷狗彩铃格式 | ❌ 不需要 (免 Root / 免导入) | 完全可解。可直接在手机版 OpenConverter 中进行一键转换。 |
.kgg |
现代格式，酷狗手机端专属加密 | 受限。如果没有导入 PC 端的 KGMusicV3.db，手机端无法直接解密。 |
|
.kgg.flac |
现代格式，酷狗手机端无损加密 | 受限。如果没有导入 PC 端的 KGMusicV3.db，手机端无法直接解密。 |
如果你需要从源码构建本项目，请确保您的计算机上配置了 Node.js 18+ 与 Android SDK（如果编译 Android 版本）。
# 安装依赖
npm install
# 编译前端静态资源
npm run build:renderer
# 编译 Linux 软件包 (AppImage/Deb)
npm run build:linux
# 编译 Windows 软件包 (需要 wine64 环境)
npm run build:wincd android
# 运行本地单元测试
./gradlew testDebugUnitTest connectedDebugAndroidTest
# 编译并打包 Debug/Release APK
./gradlew :app:assembleRelease真实 KGG 样本不会进入仓库。维护者可在已启动的 Android 设备或模拟器上运行环境门控的逐字节等价验证：
KGG_FIXTURE_DIR=/local/kgg \
KGG_KEY_SOURCE=/local/KGMusicV3.db \
KGG_EXPECTED_DIR=/local/reference \
android/scripts/verify-kgg-v5.shreference 必须是同一批输入经独立参考实现解密得到的明文目录，保持相同相对路径并使用真实容器扩展名。脚本只暂存本地材料用于测试，结束后自动清理设备和主机临时文件。
本项目仅作为个人音频学习、文件格式整理及兼容性研究的技术工具使用，不涉及任何版权音频内容的提供、分发或存储。使用者在使用过程中应严格遵守相关法律法规，尊重音乐作品著作权人的合法权益，不得将本工具用于任何侵犯著作权的行为。由于使用本工具引发的任何法律争议或纠纷，均由使用者自行承担，与本项目作者及贡献者无关。
本项目基于 Apache License 2.0 协议开源。