ComfyUI Node: Audio Gain Match

Audio Gain Match:

The Audio Gain Match 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 audio mastering or broadcast environments. By employing either the LUFS (Loudness Units relative to Full Scale) or RMS (Root Mean Square) methods, the node calculates the necessary gain adjustment to align the input audio with the reference audio. This process helps in achieving a balanced audio output, enhancing the listening experience by preventing abrupt volume changes. The node's ability to handle sample rate mismatches by resampling ensures compatibility and seamless integration into various audio processing pipelines.

Audio Gain Match Input Parameters:

audio_ref

This parameter represents the reference audio against which the input audio will be gain-matched. It is crucial for determining the target loudness level that the input audio should achieve. The reference audio should be carefully selected to represent the desired loudness level for the final output.

audio_in

This parameter is the input audio that needs to be gain-matched to the reference audio. The node will adjust the gain of this audio to match the loudness level of the reference audio, ensuring consistency in volume.

mode

The mode parameter determines the method used for gain matching, either LUFS-I for integrated loudness or RMS for root mean square. The choice of mode affects how the loudness levels are calculated and can impact the final audio output. The default mode is LUFS-I.

max_gain_db

This parameter sets the maximum allowable gain adjustment in decibels. It limits the extent to which the input audio's gain can be increased or decreased to match the reference audio. 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 Output Parameters:

out

This output is the gain-matched audio, which has been adjusted to match the loudness level of the reference audio. It ensures a consistent listening experience by aligning the input audio's volume with the reference.

gain_db

This output provides the amount of gain adjustment applied to the input audio in decibels. It indicates how much the input audio's volume was increased or decreased to achieve the desired loudness level.

ref_level

This output represents the loudness level of the reference audio, calculated using the selected mode (LUFS or RMS). It serves as a benchmark for the gain-matching process.

in_level

This output indicates the initial loudness level of the input audio before any gain adjustment. It provides insight into the original volume of the input audio relative to the reference.

Audio Gain Match Usage Tips:

• Ensure that the reference audio is representative of the desired loudness level for your project to achieve optimal results.
• Use the LUFS-I mode for more accurate loudness matching in broadcast and streaming applications, as it considers the perceived loudness over time.
• Adjust the max_gain_db parameter to prevent excessive gain changes that could introduce distortion or clipping in the audio.

Audio Gain Match Common Errors and Solutions:

Sample rate mismatch

• Explanation: The input audio and reference audio have different sample rates, which can lead to inaccurate gain matching.
• Solution: The node automatically resamples the input audio to match the reference audio's sample rate. Ensure that the reference audio's sample rate is set correctly for your project.

Excessive gain adjustment

• Explanation: The gain adjustment exceeds the max_gain_db limit, potentially causing distortion.
• Solution: Review the max_gain_db setting and adjust it to allow for sufficient gain changes without introducing distortion. Consider using a reference audio with a closer initial loudness level to the input audio.