ComfyUI Node: Sound Reactive

Sound Reactive:

The SoundReactive node is designed to dynamically respond to the sound levels captured by your browser's sound input options. This node is particularly useful for real-time applications, such as live audio-visual performances or interactive installations, where it can modulate visual elements based on the audio input. By analyzing the sound levels within a specified frequency range, the node can adjust its output in real-time, providing a seamless integration between audio and visual components. This functionality is essential for creating immersive and responsive experiences, making it a valuable tool for AI artists and developers working with real-time audio-visual content.

Sound Reactive Input Parameters:

sound_level

This parameter represents the initial sound level input, which is a floating-point number. It determines the base level of sound that the node will react to. The default value is 1.0, with a minimum of 0.0 and a maximum of 99999. Adjusting this value will directly influence the sensitivity of the node to the incoming sound.

start_range_hz

This integer parameter sets the lower bound of the frequency range (in Hertz) that the node will consider when analyzing the sound input. The default value is 150 Hz, with a minimum of 0 Hz and a maximum of 9999 Hz. This allows you to focus on specific parts of the audio spectrum, such as bass or mid-range frequencies.

end_range_hz

This integer parameter sets the upper bound of the frequency range (in Hertz) that the node will consider when analyzing the sound input. The default value is 2000 Hz, with a minimum of 0 Hz and a maximum of 9999 Hz. By setting this range, you can isolate higher frequencies or a broader spectrum of the audio input.

multiplier

This floating-point parameter is used to scale the sound level input. The default value is 1.0, with a minimum of 0.01 and a maximum of 99999. Adjusting the multiplier can amplify or attenuate the sound level, allowing for finer control over the node's sensitivity to audio input.

smoothing_factor

This floating-point parameter determines the degree of smoothing applied to the sound level input, helping to reduce sudden changes and create a more stable output. The default value is 0.5, with a minimum of 0.0 and a maximum of 1.0. A higher smoothing factor will result in a more gradual response to changes in sound level.

normalize

This boolean parameter indicates whether the sound level should be normalized. The default value is False. When set to True, the sound level is divided by 255, which can be useful for standardizing the input range and ensuring consistent behavior across different audio sources.

Sound Reactive Output Parameters:

sound_level

This floating-point output represents the processed sound level after applying the multiplier and optional normalization. It provides a continuous value that can be used to drive other nodes or visual elements in your project.

sound_level_int

This integer output represents the processed sound level as an integer value. It is derived from the floating-point sound level and can be useful for applications that require discrete values or for interfacing with other systems that use integer inputs.

Sound Reactive Usage Tips:

• To achieve a more responsive visual effect, adjust the multiplier parameter to amplify the sound level input.
• Use the smoothing_factor to create smoother transitions in your visual elements, reducing abrupt changes caused by sudden spikes in the audio input.
• Experiment with different start_range_hz and end_range_hz values to focus on specific frequency ranges that best match the visual elements you are controlling.
• Enable the normalize parameter if you are working with audio sources that have varying levels, to ensure consistent behavior.

Sound Reactive Common Errors and Solutions:

"Invalid sound level input"

• Explanation: The sound level input is out of the acceptable range.
• Solution: Ensure that the sound_level parameter is within the range of 0.0 to 99999.

"Frequency range out of bounds"

• Explanation: The specified frequency range is not within the acceptable limits.
• Solution: Check that both start_range_hz and end_range_hz parameters are within the range of 0 to 9999 Hz.

"Multiplier value too low or too high"

• Explanation: The multiplier value is outside the acceptable range.
• Solution: Adjust the multiplier parameter to be within the range of 0.01 to 99999.

"Smoothing factor out of range"

• Explanation: The smoothing factor is not within the acceptable range.
• Solution: Ensure that the smoothing_factor parameter is between 0.0 and 1.0.

"Normalization error"

• Explanation: There is an issue with the normalization process.
• Solution: Verify that the normalize parameter is set correctly and that the sound level input is appropriate for normalization.