diff --git a/README.md b/README.md index 63d65fb..f0b7373 100644 --- a/README.md +++ b/README.md @@ -1,60 +1,12 @@ # ComfyUI-ffmpeg-toolkit -FFmpeg-based custom nodes for ComfyUI that convert between videos and frame -batches. The focus is reliability and compatibility with real-world workflows. - -## Features - -- Split videos into ComfyUI IMAGE batches using FFmpeg -- Merge IMAGE batches into MP4 (H.264) videos using FFmpeg -- Interleave two frame batches (IMAGE or LATENT) to alternate frames -- Optional FPS override for both split and merge -- Outputs are compatible with Preview Image, VAE Encode, Save Image, and Save Video +FFmpeg-based custom nodes for ComfyUI that convert between videos and frame batches. ## Nodes -### FFmpeg Split Video - -Inputs: -- `video` (VIDEO or IMAGE) -- `fps` (FLOAT, default 0) - -Outputs: -- `frames` (IMAGE) - -Behavior: -- `fps = 0` keeps the source frame rate -- `fps > 0` resamples using `-vf fps=` - -### FFmpeg Merge Frames - -Inputs: -- `frames` (IMAGE or VIDEO) -- `fps` (FLOAT, default 30) - -Outputs: -- `video` (VIDEO) -- `frames` (IMAGE) - -Notes: -- The `frames` output is provided so you can connect to nodes that only accept - IMAGE inputs (for example, VHS Video Combine). -- If a VIDEO input is provided, it is passed through as `video` and its decoded - frames are returned on `frames`. - -### Interleave Frames - -Inputs: -- `batch_a` (IMAGE or LATENT) -- `batch_b` (IMAGE or LATENT) - -Outputs: -- `batch` (IMAGE or LATENT) - -Notes: -- Inputs must be the same type (IMAGE+IMAGE or LATENT+LATENT). -- If batch sizes differ, the node truncates to the shorter length and logs a warning. -- Output ordering is `A1, B1, A2, B2, ...`. +- FFmpeg Split Video (video → frames) +- FFmpeg Merge Frames (frames → video, plus frames pass-through) +- Interleave Frames (interleave 2–6 IMAGE/LATENT batches) ## Requirements @@ -67,20 +19,6 @@ Notes: 1. Clone or download this repo into `ComfyUI/custom_nodes/ComfyUI-ffmpeg-toolkit` 2. Restart ComfyUI -## Usage Examples - -- Video to frames: - - `Load Video` -> `FFmpeg Split Video` -> `Preview Image` / `VAE Encode` / `Save Image` - -- Frames to video: - - `IMAGE batch` -> `FFmpeg Merge Frames` -> `Save Video` - -- Frames to VHS Video Combine: - - `IMAGE batch` -> `FFmpeg Merge Frames` -> `frames` -> `VHS Video Combine` - -- Interleave two batches: - - `batch_a` + `batch_b` -> `Interleave Frames` -> `batch` - ## Troubleshooting -- "FFmpeg not found": install FFmpeg and make sure `ffmpeg` is in PATH. +- "FFmpeg not found": install FFmpeg and ensure `ffmpeg` is in PATH.