shinshin86/live2d-add-motion-sample-web-ui — explained in plain English
Analysis updated 2026-05-18
Add new motions like a wink or a nod to a Live2D model by describing them to an AI agent.
Preview and play back newly added motions in a drag-and-zoom browser viewer.
Validate generated motion files with a headless-browser check before shipping them.
Learn the JSON structure of Live2D motion files by studying the bundled sample definitions.
| shinshin86/live2d-add-motion-sample-web-ui | 0whitedev/detranspiler | 2951461586/mulerun-pool | |
|---|---|---|---|
| Stars | 21 | 21 | 21 |
| Language | Python | Python | Python |
| Setup difficulty | easy | hard | moderate |
| Complexity | 2/5 | 4/5 | 3/5 |
| Audience | vibe coder | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Needs a Live2D model file of your own (not bundled) and a modern browser plus Chrome for the verification step.
live2d-add-motion-sample-web-ui is a project for adding new animations, called motions, to a Live2D character model without needing Live2D's own paid editing software. Live2D models are 2D characters, often used as virtual avatars or vtuber characters, that can be moved and posed through a set of adjustable parameters like eye shape, head tilt, or mouth position. A motion file for these models is plain JSON text describing how those parameters change over time, so this project shows that you can write new motions with a text editor and a script, as long as you stay within the parameters the model already supports. The repository comes with seven example motions already built for Live2D's official free sample character, Hiyori, such as a happy expression, a wink, a nod, and a head shake. Each motion is produced by a small pipeline: a script generates the motion data, a separate script checks it is valid, and a headless browser test confirms it actually renders correctly. There is also a browser based interface, a plain HTML page with no build step, where you can load a model, play back the newly added motions, drag the character around, and zoom in and out. The project is written to be used together with an AI coding agent such as Claude Code or Codex: it includes a guide file aimed at agents so you can simply describe a motion you want in plain English, point it at your model file, and have the agent write, generate, and verify the new motion for you. It can also be run by hand using the included Python scripts. The project's own code and documentation are under the MIT license, but the Live2D sample model, the Live2D rendering engine, and PixiJS it depends on each carry their own separate licenses and are not bundled directly in the repository.
This project lets you add new JSON-defined motions to a Live2D character model, with a browser UI and an AI-agent-friendly workflow, without Cubism Editor.
Mainly Python. The stack also includes Python, JavaScript, PixiJS.
Setup difficulty is rated easy, with roughly 30min to a first successful run.
Mainly vibe coder.
This repo across BitVibe Labs
double-check against the repo, no cap.