ComfyUI Node: Audio Split to List

Audio Split to List:

The AudioListGenerator node is designed to facilitate the creation and manipulation of audio lists within a node-based workflow. This node is particularly useful for AI artists who need to generate, process, or manage multiple audio files in a structured manner. By leveraging this node, you can efficiently handle audio data, whether for creative projects, sound design, or other audio-related tasks. The node's primary function is to generate lists of audio files, which can then be used in conjunction with other nodes for further processing or analysis. This capability is essential for workflows that require batch processing or the combination of multiple audio sources.

Audio Split to List Input Parameters:

audio_list

The audio_list parameter is a required input that accepts a list of audio files. Each element in the list should be a dictionary containing the keys waveform and sample_rate. The waveform represents the audio data, while the sample_rate indicates the number of samples per second. This parameter is crucial as it forms the basis of the audio processing tasks that the node will perform.

combine_mode

The combine_mode parameter specifies the method used to combine the audio files in the list. It offers three options: concatenate, mix, and overlay. The default mode is concatenate, which joins the audio files end-to-end. The mix option blends the audio files together, while overlay allows for layering one audio file over another. This parameter determines how the audio files will be merged, affecting the final output.

fade_duration

The fade_duration parameter is optional and controls the duration of fade-in and fade-out effects applied during the audio combination process. It is a float value with a default of 0.0 seconds, and it can range from 0.0 to 5.0 seconds, with increments of 0.1 seconds. This parameter is useful for creating smooth transitions between audio files, enhancing the overall audio quality.

normalize_output

The normalize_output parameter is a boolean option that determines whether the output audio should be normalized. By default, it is set to True, which means the audio levels will be adjusted to a standard level, ensuring consistent volume across the output. This parameter is important for maintaining audio quality and preventing distortion.

target_sample_rate

The target_sample_rate parameter specifies the desired sample rate for the output audio. It is an integer value with a default of 44100 Hz, and it can range from 8000 Hz to 192000 Hz. This parameter ensures that all audio files in the list are resampled to a consistent sample rate, which is essential for compatibility and quality control in audio processing.

Audio Split to List Output Parameters:

AUDIO

The output of the AudioListGenerator node is a single audio file, represented by the AUDIO parameter. This output is the result of combining the input audio list according to the specified combine_mode, with any additional processing such as fading or normalization applied. The output audio file is ready for further use in your workflow, whether for playback, analysis, or additional processing.

Audio Split to List Usage Tips:

• Ensure that all audio files in the audio_list have compatible sample rates and channel configurations to avoid processing errors.
• Use the fade_duration parameter to create smooth transitions between audio files, especially when using the concatenate mode.
• Normalize the output audio to maintain consistent volume levels, particularly when combining files with varying loudness.

Audio Split to List Common Errors and Solutions:

"音檔清單不能為空"

• Explanation: This error occurs when the audio_list parameter is empty, meaning no audio files have been provided for processing.
• Solution: Ensure that you provide a valid list of audio files as input to the node. Each element in the list should be a dictionary containing waveform and sample_rate.

"Sample rate mismatch"

• Explanation: This error indicates that the sample rates of the input audio files do not match the target_sample_rate.
• Solution: Verify that all input audio files have the correct sample rate or use the node's resampling feature to adjust them to the desired target_sample_rate.