ComfyUI Node: (deforum) Save Video

(deforum) Save Video:

The DeforumVideoSaveNode is designed to facilitate the process of saving video files generated from a series of images. This node is particularly useful for AI artists who work with animation and video creation, as it allows for the seamless conversion of image sequences into various video formats. The node offers a range of customizable parameters, enabling you to specify the desired video codec, frame rate, pixel format, and quality, among other settings. Additionally, it supports the inclusion of audio tracks and waveform images, providing a comprehensive solution for video production. The primary goal of this node is to streamline the video saving process, ensuring that you can efficiently produce high-quality videos from your creative projects.

(deforum) Save Video Input Parameters:

image

This parameter accepts the sequence of images that will be compiled into a video. The images should be provided in a format that the node can process, typically as an array or list of image objects.

filename_prefix

This string parameter sets the prefix for the output video file's name. The default value is "Deforum", and you can customize it to suit your project's naming conventions.

fps

This integer parameter defines the frames per second (fps) for the output video. The default value is 24, with a minimum of 1 and a maximum of 10000. Adjusting this value will affect the playback speed of the video.

codec

This parameter specifies the video codec to be used for encoding the video. Available options include "libx265", "libx264", "libvpx-vp9", "libaom-av1", "mpeg4", and "libvpx". The choice of codec can impact the video quality and file size.

pixel_format

This parameter determines the pixel format for the video. Options include "yuv420p", "yuv422p", "yuv444p", "yuvj420p", "yuvj422p", "yuvj444p", "rgb24", "rgba", "nv12", and "nv21". The pixel format affects the color representation and compatibility with different playback devices.

format

This parameter sets the output video format, with options such as "mp4", "mov", "gif", and "avi". The format you choose will determine the file extension and compatibility with various media players.

quality

This integer parameter controls the quality of the output video, ranging from 1 to 10, with a default value of 10. Higher values result in better video quality but larger file sizes.

dump_by

This parameter specifies the condition for dumping frames to create the video. Options include "max_frames" and "per_N_frames". This setting determines when the node will compile the images into a video.

dump_every

This integer parameter works in conjunction with the "dump_by" setting. It defines the number of frames after which the video should be dumped. The default value is 0, with a range from 0 to 4096.

dump_now

This boolean parameter, when set to True, forces the node to dump the video immediately. The default value is False.

skip_save

This boolean parameter, when set to True, skips the saving of the video file. The default value is False.

skip_return

This boolean parameter, when set to True, skips returning the video file as an output. The default value is True.

enable_preview

This boolean parameter enables or disables the preview of the video. The default value is True.

deforum_frame_data

This optional parameter accepts additional frame data specific to Deforum, which can be used to customize the video creation process further.

audio

This optional parameter allows you to include an audio track in the video. The audio should be provided in a compatible format.

waveform_image

This optional parameter accepts an image of the audio waveform, which can be included in the video.

restore

This boolean parameter, when set to True, restores the previous state of the node. The default value is False.

clear_cache

This boolean parameter, when set to True, clears the cache of stored images. The default value is False.

(deforum) Save Video Output Parameters:

video_file

The primary output of this node is the saved video file, which is generated based on the input parameters and settings. The video file will be saved in the specified format and location, ready for playback or further editing.

(deforum) Save Video Usage Tips:

• To achieve the best video quality, set the quality parameter to a higher value, but be mindful of the resulting file size.
• Use the fps parameter to control the playback speed of your video. A higher fps value results in smoother motion.
• Experiment with different codec and pixel_format options to find the best combination for your specific needs and playback devices.
• Utilize the audio and waveform_image parameters to enhance your video with sound and visual audio representation.

(deforum) Save Video Common Errors and Solutions:

"Invalid image format"

• Explanation: The provided images are not in a format that the node can process.
• Solution: Ensure that the images are in a compatible format, such as an array or list of image objects.

"Unsupported codec"

• Explanation: The selected codec is not supported by the node.
• Solution: Choose a codec from the available options: "libx265", "libx264", "libvpx-vp9", "libaom-av1", "mpeg4", or "libvpx".

"Frame rate out of range"

• Explanation: The specified fps value is outside the acceptable range.
• Solution: Set the fps value between 1 and 10000.

"Invalid pixel format"

• Explanation: The selected pixel format is not supported.
• Solution: Choose a pixel format from the available options: "yuv420p", "yuv422p", "yuv444p", "yuvj420p", "yuvj422p", "yuvj444p", "rgb24", "rgba", "nv12", or "nv21".

"Dump every value out of range"

• Explanation: The dump_every parameter is set to a value outside the acceptable range.
• Solution: Set the dump_every value between 0 and 4096.