https://git.unlock-music.dev/um/um-react  

https://um-react.netlify.app/

对 Unlock Music 使用 React 重写（um-react） https://um-react.netlify.app/

Unlock Music 音乐解锁 (React)

• 在浏览器中解锁加密的音乐文件。 Unlock encrypted music file in the browser.

• 查看原基于 Vue 的 Unlock Music 项目

• Unlock Music 项目是以学习和技术研究的初衷创建的，修改、再分发时请遵循授权协议。

• Unlock Music 的 CLI 版本可以在 unlock-music/cli 找到，大批量转换建议使用 CLI 版本。

• 我们新建了 Telegram 群组 @unlock_music_chat ，欢迎加入！

• CI 自动构建已经部署，可以在 Actions 寻找对应的

  构建产物Artifact

  下载。

• 常见问题参考

Warning

在本站 fork 不会起到备份的作用，只会浪费服务器储存空间。如无必要请勿 fork 该仓库。

⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。

支持的格式

• QQ 音乐 QMCv1 (.qmc3 / .qmcflac 等)

• QQ 音乐 QMCv2

• PC 客户端 (.mflac / .mgg 等) 1

• 安卓客户端 (.mflac0 / .mgg1 / .mggl 等) 2

• iOS 客户端 (.mgalaxy 等) 3

• Mac 客户端 (.mflach 等) 4

• 网易云音乐 (.ncm)

• 虾米音乐 (.xm)

• 酷我音乐 (.kwm)

• 酷狗音乐 (.kgm / .vpr / .kgg)

• PC / 安卓客户端的 kgg 文件需要提供密钥数据库。

• 喜马拉雅 (.x2m / .x3m / .xm)

• 咪咕音乐格式 (.mg3d)

• 蜻蜓 FM (.qta)

• QQ 音乐海外版JOOX Music (.ofl_en)

错误报告

有不支持的格式？请提交样本（加密文件）与客户端信息版本信息（如系统版本、下载渠道），或一并上传其安装包到仓库的问题追踪区。

⚠️ 如果文件太大，请上传到不需要登入下载的网盘，如 mega.nz、OneDrive 等。

遇到解密出错的情况，请一并携带错误信息（诊断信息）并简单描述错误的重现过程。

待实现的算法支持可追踪 crypto 标签。

开发相关

从源码运行或编译生产版本，请参考文档「新手上路」。

解密库开发

⚠️ 如果只是进行前端方面的更改，你可以跳过该节。

请参考文档「面向 @unlock-music/crypto 开发」。

架构

• 浏览器主线程: 渲染界面，处理 UI 更新

• Web Worker: 负责计算方面的内容，如内容解密。

数据传输: 生成 blob url (URL.createObjectURL) 然后透过 postMessage 传递给线程，线程利用 fetch API 来获取文件信息。

贡献代码

欢迎贡献代码。请确保：

• 单元测试的覆盖率不低于主分支的覆盖率；

• 提交前请使用 Prettier 对代码进行格式化；

• 提交前请确保 ESLint 不会报告 warning / error；

满足上述条件后发起 Pull Request，仓库管理员审阅后将合并到主分支。

相关项目

• Unlock Music (Web) - 原始项目

• Unlock Music (Cli) - 命令行批量处理版

• um-react (Electron 前端) - 使用 Electron 框架封装的本地可执行文件。

• GitHub 下载 | 仓库镜像

• um-react-wry - 使用 WRY 框架封装的 Win64 单文件 ( 需要安装 Edge WebView2 运行时，Win10+ 操作系统自带)

• 本地下载 | 寻找文件名为 um-react-win64- 开头的附件

有新的项目提交？欢迎提交 issue，请带上项目名称和链接。

答疑目录

• QQ 音乐

• 酷我音乐

• 酷狗音乐

• 其它问题

QQ 音乐

解锁失败

重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。

部分平台获取的加密文件未包含密钥。选择你下载文件时使用的客户端来查看说明。

酷我音乐

解锁失败

• 尝试用下载音乐的设备播放一次看看，如果官方客户端都无法播放，那解锁肯定会失败哦。

• 日前，仅手机客户端下载的「至臻全景声」及「至臻母带」音质的音乐文件采用新版加密。

  其他音质目前不需要提取密钥。

  PC平台暂未推出使用新版加密的音质。

  安卓用户提取密钥需要 root 权限，或注入文件提供器。

  注意：已知部分第三方修改版会破坏密钥写入功能，导致无法提取密钥。

  注意：项目组不提倡使用、也不提供第三方修改版。使用前请自行评估风险。

  导入密钥可以参考下面的步骤：

1. 点击顶部的「设置」

2. 设定区域选择「KWMv2 密钥」

3. 按下「添加一条密钥」按钮右侧的

4. 选择「从文件导入密钥…」

5. 选择你的客户端平台来查看密钥提取说明：

   安卓iOSWindows

   你需要超级管理员root访问权限来访问安卓应用的私有数据。

   ⚠️ 请注意，获取管理员权限通常意味着你的安卓设备将失去保修资格。

   在安卓手机端操作

   在 PC 端操作（ADB / PowerShell）

   在 Linux / Mac 系统下操作（ADB / Shell）

酷狗音乐

解锁失败

• 酷狗现在对部分用户推送了 kgg 加密格式（安卓、Windows 客户端）。

  根据平台不同，你需要提取密钥数据库。

  安卓用户提取密钥需要 root 权限，或注入文件提供器。

  导入密钥可以参考下面的步骤：

1. 点击顶部的「设置」

2. 设定区域选择「酷狗密钥」

3. 按下「添加一条密钥」按钮右侧的

4. 选择「从文件导入密钥…」

5. 选择你的客户端平台来查看密钥提取说明：

   安卓Windows

   你需要超级管理员root访问权限来访问安卓应用的私有数据。

   ⚠️ 请注意，获取管理员权限通常意味着你的安卓设备将失去保修资格。

   在安卓手机端操作

   在 PC 端操作（ADB / PowerShell）

   在 Linux / Mac 系统下操作（ADB / Shell）

其它问题

解密后没有封面等信息

该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。

请使用第三方工具进行编辑或管理元信息。

批量下载

暂时没有实现，不过你可以在 #34 - [UI] 全部下载功能 以及 #43 - 批量下载 追踪该问题。

安卓: 浏览器支持说明

⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。

已知有问题的浏览器：

• Via 浏览器

• 夸克浏览器

• UC 浏览器

可能会遇到的问题包括：

• 网页白屏

• 无法下载解密后内容

• 下载的文件名错误

安卓: root 相关说明

对安卓设备获取 root 特权通常会破坏系统的完整性并导致部分功能无法使用。 例如部分厂商的安卓设备会在解锁后丧失保修资格，或导致无法使用 NFC 移动支付功能等限制。

如果希望不破坏系统完整性，你可以考虑使用模拟器。

目前常见的带有 root 特权支持的的安卓模拟器方案，分别是雷电模拟器（※ 官方版有内置广告）和微软在 Windows 11 开始支援的适用于 Android™ 的 Windows 子系统 (WSA)Windows Subsystem for Android。

• WSA 可以参考 MagiskOnWSALocal 的说明操作。

• 雷电模拟器可以在「模拟器设置」 → 「其他设置」中启用 root 特权。

  

相关项目

• um-react-electron：利用 Electron 框架打包的本地版，提供适用于 Windows、Linux 和 Mac 平台的可执行文件。

• GitHub 下载

• um-react-wry: 使用 WRY 框架封装的 Win64 单文件（需要安装 Edge WebView2 运行时，Win10+ 操作系统自带）

• 仓库下载 | 寻找文件名为 um-react-win64- 开头的附件

有更多问题？

欢迎进入 Telegram “音乐解锁-交流” 交流群 一起探讨。

推荐本站淘宝优惠价购买喜欢的宝贝:

本文链接：https://sg.hqyman.cn/post/9210.html 非本站原创文章欢迎转载，原创文章需保留本站地址！

休息一下~~