takiyasha 0.4.1

使用 Python 编写的加密音乐解锁工具

Takiyasha

Takiyasha 是用来解锁被加密的音乐文件的工具，支持多种加密格式。

Takiyasha 项目是以学习和技术研究的初衷创建的，修改、再分发时请遵循 License。

Takiyasha 解锁部分加密格式文件的能力，来源于此项目：Unlock Music Project - CLI Edition

如果你只想快点体验，查看安装方法

也可以看看：此项目位于 Notabug 上的备份

特性

• 使用 Python 3 编写
• 跨平台：只要系统上可以运行 Python 3 和使用 pip，就可以安装和使用
• 支持多种加密格式
  • 可自动识别并解锁没有扩展名的加密文件
  • 支持为解锁后的文件补全元数据（包括封面，仅限.ncm/.qmc*/.mflac*/.mgg*）

支持的加密格式

• 文件扩展名中含有 .qmc、.mflac、.mgg、.ncm、.kgm、.vpr 字样的文件。
  • 可在安装后使用 takiyasha --formats 查看所有支持的加密格式。
• 目前不支持解锁以下来源的加密文件：
  • 版本 1857 及以上的 QQ 音乐 PC 客户端（.mflac*、.mgg*）
  • 版本 11.55 及以上的 QQ 音乐 Android 客户端（.mflac*、.mgg*）
  • Apple Music/Spotify 等流媒体平台（在可预见的未来没有可能支持）

适用群体

• 经常批量下载和解锁加密格式的用户
• 重视结果大于重视过程的用户
  • 受限于 Python 的语言特性，解锁过程很慢
• 想要研究算法和提升自己技术水平的开发者

如何安装

• 所需运行环境
  • Python 版本：大于或等于 3.9
• 所需依赖
  • Python 包：click - 提供命令行界面
  • Python 包：mutagen - 向输出文件写入歌曲信息
  • Python 包：pycryptodomex - 部分加密格式的解锁支持
  • Python 包：requests - 为缺失封面的已解锁文件下载封面

（推荐）从 Pypi 安装

使用命令：pip install -U takiyasha

通过已发布的 wheel (.whl) 包文件安装

• 前往发布页面
  • Github
  • Notabug
• 找到你需要的版本（一般是最新版本）
• 按照发布说明进行下载和安装

（不推荐）直接从仓库安装

使用命令：

Github: pip install -U git+https://github.com/nukemiko/takiyasha

Notabug: pip install -U git+https://notabug.org/MiketsuSmasher/takiyasha

需要你先安装git。

如何使用

命令行（CMD/Powershell/Terminal 等）

Takiyasha 提供了 3 个命令入口：

• takiyasha
• unlocker
• takiyasha-unlocker

它们只存在命令长度上的区别。

• 直接执行命令：
  • takiyasha file1 file2 dir1 ...
  • unlocker file3 file4 dir2 ...
• 直接运行模块：python -m takiyasha file5 file6 dir3 dir4 ...

无论怎样运行，都可以使用 -h/--help 选项获得更多帮助信息。

作为 Python 模块导入使用

1. 创建一个 Decoder 对象：

   from takiyasha import new_decoder
   
   qmcflac_dec = new_decoder('test.qmcflac')
   mflac_dec = new_decoder('test.mflac')
   ncm_dec = new_decoder('test.ncm')
   noop_dec = new_decoder('test.kv2')  # “test.kv2”是扩展名为“kv2”的 mp3 文件
   
   print(qmcflac_dec, mflac_dec, ncm_dec, noop_dec, end='\n')
   

   输出:

   <QMCFormatDecoder at 0x7fdbf2057760 name='test.qmcflac'>  # QMCv1 加密
   <QMCFormatDecoder at 0x7fdbf2ac1090 name='test.mflac'>  # QMCv2 加密
   <NCMFormatDecoder at 0x7fdbf15622f0 name='test.ncm'>  # NCM 加密
   <NoOperationDecoder at 0x7fdbf1563400 name='test.kv2'>  # 无需解锁操作
   

2. 执行解锁操作并保存到文件：

       save_filename = f'test{idx}.{audio_format}'
   
       with open(save_filename, 'wb') as f:
           for block in decoder:
               f.write(block)
   
       print('Saved:', save_filename)
   

   输出：

   Saved: test0.flac
   Saved: test1.flac
   Saved: test2.flac
   Saved: test3.mp3
   

   使用 file 命令验证输出文件是否正确：

   > file test0.flac test1.flac test2.flac test3.mp3
   test0.flac: FLAC audio bitstream data, 16 bit, stereo, 44.1 kHz, 13379940 samples
   test1.flac: FLAC audio bitstream data, 16 bit, stereo, 44.1 kHz, 16585716 samples
   test2.flac: FLAC audio bitstream data, 16 bit, stereo, 44.1 kHz, 10222154 samples
   test3.mp3:  Audio file with ID3 version 2.4.0, contains: MPEG ADTS, layer III, v1, 320 kbps, 44.1 kHz, Stereo
   

3. 针对一些内嵌封面等元数据的加密格式（例如 NCM），还可将其嵌入解锁后的文件：

   from takiyasha import new_tag
   
   with open('text2.flac', 'rb') as ncmfile:
       tag = new_tag(ncm_decrypted_file)
       # 上文中的 NCMFormatDecoder 对象已经储存了找到的元数据
       tag.title = ncm_dec.music_title
       tag.artist = ncm_dec.music_artists
       tag.album = ncm_dec.music_album
       tag.comment = ncm_dec.music_identifier
       tag.cover = ncm_dec.music_cover_data
   
       ncm_decrypted_file.seek(0, 0)
       tag.save(ncm_decrypted_file)
   

常见提示和错误信息

Warning: Skipped input file '<filename>': Failed to unlock the data: Error: Non-base64 digit found

如果你是从这些来源下载的文件：

• 版本 1857 及以上的 QQ 音乐 PC 客户端（.mflac*、.mgg*）
• 版本 11.55 及以上的 QQ 音乐 Android 客户端（.mflac*、.mgg*）

很遗憾，目前不支持解锁这些文件。请尝试使用旧版 QQ 音乐客户端。

如果你不是从以上来源下载的文件，那么文件可能已经损坏，建议重新下载源文件，重新解锁。

Warning: Skipped input file '<filename>': Failed to unlock the data: OSError: [Errno 22] Invalid argument

文件太小了（可能只有几字节大小）。

出现这种情况，说明你下载的文件没有下载完整，建议重新下载源文件，重新解锁。

Warning: Skipped subdirectory '<dirname>'.

如果传入的路径中存在目录，解锁过程中会一并解锁该目录下受支持的文件，但是不包括子目录<dirname>。

常见问题

解锁后的音乐断断续续，甚至无法播放

你用来解锁的源文件可能已经损坏，建议重新下载源文件，重新解锁。

能否在解锁的同时转换格式？

不能。Takiyasha 不负责格式转换，它只负责解锁你的加密音乐文件。

是否会支持来自 Apple Music/Soptify 等流媒体服务的文件？

不会，也没有这方面的打算。

Takiyasha 和 unlock-music 项目的关系？

Takiyasha 的部分算法来源于 unlock-music 的衍生项目 Unlock Music Project - CLI Edition，但 Takiyasha 支持包括补全元数据和封面在内的更多功能。