Load Video (Upload) 🎥🅥🅗🅢(LoadVideoUpload)
The main function of this node is to serve as the starting point of the video processing workflow.
Load Video Upload
The Load Video (Upload) 🎥🅥🅗🅢 node serves as the starting point for video processing workflows.
The Load Video (Upload) 🎥🅥🅗🅢 node is a core component of the Video Helper Suite toolkit, specifically designed to load user-uploaded video files into ComfyUI workflows. It reads video files and decomposes them into a series of individual image frames for subsequent image processing, AI generation, or video editing operations.
Node Functionality
The primary function of this node is to act as the starting point for video processing pipelines. It not only extracts the visual frame sequence from a video but also separates the audio track and provides video metadata, supplying the foundational material for subsequent tasks such as frame analysis, content modification, style transfer, or re-synthesis. Users can finely control the video loading process through various parameters.
Node Parameter Description - Load Video (Upload) 🎥🅥🅗🅢
Connection Inputs (Inputs)
| Parameter Name | Data Type | Required | Default Value | Range/Options | Description |
|---|---|---|---|---|---|
video | COMBO | Yes | - | - | : Select the video file to load. This list automatically scans and displays all supported video format files in the input directory. |
meta_batch | VHS_BATCHMANAGER | No | - | - | : (Optional) Connect a batch manager to coordinate the loading and processing of multiple videos or image sequences in complex workflows. |
vae | VAE | No | - | - | : (Optional) Connect a VAE model. The node will then directly output the latent space representation of the video frames instead of pixel images. |
Control Parameters (Parameters)
| Parameter Name | Data Type | Required | Default Value | Range/Options | Description |
|---|---|---|---|---|---|
force_rate | COMBO | Yes | 0 | 0 - 60 (Step: 1) | : Force-set the frame rate for the output frame sequence, range 0-60, step 1. Setting it to 0 uses the video's original frame rate. |
custom_width | INT | Yes | 0 | 0 - DIMMAX | : Customize the width of the output images, range 0 to DIMMAX. Setting it to 0 preserves the video's original width. |
custom_height | INT | Yes | 0 | 0 - DIMMAX | : Customize the height of the output images, range 0 to DIMMAX. Setting it to 0 preserves the video's original height. |
frame_load_cap | INT | Yes | 0 | 0 - BIGMAX (Step: 1) | : Limit the maximum number of frames to load, range 0 to BIGMAX, step 1. Setting it to 0 loads all frames. |
skip_first_frames | INT | Yes | 0 | 0 - BIGMAX (Step: 1) | : Skip a specified number of frames from the beginning of the video, range 0 to BIGMAX, step 1. |
select_every_nth | INT | Yes | 1 | 1 - BIGMAX (Step: 1) | : Load every Nth frame, range 1 to BIGMAX, step 1. Used to reduce frame rate or extract keyframes. |
Output
| Parameter Name | Data Type | Description |
|---|---|---|
| IMAGE | UNKNOWN | : Outputs the video's frame sequence, with each frame as an image. |
| frame_count | INT | : Outputs the total number of video frames loaded. |
| audio | AUDIO | : Outputs the audio data separated from the video. |
| video_info | VHS_VIDEOINFO | : Provides video metadata such as dimensions, frame count, and frame rate. |
Usage Scenarios
Its typical usage scenarios include: preparing video sources for image generation models like Stable Diffusion for inpainting or stylization within frames; extracting keyframes from videos for analysis; separating video and audio for independent processing; or managing multiple video clips in batch processing workflows. It supports various common video formats and is the first step in building Video-to-Video workflows.
Load Video (Upload) 🎥🅥🅗🅢 Node Source Code Link
The Load Video (Upload) 🎥🅥🅗🅢 node is from the ComfyUI-VideoHelperSuite node package.
Comments
Sign in with GitHub to join the discussion.