From b2d7d3b634b2b2c85e9294d2b4f95e75079880e6 Mon Sep 17 00:00:00 2001 From: Ethanfel Date: Sat, 14 Feb 2026 17:06:55 +0100 Subject: [PATCH] Update README: document target FPS mode, fix repo URL, update concat description Co-Authored-By: Claude Opus 4.6 --- README.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index a85fc35..f8db68f 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,8 @@ Interpolates frames from an image batch. | **keep_device** | Keep model on GPU between pairs (faster, ~200MB constant VRAM) | | **all_on_gpu** | Keep all intermediate frames on GPU (fast, needs large VRAM) | | **clear_cache_after_n_frames** | Clear CUDA cache every N pairs to prevent VRAM buildup | +| **source_fps** | Input frame rate. Required when target_fps > 0 | +| **target_fps** | Target output FPS. When > 0, overrides multiplier — auto-computes the optimal power-of-2 oversample then selects frames at exact target timestamps. 0 = use multiplier | #### BIM-VFI Segment Interpolate @@ -53,7 +55,7 @@ Same as Interpolate but processes a single segment of the input. Chain multiple ### Tween Concat Videos -Concatenates segment video files into a single video using ffmpeg. Connect from any Segment Interpolate's model output to ensure it runs after all segments are saved. Works with all three models. +Concatenates segment video files into a single video using ffmpeg. Connect from any Segment Interpolate's model output to ensure it runs after all segments are saved. Works with all four models. ### EMA-VFI @@ -76,7 +78,7 @@ Available checkpoints: #### EMA-VFI Interpolate -Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate. +Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate (including target FPS mode). #### EMA-VFI Segment Interpolate @@ -101,7 +103,7 @@ Available checkpoints: #### SGM-VFI Interpolate -Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate. +Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate (including target FPS mode). #### SGM-VFI Segment Interpolate @@ -126,7 +128,7 @@ Available checkpoints: #### GIMM-VFI Interpolate -Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate, plus: +Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate (including target FPS mode), plus: | Input | Description | |-------|-------------| @@ -136,7 +138,9 @@ Interpolates frames from an image batch. Same controls as BIM-VFI Interpolate, p Same as GIMM-VFI Interpolate but processes a single segment. Same pattern as BIM-VFI Segment Interpolate. -**Output frame count (all models):** 2x = 2N-1, 4x = 4N-3, 8x = 8N-7 +**Output frame count (all models):** +- Multiplier mode: 2x = 2N-1, 4x = 4N-3, 8x = 8N-7 +- Target FPS mode: `floor((N-1) / source_fps * target_fps) + 1` frames. Automatically oversamples to the nearest power-of-2 above the ratio, then selects frames at exact target timestamps. Downsampling (target < source) also works — frames are selected from the input with no model calls ## Installation @@ -144,7 +148,7 @@ Clone into your ComfyUI `custom_nodes/` directory: ```bash cd ComfyUI/custom_nodes -git clone https://github.com/your-user/ComfyUI-Tween.git +git clone https://github.com/Ethanfel/ComfyUI-Tween.git ``` Dependencies (`gdown`, `cupy`, `timm`, `omegaconf`, `easydict`, `yacs`, `einops`, `huggingface_hub`) are auto-installed on first load. The correct `cupy` variant is detected from your PyTorch CUDA version.