# Visemes Converter Tool

A Blender add-on for generating VRChat visemes from MMD blendshapes and converting shape key names to Japanese MMD format.

**Blender:** 3.0.0+
**Category:** Rigging
**UI Location:** View3D › Sidebar (N) › Visemes Tool

---

## Features

- Auto-detect MMD shape keys (あ / お / い / まばたき)
- Generate 15 standard VRChat visemes (`vrc.v_*`) + `vrc.blink`
- Live viewport preview before generating
- Reorder shape keys to VRChat standard order
- Convert English/VRChat blendshape names to Japanese MMD format

---

## Installation

1. `Edit > Preferences > Add-ons > Install`
2. Select `visemes.py`
3. Enable the add-on from the list

---

## Documentation

Full documentation available here:
[DOCUMENTATION.md](https://git.gwserver.it/hersel/visemes/src/branch/main/DOCUMENTATION.md)

---

## Credits

Thanks to [ShyWolf42/Copy-to-MMD-Visemes](https://github.com/ShyWolf42/Copy-to-MMD-Visemes)
Thanks to [teamneoneko/Cats-Blender-Plugin](https://github.com/teamneoneko/Cats-Blender-Plugin)