ComfyUI Node: Load Video

Load Video:

The LoadVideo node is designed to facilitate the loading and processing of video files within your AI art projects. This node allows you to extract frames from a video file, starting from a specified frame and limiting the number of frames to be loaded. It supports various video formats, including .mp4, .mov, .avi, .webm, .gif, and .webp. By converting video frames into a format suitable for further processing, this node enables you to incorporate dynamic visual elements into your AI-generated artwork. The primary goal of the LoadVideo node is to streamline the integration of video content, making it easier for you to work with video data in your creative projects.

Load Video Input Parameters:

video

This parameter specifies the path to the video file you want to load. The path should be provided as a string, and the video file must be in one of the supported formats: .mp4, .mov, .avi, .webm, .gif, or .webp. The node will use this path to locate and read the video file.

frame_start

This parameter determines the starting frame from which the video frames will be loaded. It is an integer value with a default of 0, meaning the loading will start from the very first frame of the video. You can adjust this value to skip a certain number of initial frames if needed. The minimum value is 0, and there is no explicit maximum value, but it should be within the total number of frames in the video.

frame_limit

This parameter sets the maximum number of frames to be loaded from the video. It is an integer value with a default of 16, meaning the node will load up to 16 frames starting from the frame_start position. You can adjust this value to load more or fewer frames based on your requirements. The minimum value is 1, and the maximum value is 4096.

Load Video Output Parameters:

frames

This output parameter is a tensor containing the loaded video frames. The frames are concatenated along the first dimension, resulting in a single tensor that can be used for further processing. The number of frames in the tensor corresponds to the actual number of frames loaded, which may be less than the frame_limit if the video has fewer frames available.

frame_count

This output parameter is an integer representing the total number of frames successfully loaded from the video. It provides a count of the frames included in the frames tensor, which can be useful for verifying the amount of data processed and for further operations that depend on the frame count.

Load Video Usage Tips:

• Ensure that the video file path provided in the video parameter is correct and accessible to avoid file not found errors.
• Adjust the frame_start parameter to skip unnecessary initial frames and focus on the relevant part of the video.
• Use the frame_limit parameter to control the number of frames loaded, balancing between performance and the amount of data needed for your project.
• Verify the supported video formats and convert your video files to one of these formats if necessary to ensure compatibility.

Load Video Common Errors and Solutions:

Unsupported video format: <ext>

• Explanation: This error occurs when the video file format is not supported by the LoadVideo node.
• Solution: Ensure that your video file is in one of the supported formats: .mp4, .mov, .avi, .webm, .gif, or .webp. Convert your video to a supported format if necessary.

Could not find ffmpeg

• Explanation: This error indicates that the ffmpeg tool, which is required for processing certain video formats, is not installed or not found in the system's PATH.
• Solution: Install ffmpeg on your system and ensure it is accessible from the command line. You can download ffmpeg from its official website and follow the installation instructions for your operating system.

File not found: <video_path>

• Explanation: This error occurs when the specified video file path does not exist or is incorrect.
• Solution: Verify that the video file path provided in the video parameter is correct and that the file exists at the specified location. Ensure there are no typos or missing directories in the path.

Error reading frame from video

• Explanation: This error occurs when there is an issue reading a frame from the video file, possibly due to file corruption or unsupported codec.
• Solution: Check the integrity of the video file and ensure it is not corrupted. If the issue persists, try converting the video to a different supported format or codec.