live2d-py 0.3.0

Live2D Python SDK

live2d-py

使用 Python 直接加载和操作 Live2D 模型，不通过 Web Engine 等间接手段进行渲染。

基于 Python C++ API 对 Live2D Native SDK (C++) 进行了封装。理论上，只要配置好 OpenGL 上下文，可在 Python 中将 live2d 绘制在任何基于 OpenGL 的窗口。

代码使用示例：package

详细使用文档：https://arkueid.github.io/live2d-py-docs/

兼容UI库

理论上兼容所有能使用 OpenGL 进行绘制的UI库： Pygame / PyQt5 / PySide2 / PySide6 / GLFW / FreeGlut / Qfluentwidgets ...

支持功能

• 加载模型：Cubism 2.1 和 Cubism 3.0 及以上版本
• 视线跟踪
• 点击交互
• 动作播放回调
• 口型同步
• 模型各部分参数控制
• 各部件透明度控制
• 精确到部件的点击检测

平台支持

live2d-py	支持的live2d模型	实现	支持的Python版本	支持平台
live2d.v2	Cubism 2.1 以及更早的版本	纯 Python 实现	支持 32 / 64 位，支持Python 3.0 及以上版本	Winodws、Linux、MacOS（理论上）
live2d.v3	Cubism 3.0 及以上版本	Python C++ API 封装	支持 32 / 64 位，支持Python 3.0 及以上版本	Windows、Linux

注：

• live2d.v2 由 Cubism Web SDK 转写为纯 Python，尚未使用 numpy 等优化的库，性能有待提升。
• Cubism 2.X 导出的模型：文件名格式常为 XXX.moc，XXX.model.json，XXX.mtn
• Cubism 3.0 及以上导出的模型：文件名格式常为 XXX.moc3，XXX.model3.json, XXX.motion3.json

安装方式

1. 通过 PyPI 安装

pip install live2d-py

2. 在 Release 中下载对应版本的 whl 文件并安装（推荐）

pip install live2d_py-0.X.X-cpXXX-cpXXX-win32.whl

从源码构建，参考 安装#源码构建

简易面部动捕示例

源码见 main_facial_bind_mediapipe.py

基于 live2d-py + qfluentwidgets 实现的桌面应用预览

见 live2d-desktop

贡献

特别感谢 @96bearli，@Ovizro, @AnyaCoder, @jahtim 为本项目提供的帮助和支持。