ComfyUI Node: Egregora Audio Gain Match (1770)

Audio Gain Match (1770):

The Audio Gain Match (1770) node is designed to adjust the gain of an audio input to match a reference audio level, ensuring consistent loudness across different audio tracks. This node is particularly useful in audio processing workflows where maintaining a uniform loudness level is crucial, such as in broadcasting or audio mastering. By utilizing the ITU-R BS.1770 standard, which is widely recognized for loudness measurement, this node can accurately match the loudness of the input audio to the reference, either using LUFS (Loudness Units relative to Full Scale) or RMS (Root Mean Square) methods. This ensures that the audio output is balanced and meets industry standards for loudness, providing a seamless listening experience.

Audio Gain Match (1770) Input Parameters:

audio_ref

The audio_ref parameter is the reference audio against which the input audio will be gain-matched. It serves as the benchmark for determining the target loudness level. The reference audio should be representative of the desired loudness level for the final output.

audio_in

The audio_in parameter is the input audio that needs to be adjusted to match the loudness of the reference audio. This audio will be processed to ensure its loudness aligns with the reference, providing a consistent audio experience.

mode

The mode parameter determines the method used for loudness matching. It can be set to "LUFS-I" for integrated loudness matching using the LUFS standard or to "RMS" for matching based on the RMS level. This choice affects how the loudness is calculated and adjusted.

max_gain_db

The max_gain_db parameter specifies the maximum gain adjustment allowed in decibels. It limits the extent to which the input audio can be amplified or attenuated to match the reference loudness. The default value is 12.0 dB, with a range that can be adjusted based on the specific requirements of the audio processing task.

Audio Gain Match (1770) Output Parameters:

out

The out parameter is the processed audio output that has been gain-matched to the reference audio. This output ensures that the loudness of the input audio aligns with the reference, providing a balanced and consistent audio level.

gain_db

The gain_db parameter indicates the amount of gain adjustment applied to the input audio in decibels. It reflects the difference in loudness between the input and reference audio and is crucial for understanding the extent of processing applied.

ref_level

The ref_level parameter represents the loudness level of the reference audio, measured in either LUFS or RMS, depending on the selected mode. It provides a benchmark for the loudness matching process.

in_level

The in_level parameter indicates the initial loudness level of the input audio before processing, measured in either LUFS or RMS. This value is essential for comparing the pre- and post-processing loudness levels.

Audio Gain Match (1770) Usage Tips:

• Ensure that the reference audio (audio_ref) is representative of the desired loudness level for your project to achieve optimal results.
• Use the mode parameter to select the appropriate loudness measurement standard (LUFS or RMS) based on your specific audio processing needs.
• Adjust the max_gain_db parameter to prevent excessive gain changes that could introduce distortion or artifacts in the audio output.

Audio Gain Match (1770) Common Errors and Solutions:

Sample Rate Mismatch

• Explanation: The input and reference audio have different sample rates, which can lead to incorrect loudness matching.
• Solution: Ensure that both the input and reference audio have the same sample rate before processing.

Excessive Gain Adjustment

• Explanation: The gain adjustment exceeds the max_gain_db limit, potentially causing distortion.
• Solution: Increase the max_gain_db limit if necessary, or ensure that the input audio is closer in loudness to the reference audio before processing.

Incorrect Mode Setting

• Explanation: The mode parameter is set incorrectly, leading to unexpected loudness matching results.
• Solution: Verify that the mode parameter is set to either "LUFS-I" or "RMS" based on the desired loudness measurement standard.