whatisgithub

What is live2d-add-motion-sample-web-ui?

shinshin86/live2d-add-motion-sample-web-ui — explained in plain English

Analysis updated 2026-05-18

21PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

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.

Mindmap

mindmap
  root((live2d motion tool))
    What it does
      Adds motions via JSON
      No Cubism Editor needed
      Browser preview UI
      AI agent workflow
    Tech stack
      Python scripts
      PixiJS
      Live2D SDK
    Use cases
      Add character motions
      Preview in browser
      Validate motions
    Audience
      Vibe coders
      Vtuber creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add new motions like a wink or a nod to a Live2D model by describing them to an AI agent.

USE CASE 2

Preview and play back newly added motions in a drag-and-zoom browser viewer.

USE CASE 3

Validate generated motion files with a headless-browser check before shipping them.

USE CASE 4

Learn the JSON structure of Live2D motion files by studying the bundled sample definitions.

What is it built with?

PythonJavaScriptPixiJSLive2D Cubism SDK

How does it compare?

shinshin86/live2d-add-motion-sample-web-ui0whitedev/detranspiler2951461586/mulerun-pool
Stars212121
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Needs a Live2D model file of your own (not bundled) and a modern browser plus Chrome for the verification step.

So what is it?

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.

Copy-paste prompts

Prompt 1
There is a Live2D model at this path. Add motions to it and make them viewable in the browser.
Prompt 2
Add a waving hand motion to this model, and propose alternatives if it cannot be made naturally.
Prompt 3
Explain how gen_motions.py and validate_motions.py work together to build and check a new motion.
Prompt 4
Walk me through running setup_model.py, gen_motions.py, and the local server manually.

Frequently asked questions

What is live2d-add-motion-sample-web-ui?

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.

What language is live2d-add-motion-sample-web-ui written in?

Mainly Python. The stack also includes Python, JavaScript, PixiJS.

How hard is live2d-add-motion-sample-web-ui to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is live2d-add-motion-sample-web-ui for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.