ComfyUI Node: Save Video

Save Video:

The easy saveVideo node is designed to facilitate the seamless saving of video content within the ComfyUI environment. This node is particularly beneficial for AI artists who need to convert a series of images and optional audio into a cohesive video file. It simplifies the process by automatically handling video encoding, audio integration, and metadata preservation, ensuring that the final output is both high-quality and ready for immediate use or further editing. The node's primary goal is to streamline video creation by providing an intuitive interface that abstracts the complexities of video processing, making it accessible to users without a technical background.

Save Video Input Parameters:

input_mode

The input_mode parameter determines the source of the video content. It can be set to either "video" or "images+audio". When set to "video", the node expects a pre-existing video file as input. When set to "images+audio", it requires a series of images and optional audio to create a video. This parameter is crucial as it dictates the node's processing path and the type of input data it will handle.

output_mode

The output_mode parameter specifies how the video should be saved. It can be set to "save" or "preview_only". When set to "save", the video is saved to the output directory, while "preview_only" saves it to a temporary directory for quick review. This parameter affects where the video file is stored and whether it is intended for final use or just for preview purposes.

save_metadata

The save_metadata parameter is a boolean that indicates whether to include metadata in the saved video file. When set to true, any available metadata, such as prompts or additional information, is embedded in the video. This is useful for preserving context or details about the video creation process.

video

The video parameter is used when input_mode is set to "video". It represents the video file that will be processed and saved. This parameter is essential for operations that involve modifying or saving an existing video file.

images

The images parameter is used when input_mode is set to "images+audio". It consists of a series of images that will be compiled into a video. This parameter is critical for creating a video from scratch using individual frames.

audio

The audio parameter is optional and can be used in both input modes. It represents the audio track that will be integrated into the video. Including audio can enhance the video by providing sound, making it more engaging.

fps

The fps parameter stands for frames per second and is used when input_mode is "images+audio". It defines the frame rate of the resulting video, affecting its smoothness and playback speed. The default value is typically 24.0, which is standard for most video content.

Save Video Output Parameters:

source_video

The source_video output parameter represents the final video file that has been processed and saved. It includes any modifications made during the node's execution, such as audio integration or metadata embedding. This output is crucial as it is the end product that users will utilize or distribute.

relative_path

The relative_path output parameter provides the path to the saved video file relative to the output or temporary directory. This is important for locating the video file within the file system and for referencing it in subsequent operations or workflows.

Save Video Usage Tips:

• Ensure that the input_mode is correctly set to match the type of input data you are providing, whether it's a video file or a series of images and audio.
• Use the output_mode to control whether you want to save the video for final use or just for a quick preview, which can save time and storage space.
• If you want to preserve additional information about the video creation process, enable the save_metadata option to embed metadata in the video file.

Save Video Common Errors and Solutions:

A VIDEO input is required when input_mode is 'video'.

• Explanation: This error occurs when the input_mode is set to "video" but no video file is provided.
• Solution: Ensure that a valid video file is supplied when using the "video" input mode.

An IMAGES input is required when input_mode is 'images+audio'.

• Explanation: This error arises when the input_mode is set to "images+audio" but no images are provided.
• Solution: Provide a series of images to be compiled into a video when using the "images+audio" input mode.

FFmpeg audio replace failed

• Explanation: This error indicates that the process of replacing the audio track in the video using FFmpeg has failed.
• Solution: Check the audio file for compatibility issues or try using a different audio format. If the problem persists, consider using the tensor-based fallback method for audio integration.