From f6032e864b2d405d4793dc2b617a052d58be80b7 Mon Sep 17 00:00:00 2001
From: BluLupo <hersel1991@gmail.com>
Date: Wed, 8 Apr 2026 11:49:43 +0200
Subject: [PATCH] Enhance README for Visemes Converter Tool

Expanded README with detailed features and installation instructions.
---
 README.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0e3e9c2..25018ff 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,32 @@
-# visemes
-Visemes Converter Tool
+# 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://github.com/BluLupo/visemes/blob/main/DOCUMENTATION.md)