unblock-music-web/README.md

Unlock Music 音乐解锁

• 在浏览器中解锁加密的音乐文件。 Unlock encrypted music file in the browser.
• Unlock Music 项目是以学习和技术研究的初衷创建的，修改、再分发时请遵循授权协议。
• Unlock Music 的 CLI 版本可以在 unlock-music/cli 找到，大批量转换建议使用 CLI 版本。
• 我们新建了 Telegram 群组 @unlock_music_chat ，欢迎加入！
• CI 自动构建已经部署，可以在 UM-Packages 下载

特性

支持的格式

• QQ 音乐 (.qmc0/.qmc2/.qmc3/.qmcflac/.qmcogg/.tkm)
• Moo 音乐格式 (.bkcmp3/.bkcflac/...)
• QQ 音乐 Tm 格式 (.tm0/.tm2/.tm3/.tm6)
• QQ 音乐新格式 (.mflac/.mgg/.mflac0/.mgg1/.mggl)
• QQ 音乐海外版JOOX Music (.ofl_en)
• 网易云音乐格式 (.ncm)
• 虾米音乐格式 (.xm)
• 酷我音乐格式 (.kwm)
• 酷狗音乐格式 (.kgm/.vpr)
• Android版喜马拉雅文件格式 (.x2m/.x3m)

其他特性

• 在浏览器中解锁
• 拖放文件
• 批量解锁
• 渐进式 Web 应用 (PWA)
• 多线程
• 写入元信息与专辑封面

使用方法

使用预构建版本

• 从 Release 或 CI 构建 下载预构建的版本
  • ⚠️ 本地使用请下载legacy版本（modern版本只能通过 http(s)协议 访问）
• 解压缩后即可部署或本地使用（请勿直接运行源代码）

自行构建

JS部分

• 环境要求
  • nodejs (v16.x)
  • npm

1. 获取项目源代码后安装相关依赖：

   npm ci
   

2. 然后进行构建：

   npm run build
   

   • 构建后的产物可以在 dist 目录找到。
   • 如果是用于开发，可以执行 npm run serve。

3. 如需构建浏览器扩展，构建成功后还需要执行：

   npm run make-extension
   

WASM部分

• 环境要求

  • Linux
  • python3

• 运行此目录下的build-wasm

  ./scripts/build-wasm.sh