ComfyUI Node: Video Loader Crawl (CRT)

Video Loader Crawl (CRT):

The VideoLoaderCrawl node is designed to efficiently load video files from a specified directory, offering a streamlined way to access and process video content for AI art projects. This node is particularly beneficial for users who need to work with large collections of video files, as it can automatically scan directories, cache results for faster access, and handle various video formats such as .mp4, .webm, .mkv, .avi, and .mov. By leveraging a seed-based deterministic selection method, it ensures consistent video file selection across different runs, which is crucial for reproducibility in creative workflows. The node also provides the capability to limit the number of frames loaded from each video, allowing users to manage memory usage and processing time effectively. Overall, VideoLoaderCrawl simplifies the process of integrating video data into AI-driven artistic endeavors, making it an essential tool for artists working with video content.

Video Loader Crawl (CRT) Input Parameters:

folder_path

This parameter specifies the directory path where the video files are located. It is crucial for the node to know where to look for video content. The default value is set to C:\\videos, but you can change it to any directory path that suits your needs. This parameter directly impacts which video files are available for processing.

seed

The seed parameter is an integer that determines which video file is selected from the directory. By using a seed, the node ensures that the same video file is chosen consistently across different runs, which is important for reproducibility. The default value is 0, with a minimum of 0 and a maximum of 0xFFFFFFFFFFFFFFFF.

crawl_subfolders

This boolean parameter indicates whether the node should search for video files within subfolders of the specified directory. If set to True, the node will include subfolders in its search, potentially increasing the number of video files found. The default value is False.

remove_extension

This boolean parameter determines whether the file extension should be removed from the output file name. If set to True, the output will only include the file name without its extension, which can be useful for certain naming conventions. The default value is False.

frames_limit

This integer parameter sets the maximum number of frames to load from each video. A value of -1 indicates that all frames should be loaded, while any other positive integer limits the number of frames to that value. This parameter helps manage memory usage and processing time. The default value is 16, with a minimum of -1 and a maximum of 10000.

Video Loader Crawl (CRT) Output Parameters:

image_output

This output parameter is a tensor containing the frames of the selected video. The frames are stacked into a single tensor, which can be used for further processing or analysis in AI models. The frames are normalized to a float32 format with values between 0 and 1, making them ready for input into neural networks.

file_name

This output parameter provides the name of the selected video file. Depending on the remove_extension parameter, it may include or exclude the file extension. This output is useful for tracking which video file was processed, especially when working with multiple files.

Video Loader Crawl (CRT) Usage Tips:

• To ensure consistent video selection across different runs, use the same seed value. This is particularly useful when you need reproducible results for experiments or demonstrations.
• If you have a large collection of videos organized in subfolders, set crawl_subfolders to True to include all available files in the search.
• Adjust the frames_limit parameter based on your memory constraints and processing needs. Loading fewer frames can significantly reduce memory usage and speed up processing times.

Video Loader Crawl (CRT) Common Errors and Solutions:

🔎 Folder changed or not cached. Scanning '<folder>' for videos...

• Explanation: This message indicates that the folder contents have changed or were not previously cached, prompting a new scan for video files.
• Solution: Ensure that the folder path is correct and accessible. If the folder contents change frequently, expect this message as part of normal operation.

❌ Error accessing folder '<folder>': <error_message>

• Explanation: An error occurred while trying to access the specified folder, possibly due to permission issues or an incorrect path.
• Solution: Verify that the folder path is correct and that you have the necessary permissions to access it.

❌ No valid video files found in '<folder>'.

• Explanation: The node did not find any video files with supported extensions in the specified folder.
• Solution: Check that the folder contains video files with the correct extensions (.mp4, .webm, .mkv, .avi, .mov).

❌ Video open failed: <selected_file>

• Explanation: The node was unable to open the selected video file, possibly due to file corruption or unsupported format.
• Solution: Verify that the video file is not corrupted and is in a supported format. Try opening the file with a standard video player to check its integrity.

❌ No frames could be read from video: <selected_file>

• Explanation: The node could not read any frames from the video, which might indicate an issue with the video file.
• Solution: Check the video file for corruption and ensure it is playable. Consider re-encoding the video if necessary.

❌ Error: File '<selected_file>' was in cache but not found on disk. Invalidating cache for next run.

• Explanation: The cached file was not found on disk, possibly due to deletion or movement of the file.
• Solution: Ensure that the video files remain in their original location. If files are moved or deleted, expect the cache to be invalidated.