ComfyUI Node: AudioX Advanced Volume Control

AudioX Advanced Volume Control:

The AudioXAdvancedVolumeControl node is designed to provide advanced audio volume control with professional-grade features, making it an essential tool for AI artists working with audio in their projects. This node allows you to precisely adjust the volume of audio signals, ensuring that your audio output meets specific loudness standards and quality requirements. It offers features such as volume adjustment in decibels, automatic normalization to target loudness units relative to full scale (LUFS), and the application of soft limiting to prevent audio clipping. Additionally, it supports fade-in and fade-out effects, which can be crucial for creating smooth transitions in audio tracks. By using this node, you can achieve a high level of control over your audio's dynamic range and overall loudness, ensuring that your audio content is both professional and polished.

AudioX Advanced Volume Control Input Parameters:

audio

The audio parameter is a dictionary containing the audio data to be processed. It typically includes the waveform and sample rate of the audio. This parameter is crucial as it provides the raw audio input that the node will manipulate. The waveform is the actual audio signal, while the sample rate determines the number of samples per second, affecting the audio's quality and playback speed.

volume_db

The volume_db parameter specifies the amount of volume adjustment in decibels. It allows you to increase or decrease the audio's loudness. The value is rounded to the nearest step size for precision. The default value is 0.0, meaning no change in volume. Adjusting this parameter can significantly impact the perceived loudness of the audio.

step_size

The step_size parameter defines the precision of the volume adjustment in decibels. It determines the increments by which the volume can be adjusted. The default value is 0.1, allowing for fine-grained control over the volume changes. Smaller step sizes enable more precise adjustments.

target_lufs

The target_lufs parameter sets the target loudness level in LUFS. LUFS is a standard for measuring audio loudness, and this parameter helps ensure that the audio meets specific loudness standards. The default value is -23.0, which is a common target for broadcast audio.

auto_normalize_lufs

The auto_normalize_lufs parameter is a boolean that, when enabled, automatically adjusts the audio's volume to reach the target LUFS level. This feature is useful for maintaining consistent loudness across different audio tracks. The default value is False.

limiter_threshold_db

The limiter_threshold_db parameter sets the threshold for the limiter in decibels. The limiter prevents the audio from exceeding a certain loudness level, avoiding distortion and clipping. The default value is -1.0, which is a typical setting for limiting.

limiter_enabled

The limiter_enabled parameter is a boolean that enables or disables the limiter. When enabled, the limiter ensures that the audio does not exceed the specified threshold, protecting against clipping. The default value is True.

fade_in_ms

The fade_in_ms parameter specifies the duration of the fade-in effect in milliseconds. A fade-in gradually increases the audio's volume from silence to the desired level, creating a smooth start. The default value is 0.0, meaning no fade-in.

fade_out_ms

The fade_out_ms parameter specifies the duration of the fade-out effect in milliseconds. A fade-out gradually decreases the audio's volume to silence, creating a smooth end. The default value is 0.0, meaning no fade-out.

AudioX Advanced Volume Control Output Parameters:

adjusted_waveform

The adjusted_waveform is the primary output of the node, representing the audio waveform after all specified adjustments have been applied. This includes volume changes, normalization, limiting, and any fade effects. The adjusted waveform is crucial for further processing or playback, as it reflects the final audio output with all enhancements and corrections.

final_peak_db

The final_peak_db output indicates the peak level of the adjusted audio in decibels. This value is important for understanding the maximum loudness of the audio after processing, ensuring it remains within acceptable limits to prevent distortion.

AudioX Advanced Volume Control Usage Tips:

• To achieve consistent loudness across multiple audio tracks, enable auto_normalize_lufs and set a common target_lufs value for all tracks.
• Use the fade_in_ms and fade_out_ms parameters to create smooth transitions at the beginning and end of audio clips, enhancing the listening experience.
• Adjust the limiter_threshold_db to prevent clipping in audio with high dynamic range, ensuring that loud sections do not distort.

AudioX Advanced Volume Control Common Errors and Solutions:

"AudioX Volume Control: Rounded {volume_db:.3f}dB to {rounded_volume_db:.3f}dB (step: {step_size:.3f}dB)"

• Explanation: This message indicates that the specified volume adjustment was rounded to the nearest step size for precision.
• Solution: If precise volume adjustment is required, consider using a smaller step_size to allow for finer control.

"AudioX Volume Control: Soft limiting applied (peak was {peak_db:.1f}dB)"

• Explanation: This message indicates that soft limiting was applied to prevent audio clipping.
• Solution: If unexpected, check the limiter_threshold_db and ensure it is set appropriately for your audio content.

"AudioX Advanced Volume: Auto-normalizing from {current_lufs:.1f} to {target_lufs:.1f} LUFS ({lufs_gain_db:+.1f}dB)"

• Explanation: This message indicates that the audio was automatically normalized to meet the target LUFS level.
• Solution: Ensure that auto_normalize_lufs is enabled only when automatic normalization is desired. Adjust target_lufs as needed for your project.