live2d-py

Python 版本及平台

:white_check_mark:: 可用, 支持, 已通过

:question:: 尚未测试

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

注：

• Cubism 2.X 导出的模型：文件名格式常为 XXX.moc，XXX.model.json，XXX.mtn
• Cubism 3.0 及以上导出的模型：文件名格式常为 XXX.moc3，XXX.model3.json, XXX.motion3.json

使用说明

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

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

2. 通过 PyPI 安装

pip install live2d-py

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

示例

简易面捕

源码见 main_facial_bind.py

基于 live2d-py C 模块及 Qt 开发的 Live2DViewer

多模型加载

源码见 main_glfw_four_model.py

添加背景

源码见 main_pygame_background.py

模型变换 & 口型同步音频 & 点击测试

源码见 main_glfw.py

模型整体透明度示例

源码见 main_pyqt5_canvas_opacity.py

鸣谢

特别感谢以下用户为本项目提供的帮助和支持: 96bearli, Ovizro, AnyaCoder, jahtim, Honghe, RobertMeow, LUORANCHENG, TinyKiecoo, Barracuda72, GuangChen2333, makabakadot, thynetruly, mastwet, KyvYang, @Mozilla88, @CooperWang0912, @minghf85

非常感谢以下项目及其贡献者们的帮助：

CubismNativeSamples (live2d.v3)

Cubism2 Web SDK (live2d.v2)

de4js（JavaScript 反混淆工具）

JsConvert (Javascript 转 Python 工具)

D2Evil (moc 文件分析)

facial-landmarks-for-cubism （面捕参考）

nlohmann/json (v2cpp)

Live2D 模型:

• Cubism 官方样例数据
• 雅萌工作室
• live2d-models
• 【虚拟主播模型】 宁宁vup化！