A Live2D integration component that pre-renders Live2D models and animations for use in video production.
This project utilizes the Live2D Cubism SDK to create pre-rendered animations of Live2D models. It's designed for video production workflows, allowing for the integration of Live2D characters into video content through offline rendering.
- Pre-renders Live2D models using the Cubism SDK
- Supports model loading, animations, and expressions
- Integrates with audio for lip sync in pre-rendered output
- Generates video output with FFmpeg
- Designed for offline rendering, not real-time applications
-
Clone the repository:
git clone https://github.com/your-repo/live2d-component.git -
Install dependencies:
- CMake (3.16 or higher)
- Visual Studio 2019 or 2022 with C++ development tools
- FFmpeg
-
Build the project:
cd live2d-component mkdir build && cd build cmake .. cmake --build . --config Release
Run the compiled executable with the following command-line arguments:
live2d.exe -a <audio_file> -v <video_file> [-o <output_path>]
-a: Path to the input audio file-v: Path to the input video file-o: (Optional) Path for the output video file. Defaults to "output" if not specified.
Example:
live2d.exe -a input_audio.wav -v input_video.mp4 -o output_video.mp4
This will render the Live2D model animation synchronized with the audio, overlay it on the input video, and save the result as output_video.mp4.
Model settings can be adjusted in the LAppDefine.hpp file. This includes render target dimensions, motion groups, and other parameters.
- Fork the repository
- Create a new branch for your feature
- Commit your changes
- Push to your branch
- Create a new Pull Request
Please ensure your code follows the existing style and includes appropriate tests.
This project uses the Live2D Cubism SDK, which is licensed under the Live2D Open Software License.
By using this software, you agree to the terms of the Live2D Open Software License.
The Live2D Cubism Components are subject to the license terms and conditions set forth by Live2D Inc. For more details, please refer to the official Live2D website and the license agreement included with the SDK.
All rights to the Live2D Cubism SDK belong to Live2D Inc. This project is not endorsed or certified by Live2D Inc.
This component is designed for integration with the Banana client. It provides a framework for rendering Live2D models and generating video output, but may require additional configuration or customization for specific use cases.