libtakiyasha 2.1.1.post1

Description:

libtakiyasha 2.1.1.post1

LibTakiyasha
LibTakiyasha 是一个 Python 音频加密/解密工具库（当然也可用于加密非音频数据），支持多种加密文件格式。LibTakiyasha 不提供任何命令行或图形界面支持。
使用前必读
本项目是以学习和技术研究的初衷创建的，修改、再分发时请遵循 License。
本项目的设计灵感，以及部分解密方案，来源于同类项目：

Unlock Music Project - CLI Edition
parakeet-rs/libparakeet

本项目不内置任何密钥，要正常打开/保存任何类型的加密文件，你需要提供正确的对应的密钥。你需要自行寻找解密所需密钥或加密参数，在调用时作为参数传入。
如果你要解密别人提供的文件，你可以从提供者处索要密钥，或者寻求同类项目和他人的帮助。
LibTakiyasha 对输出数据的可用性（是否可以识别、播放等）不做任何保证。

新变化？
请参阅变更记录。
（如果你是在 PyPI 上浏览本 README，以上链接是无效的；变更记录可能会出现在页面的底部。）
特性

使用纯 Python 代码编写

兼容 Python 3.8 及后续版本，兼容多种 Python 解释器实现

可在此处查看具体兼容哪些实现


易于阅读，方便 Python 爱好者学习
（包括依赖库）无任何 C/C++ 扩展模块，跨平台性强


支持四种加密文件：

网易云音乐加密文件 .ncm
QQ 音乐加密文件 QMCv1 .qmc[0-9]、.qmcflac、.qmcogg、.qmcra 等
QQ 音乐加密文件 QMCv2 .mflac[0-9]、.mgg[0-9] 等
酷狗音乐加密文件 KGM/VPR .kgm、.vpr

不支持创建新加密文件


酷我音乐加密文件 .kwm
更多信息，请参见此处



注意：LibTakiyasha 的所有操作都不是线程安全的。尽量不要尝试在多线程环境下使用 LibTakiyasha 的任何功能。
性能表现
参见此处。
安装
可用的最新版本：2.1.1，GitHub 发布页面，PyPI
安装方式

使用 pip，通过 PyPI 安装最新版本：python -m pip install -U libtakiyasha

如果你要下载其他版本：

PyPI：https://pypi.org/project/libtakiyasha/#history ，挑选自己所需的版本，下载安装包，手动安装。

或者使用 pip 安装：python -m pip install -U libtakiyasha==<你所需的版本>


前往发布页面挑选自己所需的版本，下载安装包，手动安装。

依赖项
LibTakiyasha 依赖以下包，均可从 PyPI 获取：

pyaes - 用于加解密 NCM 文件内嵌的主密钥和元数据
mutagen - 用于以 mutagen 可接受的形式导出 NCM 文件内嵌的元数据

如何使用？
在这里可以找到使用方法和示例。
同时，在本项目的 Wiki 主页可以找到其他一些可能对你有用的东西。
常见问题

为什么 2.x 打开文件需要密钥，而 1.x 版本不需要？

这是出于以下考虑：

LibTakiyasha 是一个加解密库，当然需要为用户提供自定义密钥的权利
为了保护本项目不受美国数字千年版权法Digital Millennium Copyright Act（DMCA）影响，避免仓库被误杀

因此，本仓库所有 1.x 及更早版本的提交和发布版本都已删除。



变更记录
版本 2.1.1.post1

修复了 import libtakiyasha 时因为缺少数据文件而抛出 FileNotFoundError，从而导致 libtakiyasha 彻底无法使用的问题
将 libtakiyasha.ncm.CloudmusicIdentifier 加入顶层 __init__.py 的导入内容

在这里查看更详细的变更记录。
版本 2.1.1

修复了各个模块的文件探测函数 probe_*() 的类型提示，现在 PyCharm、Pylance 等 IDE 和 LSP 应该会正确识别和显示它们的参数类型和返回类型
修改了 libtakiyasha.__init__ 中导入的内容：不再导入常用模块 ncm、qmc、kgmvpr、kwm、pkgmetadata，而是直接导入这些模块中的常用函数、方法和类，可以在只导入了 libtakiyasha 包后直接使用。

可以在这里看到 libtakiyasha.__init__ 中导入的内容。


为各个模块都添加了另一个文件探测函数 probeinfo_*()，此函数与 probe_*() 不同：

probeinfo_*() 仅在输入文件是受支持的文件类型时才会返回探测结果（*FileInfo 对象），否则为 None；
probe_*() 始终返回一个 2 元组：

如果输入了文件路径，第一个元素是输入的路径使用 pathlib.Path 转换过的路径对象；如果输入了文件对象，第一个元素就是输入的文件对象
如果输入文件是受支持的文件类型，第二个元素是探测结果（*FileInfo 对象）；否则为 None




libtakiyasha.qmc 中作为文件探测信息容器的 QMCv1FileInfo 和 QMCv2FileInfo 已被删除，它们的作用被 QMCFileInfo 取代。这意味着不应该再使用内置函数 isinstance() 判断 QMC 文件版本，转而通过访问探测结果的 version 属性获得。

在这里查看更详细的变更记录。
版本 2.1.0

减少了一些重复代码的使用，删除了大量不再使用的代码
优化了判断是否为 QMCv1 文件的逻辑、QMCv2 文件的主密钥探测逻辑
libtakiyasha.qmc.QMCv2 的 open() 和 save() 现在可接受多个混淆密钥，通过关键字参数 garble_keys 在需要时传入。

因此，上述方法中原来的关键字参数 garble_key1 和 garble_key2 已经被干掉了，请及时修改你的工具链。
如果提供此参数，需要提供一个产生至少一个混淆密钥（类字节对象）的可迭代对象（例如列表），且混淆密钥的顺序必须正确。



在这里查看更详细的变更记录。
版本 2.0.1 至 2.1.0rc2
在这里查看更详细的变更记录。