ComfyUI Node: YouTube Video Downloader

YouTube Video Downloader:

The YouTubeVideoDownloader node is designed to facilitate the downloading of videos and audio from YouTube, providing a seamless way to obtain media content for various creative projects. This node leverages the yt_dlp library to extract and download the best available video and audio formats, ensuring high-quality media files. It offers flexibility by allowing you to choose between downloading only audio or both video and audio, and it supports conversion of video files to MP4 format if desired. The node is particularly beneficial for AI artists and content creators who need to incorporate YouTube media into their work, offering a straightforward and efficient method to access and utilize online content.

YouTube Video Downloader Input Parameters:

youtube_url

The youtube_url parameter specifies the URL of the YouTube video you wish to download. This parameter is crucial as it directs the node to the specific video content you want to extract. There are no minimum or maximum values, but it must be a valid YouTube URL.

download_path

The download_path parameter defines the directory where the downloaded media files will be saved. It ensures that the files are stored in a specified location on your system, making it easier to organize and access them later. The path must be a valid directory path on your system.

resolution

The resolution parameter allows you to set the maximum height of the video to be downloaded, specified in pixels (e.g., 720p). This parameter helps manage the quality and size of the video file, ensuring it meets your specific requirements. There are no predefined minimum or maximum values, but it should be a valid resolution format.

save_as_mp4

The save_as_mp4 parameter is a boolean flag that determines whether the downloaded video should be converted to MP4 format. Setting this to True will convert the video to MP4, which is a widely compatible format, while False will keep the video in its original format. The default value is typically False.

audio_only

The audio_only parameter is a boolean flag that, when set to True, instructs the node to download only the audio track of the video. This is useful when you only need the audio content, such as for music or podcasts. The default value is typically False.

YouTube Video Downloader Output Parameters:

final_video_path

The final_video_path output parameter provides the file path to the downloaded video. This path is essential for locating and using the video file in your projects. It reflects the final format and location of the video, whether it has been converted to MP4 or remains in its original format.

audio_path

The audio_path output parameter provides the file path to the downloaded audio file. This path is crucial for accessing the audio content extracted from the video, allowing you to use it independently in your creative work.

YouTube Video Downloader Usage Tips:

• Ensure that the youtube_url is a valid and accessible YouTube link to avoid download errors.
• Use the resolution parameter to control the video quality and file size, especially if storage space is a concern.
• Set audio_only to True if you only need the audio track, which can save time and storage space.
• Consider setting save_as_mp4 to True for compatibility with most media players and editing software.

YouTube Video Downloader Common Errors and Solutions:

[ERROR] Error during download: <error_message>``

• Explanation: This error indicates that an issue occurred during the download process, which could be due to an invalid URL, network issues, or restrictions on the video.
• Solution: Verify that the youtube_url is correct and accessible. Check your internet connection and ensure that the video is not restricted or removed from YouTube.

FileNotFoundError: Audio file not found at <audio_path>``

• Explanation: This error occurs when the audio file is not found at the specified path after the download process.
• Solution: Ensure that the download path is correct and that there is sufficient disk space. Retry the download process.

ValueError: Downloaded audio file is empty: <audio_path>``

• Explanation: This error indicates that the downloaded audio file is empty, possibly due to a failed download or an issue with the source video.
• Solution: Check the youtube_url for validity and try downloading again. Ensure that the video has an audio track available.

FileNotFoundError: Video file not found at <final_video_path>``

• Explanation: This error occurs when the video file is not found at the specified path after the download process.
• Solution: Verify the download path and ensure there is enough disk space. Retry the download process.

ValueError: Downloaded video file is empty: <final_video_path>``

• Explanation: This error indicates that the downloaded video file is empty, which may result from a failed download or an issue with the source video.
• Solution: Confirm the youtube_url is correct and attempt the download again. Ensure the video is available and not restricted.