Simplify README
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user