pymouth 0.1.1

Live2D Mouth-sync artifact

pymouth

pymouth 是Python 基于音频的Live2D口型同步库. 你可以用音频文件, 甚至是AI模型输出的ndarray, 就能轻松的让你的Live2D形象开口 唱跳RAP v.

Quick Start

Installation

pip install pymouth

Get Started

注意: 在开始前你需要打开 VTubeStudio 的 Server API. 端口一般默认是8001.
下面是一个完整的Demo,你可以找一个音频文件替换some.wav.

import asyncio
from pymouth import VTSAdapter, DBAnalyser


async def main():
    async with VTSAdapter(DBAnalyser) as a:
        await a.action(audio='some.wav', samplerate=44100, output_channels=1)
        await asyncio.sleep(100000)  # do something


if __name__ == "__main__":
    asyncio.run(main())

第一次运行程序时, VTubeStudio会弹出插件授权界面, 通过授权后, 插件会在runtime路径下生成pymouth_vts_token.txt文件, 之后运行不会重复授权, 除非token文件丢失或在VTubeStudio移除授权.

More Details

TODO

• 文档补全
• CI
• 基于元音的口型同步API
• Test case

Special Thanks

Idea源: 卜卜口

https://github.com/itorr/itorr/issues/7