From 5514048c0716319cc75c799d664575d468709a3a Mon Sep 17 00:00:00 2001
From: jtrue <james@jtrue.com>
Date: Sat, 23 Aug 2025 18:52:13 -0400
Subject: [PATCH] Update README.md

---
 README.md | 90 ++++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 82 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 633845e..93bca3a 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,94 @@
 # ComfyUI-Rect
 
-Interactive rectangle tools for ComfyUI.  
+Interactive rectangle tools for ComfyUI.
+
 Includes an interactive **Rect / Select** (marching-ants popup) plus **Rect / Crop**, **Rect / Mask**, and **Rect / Fill**.  
-Outputs a reusable **RECT** object (`{x,y,w,h}`) and the four scalar values for compatibility with existing nodes.
+Outputs a reusable **RECT** object (`{x,y,w,h}`) **and** the four scalar values for compatibility with existing nodes.
 
 ---
 
 ## Features
-- 🖱️ **Interactive selector**: draw/refine a box over your input image
-- 🧱 **RECT type** + `x/y/w/h` ints for easy wiring
-- ✂️ **Crop**, 🧪 **Mask** (feather/invert/combine), 🟩 **Fill/Outline** (color + opacity)
-- 🚫 Bounds-safe, batch-safe, GPU/CPU friendly
-- 🧩 Modular pack layout (easy to extend)
+- 🖱️ Interactive selector: draw/refine a box over your input image
+- 🧱 Clean **RECT** type + `x/y/w/h` ints
+- ✂️ Crop, 🧪 Mask (feather/invert/combine), 🟩 Fill/Outline (color + opacity)
+- Bounds-safe, batch-safe, GPU/CPU friendly
+- Modular pack layout (easy to extend)
 
 ---
 
 ## Install
-
 1. Copy the folder **`ComfyUI-Rect`** into:
+   ```
+   ComfyUI/custom_nodes/
+   ```
+2. Restart ComfyUI.
+3. Open the UI with **`?nocache=1`** (e.g. `http://127.0.0.1:8188/?nocache=1`) to refresh front-end JS.
+
+> If the **“Open Rect / Select”** button doesn’t appear, it’s almost always cache—use `?nocache=1`.
+
+---
+
+## Nodes
+
+### Rect / Select
+**Inputs**
+- `image: IMAGE` (required)
+
+**Outputs**
+- `rect: RECT` (object with `x,y,w,h`)
+- `x: INT`, `y: INT`, `w: INT`, `h: INT`
+
+**UI**
+- Button **Open Rect / Select** opens an overlay where you drag a rectangle over the input image. Values sync back to the node.
+
+### Rect / Crop
+- **Inputs:** `image: IMAGE`, `rect: RECT`  
+- **Output:** `image: IMAGE` (cropped)
+
+### Rect / Mask
+- **Inputs:** `image: IMAGE`, `rect: RECT`  
+- **Options:** `feather (px)`, `invert`, `combine (replace/union/intersect/subtract/multiply)`  
+- **Optional:** `existing_mask: MASK`  
+- **Output:** `mask: MASK` (0..1)
+
+### Rect / Fill
+- **Inputs:** `image: IMAGE`, `rect: RECT`  
+- **Color:** `r,g,b` (0–255), `opacity` (0..1)  
+- **Mode:** `fill` or `outline`, `thickness` (outline), `feather`  
+- **Output:** `image: IMAGE` (blended)
+
+---
+
+## Quickstart
+1. **Load Image** → **Rect / Select** (click *Open Rect / Select*, draw a box)  
+2. Feed `rect` to:
+   - **Rect / Crop** → get a cropped image, or  
+   - **Rect / Mask** → build a mask (then drive any mask-aware node), or  
+   - **Rect / Fill** → draw a solid block or outline for redactions/callouts.
+
+---
+
+## RECT type
+A simple JSON-like object:
+```json
+{"x": 100, "y": 80, "w": 256, "h": 256}
+```
+All coordinates are in **image pixel space**. Values are clamped to the image bounds for safety.
+
+---
+
+## Troubleshooting
+- **Button missing (“Open Rect / Select”)** → open with `?nocache=1`.  
+- **No image in selector** → ensure the node’s `image` input is connected.  
+- **JS not loading** → verify the folder path is exactly `ComfyUI/custom_nodes/ComfyUI-Rect/` and restart ComfyUI.
+
+---
+
+## Roadmap
+- Rect / Transform (offset/expand/scale-around-center)  
+- Helper: Mask → Rect (BBox) (in companion *MaskTools* pack)
+
+---
+
+## License
+MIT