ComfyUI Node: Audio Loader Crawl (CRT)

Audio Loader Crawl (CRT):

The AudioLoaderCrawl node is designed to efficiently load and process audio files from a specified directory, offering a robust solution for AI artists who need to work with audio data in their projects. This node is particularly beneficial for those who require deterministic selection of audio files based on a seed value, ensuring consistent results across different runs. It features smart caching logic to minimize redundant file scanning, thereby enhancing performance. By supporting various audio file formats and providing options to include subfolders in the search, this node offers flexibility and control over the audio loading process. Additionally, it allows for precise audio processing by enabling users to specify maximum audio length, start offsets, and gain adjustments, making it a versatile tool for audio manipulation tasks.

Audio Loader Crawl (CRT) Input Parameters:

folder_path

This parameter specifies the path to the folder containing the audio files you wish to load. It is crucial for directing the node to the correct location where your audio data is stored. The default value is an empty string, and it is important to ensure that the path is correctly set to avoid errors in file loading.

seed

The seed parameter is an integer used for deterministic file selection, ensuring that the same file is chosen consistently across different runs when the same seed is used. This is particularly useful for reproducibility in experiments. The default value is 0, with a minimum of 0 and a maximum of 0xFFFFFFFFFFFFFFFF.

file_extension

This parameter allows you to filter audio files by their extension, supporting formats such as wav, mp3, flac, and ogg. By selecting the appropriate file extension, you can ensure that only the desired audio files are processed. The default extension is wav.

crawl_subfolders

A boolean parameter that determines whether the node should include files in subfolders during the search. If set to true, the node will recursively search through all subdirectories, providing a comprehensive file search. The default value is false.

max_length_seconds

This parameter sets the maximum length of the audio to be loaded, in seconds. A value of 0 indicates no limit, allowing the entire audio file to be loaded. This is useful for controlling the amount of audio data processed, especially when dealing with large files. The default value is 0.0, with a minimum of 0.0 and a step of 0.1.

start_offset_seconds

This parameter specifies the starting point, in seconds, from which the audio should begin loading. It allows for precise control over the audio segment to be processed, which can be useful for skipping unwanted sections at the beginning of a file. The default value is 0.0, with a minimum of 0.0 and a step of 0.1.

Audio Loader Crawl (CRT) Output Parameters:

waveform

The waveform output represents the audio data loaded from the selected file. It is a crucial component for further audio processing and analysis, providing the raw audio signal that can be manipulated or analyzed in subsequent nodes.

sample_rate

The sample rate output indicates the number of samples per second in the audio file. It is essential for understanding the temporal resolution of the audio data and is necessary for any operations that involve time-based processing or playback.

Audio Loader Crawl (CRT) Usage Tips:

• Ensure that the folder_path is correctly set to avoid file loading errors. Double-check the path for typos or incorrect directory structures.
• Use the seed parameter to achieve consistent results across different runs, which is particularly useful for experiments requiring reproducibility.
• Adjust the max_length_seconds and start_offset_seconds parameters to control the specific segment of audio you wish to process, optimizing performance by avoiding unnecessary data loading.

Audio Loader Crawl (CRT) Common Errors and Solutions:

"❌ Warning: No files with extension '<file_extension>' found in '<folder>'."

• Explanation: This error occurs when no audio files with the specified extension are found in the given folder.
• Solution: Verify that the folder_path is correct and that the folder contains audio files with the specified file_extension. Ensure that the crawl_subfolders option is set appropriately if the files are located in subdirectories.

"❌ An unexpected error occurred in Audio Loader Crawl (CRT): <error_message>"

• Explanation: This message indicates that an unexpected error has occurred during the execution of the node.
• Solution: Check the error message for specific details about the issue. Ensure that all input parameters are set correctly and that the audio files are accessible and not corrupted. If the problem persists, consider reviewing the node's implementation for potential bugs or contacting support for assistance.