Add README.md

README.md

@@ -0,0 +1,42 @@
+# ComfyUI-vid2frames
+
+ComfyUI custom node for selecting one useful still frame from a decoded video frame batch.
+
+## Node
+
+- `AIA_SelectVideoFrame` / **AIA Select Video Frame**
+
+The node accepts a batched ComfyUI `IMAGE` tensor and a selector string, then returns exactly one `IMAGE` frame.
+
+Supported selector targets:
+
+- empty / unknown / `best still` -> best still-frame scoring
+- `no face` -> lowest face score while still preferring usable frames
+- `blurry` -> blurriest reasonable frame
+- `moving` -> highest-motion frame with blur/light penalties
+- `static` -> lowest-motion sharp frame
+- `flicker` / `lighting` -> strongest lighting fluctuation
+
+## Metrics
+
+- Sharpness: Laplacian variance
+- Motion: neighbor frame pixel delta, smoothed over a 5-frame window
+- Lighting fluctuation: luminance delta, smoothed over a 5-frame window
+- Face score: MediaPipe face detection first, OpenCV Haar fallback
+- Edge penalty: first/last 8% of frames are penalized for longer videos
+
+## Install
+
+Clone into ComfyUI custom nodes:
+
+```bash
+cd /home/ComfyUI/custom_nodes
+git clone https://github.com/Pmobilee/ComfyUI-vid2frames.git
+pip install -r ComfyUI-vid2frames/requirements.txt
+```
+
+Restart ComfyUI after installation.
+
+## Workflow Use
+
+Wire decoded video frames into `AIA_SelectVideoFrame`, pass selector text such as `moving` or `no face`, then connect the output to `SaveImage`.