diff --git a/README.md b/README.md
index 9378157..5886b10 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,100 @@
-# Comfyui-Json-Manager
-Streamlit webui and comfyui node to manage comfyui paramaters with json
+# 🎛️ AI Settings Manager for ComfyUI
+
+A powerful, visual dashboard for managing, versioning, and batch-processing JSON configuration files used in AI video generation workflows (I2V, VACE).
+
+This tool consists of two parts:
+1.  **Streamlit Web Interface:** A Dockerized editor to manage prompts, LoRAs, and settings.
+2.  **ComfyUI Custom Nodes:** A set of nodes to read these JSON files directly into your workflows.
+
+---
+
+## ✨ Features
+
+### 📝 Single File Editor
+* **Visual Interface:** Edit Prompts, Negative Prompts, Seeds, LoRAs, and advanced settings (Camera, FLF, VACE params) without touching raw JSON.
+* **Smart History:** Every save allows you to create a "Snapshot." You can view, restore, or edit historical versions of your prompts instantly.
+* **Conflict Protection:** Prevents accidental overwrites if the file is modified by another tab or process.
+* **Snippet Library:** Save reusable prompt fragments (e.g., "Cinematic Lighting", "Anime Style") and append them with one click.
+
+### 🚀 Batch Processor
+* **Sequence Management:** Create unlimited sequences within a single JSON file.
+* **Import Tools:** Copy settings from **any other file** or **history entry** into your current batch sequence.
+* **Promote to Single:** Liked a specific shot in your batch? One-click convert a sequence back into a standalone Single File.
+* **Infinite Looping:** ComfyUI nodes automatically loop through sequences (modulo logic), allowing for infinite generation runs.
+
+---
+
+## 🛠️ Installation
+
+### 1. Unraid / Docker Setup (The Manager)
+This tool is designed to run as a lightweight container on Unraid.
+
+1.  **Prepare a Folder:** Create a folder on your server (e.g., `/mnt/user/appdata/ai-manager/`) and place the following files inside:
+    * `app.py`
+    * `utils.py`
+    * `tab_single.py`
+    * `tab_batch.py`
+2.  **Add Container in Unraid:**
+    * **Repository:** `python:3.12-slim`
+    * **Network:** `Bridge`
+    * **WebUI:** `http://[IP]:[PORT:8501]`
+3.  **Path Mappings:**
+    * **App Location:** Container `/app` ↔ Host `/mnt/user/appdata/ai-manager/`
+    * **Project Data:** Container `/mnt/user/` ↔ Host `/mnt/user/` (Your media/JSON location)
+4.  **Post Arguments (Crucial):**
+    Enable "Advanced View" and paste this into **Post Arguments**:
+    ```bash
+    /bin/sh -c "pip install streamlit opencv-python-headless && cd /app && streamlit run app.py --server.headless true --server.port 8501"
+    ```
+
+### 2. ComfyUI Setup (The Nodes)
+1.  Navigate to your ComfyUI installation: `ComfyUI/custom_nodes/`
+2.  Create a folder named `ComfyUI-JSON-Loader`.
+3.  Place the `json_loader.py` file inside.
+4.  Restart ComfyUI.
+
+---
+
+## 🖥️ Usage Guide
+
+### The Web Interface
+Navigate to your container's IP (e.g., `http://192.168.1.100:8501`).
+
+* **Navigator:** Use the sidebar to browse folders and "Pin" favorites for quick access.
+* **Editing:** Select a JSON file. If it's a batch file, the app will auto-detect it and ask you to switch to the **Batch Tab**.
+* **Saving:**
+    * **Update File:** Saves changes to disk.
+    * **Snapshot:** Saves changes AND creates a history entry with a custom note.
+
+### ComfyUI Workflow
+Search for "JSON" in ComfyUI to find the new nodes.
+
+#### Standard Nodes (For Single Files)
+| Node Name | Description |
+| :--- | :--- |
+| **JSON Loader (Standard/I2V)** | Outputs prompts, FLF, Seed, and paths for Image-to-Video workflows. |
+| **JSON Loader (VACE Full)** | Outputs everything above plus specific VACE integers (frames to skip, schedule, etc.). |
+| **JSON Loader (LoRAs Only)** | Outputs the 6 LoRA strings. Keeps your main graph clean. |
+
+#### Batch Nodes (For Sequences)
+These nodes accept a `sequence_number` integer input.
+* **Input:** Connect a `Primitive` node (set to increment) or a `Batch Indexer` to the `sequence_number` input.
+* **Logic:** If you request Sequence #5 but the file only has 3 sequences, it wraps around (Sequence #2). This allows infinite loops.
+
+| Node Name | Description |
+| :--- | :--- |
+| **JSON Batch Loader (I2V)** | Loads specific sequence data for I2V. |
+| **JSON Batch Loader (VACE)** | Loads specific sequence data for VACE. |
+| **JSON Batch Loader (LoRAs)** | Loads the specific LoRAs assigned to that sequence. |
+
+---
+
+## 📂 File Structure
+
+```text
+/ai-manager
+├── app.py              # Main Streamlit entry point
+├── utils.py            # Configuration, I/O logic, and Defaults
+├── tab_single.py       # UI Logic for Single File Editor
+├── tab_batch.py        # UI Logic for Batch Processor
+└── json_loader.py      # ComfyUI Custom Node script