# Anime2.5DRig

Anime2.5DRig turns a layered PSD into a live 2.5D avatar with automatic meshes, blinking, mouth motion, parallax, and spring-based hair physics.

## Quick start

1. Open **EasyVtuber Avatar Studio**.
2. Drop in a PNG and choose **Build Layered 2.5D**. The first local GPU build usually takes 5–12 minutes; later opens reuse the cached PSD.
3. Open Anime2.5DRig. The generated avatar loads automatically.
4. Choose the OBSBOT camera and enable **Face tracking**.

Face tracking drives head turn/tilt/roll, synchronized upper eyelids, lower-lid squint, gaze, brows, jaw opening, and smile shape. **Microphone mouth** is optional and can add audio-driven mouth movement.

## Main controls

- **Face tracking**: starts the local MediaPipe Face Landmarker.
- **Camera**: selects a Windows camera; OBSBOT and Pi cameras are preferred automatically.
- **Hair + tail physics**: enables the detected front/back hair and tail springs.
- **Chest motion**: controls the smooth upper-chest spring; the lower torso stays anchored.
- **Side arrows**: collapse or reopen the effects and tracking drawers.
- **Compositing**: standard blend modes, opacity/color controls, outline, glow, and supersampled rendering.
- **Transparent / Green screen / Dark**: changes only the preview background.
- **Save optimized PSD**: writes the cleaned, trimmed layered source.

The camera feed and face landmarks stay on this PC. The generated PSD and avatar are also loaded locally.

## Layer names

The automatic rigger recognizes `face`, `eyewhite`, `irides`, `eyelash`, `eye_close`, `eyebrow`, `mouth_open`, `mouth_close`, `nose`, `ears`, `neck`, `topwear`, `front hair`, and `back hair`. Left/right suffixes such as `-l` and `-r` are accepted.

## Technical pipeline

See [ANIMA prompt to usable VTuber](ANIMA_TO_VTUBER_PIPELINE.md) for the generation, alpha preparation, See-through separation, automatic rigging, tracking, packaging, and Cloudflare deployment architecture.
