Home

本 Wiki 编辑权限对所有人开放，欢迎大家前来编写修改使用说明、分享使用技巧、更多玩法~

live2d-py 是一个 Python C Extension 实现的 Live2D 库。

live2d-py 使用 CMake 构建项目，主要模块包括：OpenGL API 管理库 Glad、 Cubism Live2D 官方发布的 Core 和 Native Framework，基于官方 Sample 魔改的 Main模块，和 Python 对前三者的封装 Wrapper模块。

本项目的主要目的是为 Python 提供 Live2D 渲染功能。

此外，也可将本项目中 Python 封装的部分剔除，在仅使用其 C 模块（Core、Framework、Main）的基础上进行二次开发，编写基于 C/C++ 的 Live2D 应用或者为其他编程语言（如 alive2d）写 C 绑定库，提供 Live2D 渲染功能。

使用说明

Cubism 2.0 模型使用接口见 package/live2d/v2/live2d.pyi。

Cubism 3.0（含4.0） 模型使用接口见 package/live2d/v3/live2d.pyi。

具体与图形库结合的用例示例见 examples 文件夹。

Python 版本及平台

✅: 可用, 支持, 已通过

❓: 尚未测试

🚧, ❌: 编译期问题或平台兼容性问题待解决

Platform	Python Version	live2d.v2	live2d.v3	构建状态	PyPI
MacOS arm64	>3.0, <=3.10	✅	❓	🚧	❌
MacOS arm64	>=3.11	✅	✅	✅	✅
Windows x86/x64	>3.0, <3.8	✅	❓	🚧	❌
Windows x86/x64	>=3.8	✅	✅	✅	✅
Ubuntu 20.04/Arch, x64	>3.0, <3.8	✅	❓	🚧	❌
Ubuntu 20.04/Arch, x64	>=3.8	✅	✅	✅	❌

注：

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