Simplify README

This commit is contained in:
Kangle
2026-01-29 11:55:46 +00:00
parent aaad09ddae
commit 146f359c2c
+5 -67
View File
@@ -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=<value>`
### 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.