ComfyUI Node: Tube Compressor (CRT)

Tube Compressor (CRT):

The AudioCompressor node is designed to enhance audio processing by applying dynamic range compression to audio signals. This node is particularly useful for AI artists who want to control the volume dynamics of their audio content, ensuring that softer sounds are amplified while louder sounds are attenuated, resulting in a more balanced and polished audio output. The AudioCompressor achieves this by using a set of parameters that allow you to fine-tune the compression effect, such as threshold, ratio, attack, and release times. Additionally, it offers features like warmth for adding harmonic distortion, mix control for blending the processed and unprocessed signals, and makeup gain to compensate for any loss in volume. The node also includes options for peak matching and soft clipping to prevent distortion, making it a versatile tool for audio enhancement in creative projects.

Tube Compressor (CRT) Input Parameters:

audio

This parameter accepts the audio input that you want to process. It should be provided as a dictionary containing the waveform and sample rate. The waveform is a tensor representing the audio signal, and the sample rate is the number of samples per second. This input is crucial as it forms the basis of the compression process.

threshold_db

The threshold in decibels (dB) determines the level above which the audio signal will be compressed. A lower threshold means more of the audio signal will be affected by compression. The default value is -20.0 dB, which is a common starting point for moderate compression.

ratio

The ratio defines the amount of compression applied to the audio signal once it exceeds the threshold. A higher ratio results in more compression. The default value is 4.0, which is suitable for general use, providing a balance between dynamic control and natural sound.

attack_ms

The attack time, measured in milliseconds, specifies how quickly the compressor responds to audio signals that exceed the threshold. A shorter attack time results in faster compression. The default value is 5.0 ms, allowing for quick response to transient peaks.

release_ms

The release time, also in milliseconds, determines how quickly the compressor stops compressing after the signal falls below the threshold. A longer release time ensures smoother transitions. The default value is 100.0 ms, providing a natural decay for compressed signals.

warmth

This parameter adds harmonic distortion to the audio signal, simulating the warmth of analog equipment. It ranges from 0.0 to 1.0, with a default value of 0.1, offering subtle enhancement without overwhelming the original sound.

mix_wet

The mix wet parameter controls the blend between the compressed (wet) and uncompressed (dry) audio signals. A value of 1.0 means only the compressed signal is heard, while 0.0 means only the original signal is heard. The default is 1.0, emphasizing the compressed effect.

makeup_gain_db

Makeup gain in decibels compensates for any volume loss due to compression, ensuring the output level matches the input level. The default value is 0.0 dB, which maintains the original volume unless adjusted.

match_input_peak

This toggle option, either "ON" or "OFF", ensures that the peak level of the output matches the input, preventing distortion. The default is "OFF", allowing for natural compression without peak matching.

soft_clipper_toggle

This toggle, also "ON" or "OFF", activates a soft clipper to prevent distortion by limiting the signal's peak level. The default is "OFF", which means the clipper is not applied unless needed.

clipper_threshold

The clipper threshold sets the level at which the soft clipper engages, ranging from 0.0 to 1.0. The default is 1.0, meaning the clipper is inactive unless the threshold is lowered.

prompt

An optional parameter for additional instructions or metadata, not directly affecting the compression process.

extra_pnginfo

Another optional parameter for embedding extra information, typically used for metadata purposes.

Tube Compressor (CRT) Output Parameters:

audio

The audio output is a dictionary containing the processed waveform and sample rate. The waveform is a tensor representing the compressed audio signal, and the sample rate remains unchanged from the input. This output is crucial as it provides the final audio result after compression.

gr_meter_data

This output is a string representation of the gain reduction meter data, which shows how much compression was applied over time. It is useful for visualizing the compression effect and understanding the dynamics of the processed audio.

Tube Compressor (CRT) Usage Tips:

• Experiment with the threshold_db and ratio parameters to achieve the desired level of compression. Lower thresholds and higher ratios result in more aggressive compression.
• Use the warmth parameter to add subtle harmonic distortion, enhancing the audio's character without overwhelming it.
• Adjust the mix_wet parameter to blend the compressed and uncompressed signals, allowing for parallel compression techniques that retain the original dynamics while adding punch.

Tube Compressor (CRT) Common Errors and Solutions:

Tube Compressor (CRT) is unavailable: <PEDALBOARD_ERROR>

• Explanation: This error occurs when the required pedalboard library is not available, preventing the node from functioning.
• Solution: Ensure that the pedalboard library is installed and accessible in your environment. You may need to install it using a package manager like pip.

Silent audio as fallback

• Explanation: This message indicates that the node could not process the audio due to an error, and a silent audio signal is returned as a fallback.
• Solution: Check the input audio for issues such as incorrect format or missing data. Ensure that all required parameters are correctly set and that the pedalboard library is available.