ComfyUI Node: StreamRecorder

StreamRecorder:

The StreamRecorder node is designed to facilitate the recording of live video streams, providing a robust and user-friendly interface for capturing and saving video content. This node is particularly beneficial for AI artists who need to record streams for later analysis, processing, or creative projects. It supports various video formats and codecs, ensuring compatibility with different streaming sources and output requirements. The node also offers options for scheduling recordings based on local time, setting the duration of the recording, and selecting the desired video quality. By leveraging hardware acceleration through CUDA, the StreamRecorder can efficiently handle high-quality video streams, making it a versatile tool for capturing live content.

StreamRecorder Input Parameters:

stream_url

The URL of the live stream you want to record. This parameter is essential as it specifies the source of the video stream. If not provided, the node will raise an error. The default value is an empty string.

use_local_time

A boolean option to determine whether to use the local time for scheduling the recording. If set to "true," the recording will start at the specified local time. The default value is "false."

start_time

The start time for the recording in the format "HH/MM/SS." This parameter is used when use_local_time is set to "true" to schedule the recording. The default value is the current time.

record_hours

The number of hours to record. This parameter helps define the total duration of the recording. The minimum value is 0, the maximum value is 12, and the default value is 0.

record_minutes

The number of minutes to record. This parameter, along with record_hours and record_seconds, defines the total duration of the recording. The minimum value is 0, the maximum value is 59, and the default value is 0.

record_seconds

The number of seconds to record. This parameter completes the total duration definition along with record_hours and record_minutes. The minimum value is 0, the maximum value is 59, and the default value is 60.

output_filename

The name of the output file where the recorded video will be saved. If the filename does not include the correct format extension, it will be automatically appended. The default value is an empty string.

video_format

The format of the output video file. Supported formats include "avi," "mov," "mkv," "mp4," "hls," "dash," "mss," "srt," "flv," "webm," "rtmp," "rtsp," "m3u8," "http," and "https." The default value is "mp4."

codec

The codec to be used for encoding the video. Supported codecs include "av1," "h264," "h264(NVENC)," "hevc," and "hevc(NVENC)." The default value is "h264(NVENC)."

video_quality

An integer value representing the quality of the video. Higher values correspond to lower quality and lower bitrate, while lower values correspond to higher quality and higher bitrate. The minimum value is 5, the maximum value is 40, and the default value is 10.

use_cuda

A boolean option to determine whether to use CUDA for hardware acceleration. If set to "true," CUDA will be used to accelerate the video encoding process. The default value is "true."

output_path

The directory path where the output file will be saved. If not provided, a file dialog will prompt you to select a location. The default value is an empty string.

StreamRecorder Output Parameters:

output_filename

The name of the output file where the recorded video has been saved. This parameter provides the full path to the saved video file, ensuring you can easily locate and access the recorded content.

StreamRecorder Usage Tips:

• Ensure the stream_url is correctly specified to avoid errors related to missing or invalid stream sources.
• Use the use_local_time and start_time parameters to schedule recordings for specific times, which is useful for capturing live events.
• Adjust the video_quality parameter to balance between video quality and file size, depending on your needs.
• Utilize the use_cuda option if you have a compatible GPU to speed up the recording process and reduce CPU load.

StreamRecorder Common Errors and Solutions:

"Stream URL is required"

• Explanation: The stream_url parameter is missing or empty.
• Solution: Ensure you provide a valid URL for the live stream you want to record.

"请选择正确编码模式"

• Explanation: The selected codec is not supported for the chosen video format.
• Solution: Refer to the supported codec and format combinations listed in the error message and select a compatible codec.

"输入有误，请重新输入时间"

• Explanation: The specified start_time is earlier than the current time when use_local_time is set to "true."
• Solution: Provide a valid start_time that is later than the current time.

"Output path is required"

• Explanation: The output_path parameter is missing or empty.
• Solution: Provide a valid directory path where the output file will be saved or use the file dialog to select a location.