Update MotionSmith-Surface README.md to English

blender/MotionSmith-Surface/README.md

@@ -1,15 +1,58 @@
 # MotionSmith Surface for Blender
 
-Blender 5.2 (5.0+) için ComfyUI, UltraTex ve Ubisoft Chord destekli AI PBR doku üretim eklentisi.
+AI-powered PBR texture generation and material synthesis add-on for Blender (5.0+), powered by a local ComfyUI backend using **UltraTex** and **Ubisoft Chord**.
 
-## Dağıtım ve İçerik
+---
 
-- `motionsmith_surface.zip`: Blender için paketlenmiş hazır eklenti paketi (Extension).
-- Sürüm: `0.1.0`
-- Asgari Blender Sürümü: `5.0.0`
-- Desteklenen Backend: ComfyUI (UltraTex & Ubisoft Chord PBR)
+## Overview
 
-## Kurulum
-1. Blender'ı açın (`Edit > Preferences > Add-ons`).
-2. Sağ üstteki açılır menüden `Install from Disk...` seçeneğiyle `motionsmith_surface.zip` dosyasını seçin.
-3. `3D Viewport > N Panel > Surface` sekmesinden ComfyUI sunucusunu başlatın ve modelinizi dokulandırın.
+**MotionSmith Surface** bridges Blender's 3D viewport with cutting-edge diffusion and material estimation models. It allows artists to generate, delight, and bake production-ready PBR texture maps (Basecolor, Normal, Roughness, Metallic, Height) directly onto selected 3D meshes without leaving Blender.
+
+### Key Capabilities
+
+- **Automated Multi-View Texture Baking:** Single-pass 6 canonical views, two-pass 10 views with diagonal refinement, or manual multi-angle calibrated camera setups.
+- **PBR Decomposition (Ubisoft Chord):** Extracts intrinsic physical surface properties from diffuse/render inputs, eliminating lighting baked-in highlights and shadows.
+- **Poisson Height Integration:** Converts surface normal curvature into accurate displacement/height maps.
+- **GGUF & Quantization Support:** Optimized memory footprint running efficiently on standard consumer GPUs (e.g., RTX 4070 / 5070 series).
+- **Non-Destructive UV Workflow:** Integrates Comfy GPU / xatlas UV unwrapping with automatic transfer back to the source Blender mesh.
+
+---
+
+## Requirements
+
+- **Blender:** 5.0.0 or newer (tested on Blender 5.2)
+- **Inference Engine:** Local ComfyUI instance (`v0.27.0+`) running at `http://127.0.0.1:8188`
+- **Supported Hardware:** NVIDIA GPU with CUDA 12.8+ / PyTorch 2.8+ (16 GB VRAM recommended)
+- **ComfyUI Custom Nodes:**
+  - `ComfyUI-UltraTex` / `comfyui_ultratex_modular`
+  - `ComfyUI-Chord`
+  - `ComfyUI-GGUF`
+  - `comfyui-rmbg`
+
+---
+
+## Installation
+
+1. Download the latest `motionsmith_surface.zip` release archive.
+2. In Blender, navigate to **Edit > Preferences > Add-ons**.
+3. Click the top-right menu icon and select **Install from Disk...**.
+4. Choose `motionsmith_surface.zip` and enable **MotionSmith Surface**.
+5. Configure your local ComfyUI path and model directories in Add-on Preferences.
+
+---
+
+## Usage
+
+1. In Blender's **Object Mode**, select the target mesh you want to texture.
+2. Open the **3D Viewport > Sidebar (N) > Surface** panel.
+3. Click **Start Server** to launch or attach to the local ComfyUI instance.
+4. Select your preferred workflow (e.g., *6 Views - 1 Pass*, *10 Views - 2 Pass*, or *Manual 10 Views*).
+5. Set your prompt or reference image, tune generation parameters, and press **Generate Texture**.
+6. Textures are automatically baked, packed into the `.blend` file, and applied to the viewport material.
+
+---
+
+## License
+
+- MotionSmith Surface Add-on: Released under the GNU General Public License v3.0 or later (GPL-3.0-or-later).
+- Underlying research models (UltraTex, Ubisoft Chord) follow their respective open-source and research licenses.