ComfyUI Simple Video Effects

A collection of lightweight, production-ready video manipulation nodes for ComfyUI. All nodes operate on batched IMAGE tensors (B, H, W, C) and are designed for smooth, high-quality transformations without breaking aspect ratio.

This bundle includes:

1. Zoom Sequence – per-batch zoom in/out with easing
2. Batched Zoom Sequence – persistent zoom across multiple batches
3. Camera Move – pan/slide across the frame
4. Camera Shake – procedural handheld/chaotic motion
5. Video Overlay – alpha-blend / composite one video over another

---

📦 Installation

Place all .py files into:

ComfyUI/custom_nodes/ComfyUI_SimpleVideoEffects/

Restart ComfyUI.

---

🎥 1. ZoomSequenceNode

Single-batch smooth zoom-in/out with aspect-correct cropping Source: comfy_zoom_sequence.py

What it does

Creates a smooth zoom-in or zoom-out animation across a batch of frames while maintaining the original canvas size and aspect ratio.

Key Features

• Zoom in or out across the batch
• Progressive zoom per frame
• Choose from: Linear, Ease-In, Ease-Out, Ease-In-Out
• Automatic aspect-correct cropping
• Prevents over-zooming using safe margin clamp

Inputs

Name	Type	Description
images	IMAGE	Batched frames
mode	Zoom In / Zoom Out
pixels_per_frame	FLOAT	Zoom speed, based on smaller canvas dimension
ease	Linear / Ease_In / Ease_Out / Ease_In_Out

Outputs

• images – transformed frames
• info – diagnostics, safe-limit notes, applied margins

How it works

The node computes a per-frame eased progress value, converts it into a small-dimension margin, and crops proportionally on both axes to retain aspect ratio before resizing back to original resolution. All cropping is done with integer-accurate bounds.

---

🎥 2. ZoomSequenceNode (Batched / Persistent)

Persistent zoom across multiple batches Source: comfy_zoom_sequence_batched.py

What it does

Extends ZoomSequence to support streamed / chunked video processing. Zoom state is stored in a temporary JSON file and automatically resumes between node calls.

Key Features

• Continues zoom from previous batch
• Automatically clears state when end-of-video is reached
• Fully aspect-correct
• Same easing options and zoom behavior as single-batch version

Inputs

Name	Type	Description
images	IMAGE	Batch of frames
source_frame_count	INT	Total number of frames in whole video
mode	Zoom In/Out
pixels_per_frame	FLOAT	Zoom speed
ease	Easing mode

How it works

The node tracks:

• Last processed global frame index
• Max zoom margin
• Canvas dimensions
• Easing + mode consistency

State resets when the node reaches frame source_frame_count - 1.

---

🎥 3. CameraMoveNode

Smooth pan / slide / 2D translation Source: comfy_camera_move.py

What it does

Moves the camera viewport across the frame in X/Y over the batch, creating a pan or tracking-shot effect.

Typical Controls

• move_x_start, move_x_end
• move_y_start, move_y_end
• ease
• clamp_edges
• pixels_per_frame or percentage-based movement

Output

• Frames translated with border fill (usually black or edge-clamped)
• Handy for synthetic dolly, parallax, or motion-graphics effects

---

🎥 4. CameraShakeNode

Procedural handheld shake Source: comfy_camera_shake.py

What it does

Adds natural-feeling camera shake using Perlin/random noise.

Features

• Adjustable shake amplitude
• Frequency control
• Random seed for reproducibility
• Optional motion-blur-friendly smoothness

Great for action shots, handheld look, or simulating vibrations.

---

🎥 5. VideoOverlayNode

Composite one video onto another Source: comfy_video_overlay.py

What it does

Alpha-blends a foreground video onto a background video.

Features

• Supports per-pixel alpha channel
• Automatic batch alignment
• Position + scale controls
• Optional auto-fit

---

🎥 6. Comfy Video Combiner

This script provides a ComfyUI-compatible node for automatically combining multiple video files from a directory into a single edited output. It offers robust handling of transitions, fades, audio overlays, randomization, and resolution normalization—all wrapped in an easy-to-use, configurable ComfyUI node.

Inspired by: DarioFT / ComfyUI-VideoDirCombiner

---

✨ Features

🔍 Directory Scanning & File Control

• Scans a target directory for video files matching a pattern (e.g., *.mp4).
• Supports alphabetical sorting.
• Supports randomized order with optional seed.
• Guarantees no repeated clips.

🎬 Video Transitions & Fades

• Optional crossfade transitions between clips.
• Optional fade-in from a solid color.
• Optional fade-out to a solid color.
• All fade colors sanitized to #RRGGBB.

🔊 Audio Integration (VideoHelperSuite)

• Accepts VHS/ComfyUI audio format input.

• Supports both:

  • Direct audio file paths, or
  • Waveform + sample rate tensors (auto-converted to WAV).

• Optional trimming of final video to match audio duration.

• Final fade-out will automatically adjust to audio length if needed.

⚙️ Resolution & FPS Normalization

• Detects the first video’s:

  • width
  • height
  • FPS

• Normalizes all clips (and color fades) to match it, ensuring alignment and avoiding FPS-related errors.

🚀 Performance

• Uses parallel duration probing (ThreadPoolExecutor).
• Uses optimized ffmpeg filter-graphs for transitions.
• Automatic cleanup of temporary files.

🧪 Safety & Robustness

• Unique output filenames (avoids overwriting).

• Detailed validation and error messages.

• Proper handling of edge cases like:

  • Clips shorter than transition duration
  • Invalid hex color input
  • Missing or malformed audio dicts

---

🛠️ Inputs

Required Inputs

Name	Type	Description
directory_path	String	Folder containing video files
output_filename	String	Name of final output file
file_pattern	String	File glob pattern (e.g., *.mp4)
transition	Select	none or fade between clips
transition_duration	Float	Fade duration between clips

Optional Inputs

Name	Type	Purpose
sort_files	Boolean	Sort clips alphabetically
random_order	Boolean	Shuffle order (overrides sort)
seed	Int	Seeded randomization
music_track	AUDIO	VideoHelperSuite audio object
trim_to_audio	Boolean	End video when audio ends
fade_in_enabled	Bool	Prepend a color fade-in
fade_in_color	String	Hex color
fade_in_duration	Float	Fade-in length
fade_out_enabled	Bool	Append/force fade-out
fade_out_color	String	Hex color
fade_out_duration	Float	Fade-out length

---

📤 Output

The node returns a single string: output_path → Full path to the generated video file.

---

🧩 How It Works Internally

1. Load & Order Files

Uses glob pattern matching and optional sorting/shuffling.

2. Extract Video Metadata

Parallel ffprobe calls retrieve durations and video stream info.

3. Build FFmpeg Filtergraph

Depending on settings:

• Simple concatenation OR

• Complex graph with:

  • normalized FPS
  • color clip generation
  • chained xfade transitions
  • final fade-out tied to audio
  • overlaying custom audio

4. Render via FFmpeg

Quiet ffmpeg execution ensures efficient rendering.

5. Cleanup

Temporary files (WAV audio, concat lists) are deleted automatically.

---

📝 Notes

• If audio trimming is enabled, the script ensures fade-outs occur before the audio ends.
• Fades and transitions never exceed clip lengths; they are automatically clamped.
• Color fade-ins and fade-outs use ffmpeg's color source generator.

---

🧪 Troubleshooting

“Clamped margin” warnings

Zoom margin exceeded safe limit; node automatically prevents invalid cropping.

Zoom looks too slow

Increase pixels_per_frame.

Zoom resets unexpectedly

Ensure:

• Same canvas size
• Same parameters
• Same source_frame_count
• Same mode & ease between batches.

Overlay misaligned

Make sure both videos have identical batch length or use a repeater.

---

📄 License

MIT