ComfyUI Node: AudioX Volume Control

AudioX Volume Control:

The AudioXVolumeControl node is designed to provide precise control over audio volume adjustments, making it an essential tool for AI artists working with audio in their projects. This node allows you to modify the volume of an audio waveform in decibels (dB), offering a straightforward way to increase or decrease the audio level. It includes features such as soft limiting to prevent harsh clipping and normalization to ensure the audio remains within a safe range after adjustments. By converting decibel changes to linear gain, the node applies these changes to the audio waveform, ensuring that the output is both accurate and high-quality. The node is particularly beneficial for maintaining proper gain staging, which is crucial for achieving professional audio results.

AudioX Volume Control Input Parameters:

audio

This parameter represents the audio data that you want to adjust. It is expected to be in a specific format that the node can process, typically containing the waveform and sample rate information. The audio parameter is crucial as it serves as the input on which all volume adjustments will be applied.

volume_db

This parameter allows you to specify the amount of volume adjustment in decibels (dB). The range is from -60.0 dB to 20.0 dB, with a default value of 0.0 dB, meaning no change. A positive value increases the volume, while a negative value decreases it. For example, +6 dB doubles the volume, and -6 dB halves it. This parameter is essential for setting the desired volume level.

step_size

The step size parameter determines the precision of the volume adjustment slider. It ranges from 0.01 to 1.0, with a default of 0.1. A smaller step size allows for finer adjustments, while a larger step size results in coarser changes. This parameter is useful for achieving the exact volume level you need.

normalize_after

This boolean parameter, defaulting to False, indicates whether the audio should be normalized after the volume adjustment. Normalization ensures that the audio does not clip by adjusting the waveform to fit within a safe range. This is particularly useful when making significant volume changes.

soft_limit

This boolean parameter, defaulting to True, determines whether soft limiting should be applied to the audio. Soft limiting helps prevent harsh clipping by gently compressing the audio peaks, ensuring a smoother sound. This feature is beneficial for maintaining audio quality during volume adjustments.

AudioX Volume Control Output Parameters:

audio

This output provides the adjusted audio waveform after the volume control process. It reflects all the changes made, including volume adjustments, normalization, and any limiting applied. This output is crucial as it is the final audio product ready for further processing or playback.

peak_level_db

This output indicates the peak level of the audio in decibels after the volume adjustment. It helps you understand the maximum amplitude of the audio, ensuring it remains within acceptable limits to prevent distortion or clipping.

info

This output provides a string containing detailed information about the volume adjustment process, including the original and rounded volume levels if they differ. It serves as a useful log for understanding the changes made to the audio.

AudioX Volume Control Usage Tips:

• Use the volume_db parameter to make precise volume adjustments, keeping in mind that +6 dB doubles the volume and -6 dB halves it.
• Enable normalize_after if you notice any clipping in the audio after making volume adjustments to ensure the audio remains within a safe range.
• Utilize the soft_limit feature to prevent harsh clipping, especially when making significant volume increases, to maintain audio quality.

AudioX Volume Control Common Errors and Solutions:

AudioX Volume Control: Rounded <volume_db>dB to <rounded_volume_db>dB (step: <step_size>dB)

• Explanation: This message indicates that the specified volume adjustment was rounded to the nearest step size for precision.
• Solution: Adjust the step_size parameter if you require more precise control over the volume adjustment.

AudioX Volume Control: Soft limiting applied (peak was <peak_db>dB)

• Explanation: This message means that soft limiting was applied because the audio was clipping.
• Solution: Consider reducing the volume_db value or enabling normalize_after to prevent clipping without relying solely on soft limiting.