ComfyUI Node: Save Video

Save Video:

The JNodes_SaveVideo node is designed to facilitate the process of saving video files from a series of image frames. This node leverages the powerful ffmpeg tool to encode and save video files in various formats, ensuring high-quality output. It is particularly useful for AI artists who need to convert generated image sequences into video format for presentations, animations, or further processing. The node also supports the inclusion of metadata, which can be useful for maintaining detailed information about the video content. By automating the video saving process, this node helps streamline workflows and enhances productivity.

Save Video Input Parameters:

frames

This parameter expects a list of image frames that will be compiled into a video. Each frame should be in a format compatible with ffmpeg, typically raw RGB data. The quality and resolution of these frames directly impact the final video output.

frame_rate

The frame rate determines how many frames are displayed per second in the resulting video. A higher frame rate results in smoother motion but requires more frames. Common values are 24, 30, or 60 frames per second. The default value is typically 30.

filename

This is the base name for the output video file. The node will append appropriate extensions and counters to this base name to generate the final file name. Ensure the filename is valid for your operating system.

format_ext

This parameter specifies the video file format extension, such as mp4, avi, or mkv. The chosen format affects the video compression and compatibility with different media players.

save_metadata

A boolean parameter that indicates whether to save metadata along with the video. If set to True, the node will generate and include metadata in the video file. This can be useful for storing additional information about the video content.

full_output_folder

The directory path where the video file will be saved. Ensure this path is writable and has sufficient space to store the video file.

Save Video Output Parameters:

file_path

The path to the saved video file. This output parameter provides the exact location of the generated video, which can be used for further processing or playback.

Save Video Usage Tips:

• Ensure that all image frames are of the same resolution to avoid issues during video encoding.
• Use a higher frame rate for smoother animations, but be mindful of the increased file size and processing time.
• Choose the appropriate video format extension based on your needs for compatibility and compression.
• If you need to include metadata, set the save_metadata parameter to True and ensure the metadata is correctly formatted.

Save Video Common Errors and Solutions:

Could not find ffmpeg

• Explanation: The ffmpeg tool is not installed or not found in the system's PATH.
• Solution: Install ffmpeg and ensure it is accessible from the command line. You can download it from the official ffmpeg website and follow the installation instructions.

An error occurred when saving with metadata

• Explanation: There was an issue with the metadata format or the ffmpeg command used to include metadata.
• Solution: Check the metadata format for any special characters that need to be escaped. Ensure the metadata is correctly formatted and try again.

Invalid frame rate

• Explanation: The provided frame rate is not a valid number or is outside the acceptable range.
• Solution: Ensure the frame rate is a positive integer, typically between 1 and 60. Common values are 24, 30, or 60.

Output directory not writable

• Explanation: The specified output directory does not have write permissions or does not exist.
• Solution: Verify that the output directory exists and has the necessary write permissions. Create the directory if it does not exist.