Audio Fade

Documentation

Class name: SaltAudioFade
Category: SALT/Audio/Process
Output node: False

The SaltAudioFade node applies a fade-in or fade-out effect to an audio clip, enhancing its auditory transitions. This process involves gradually increasing or decreasing the volume of the audio over a specified duration, starting from a given point in the clip.

Input types

Required

audio
- The raw audio data to which the fade effect will be applied. This parameter is crucial for defining the audio segment that will undergo the fading process.
- Comfy dtype: AUDIO
- Python dtype: bytes
fade_type
- Specifies the type of fade effect to apply: 'in' for a fade-in effect, where volume increases, or 'out' for a fade-out effect, where volume decreases. This choice directly influences the auditory transition of the audio clip.
- Comfy dtype: COMBO[STRING]
- Python dtype: str
fade_duration
- The duration over which the fade effect should occur, measured in seconds. This determines how long the volume transition takes to complete.
- Comfy dtype: FLOAT
- Python dtype: float

Optional

fade_start
- The starting point of the fade effect within the audio clip, measured in seconds. This optional parameter allows for precise control over when the fade begins.
- Comfy dtype: FLOAT
- Python dtype: float

Output types

audio
- Comfy dtype: AUDIO
- The modified audio data with the applied fade effect, either fade-in or fade-out, enhancing the auditory experience of the clip.
- Python dtype: bytes

Usage tips

Infra type: CPU
Common nodes: unknown

Source code

class SaltAudioFade:
    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "audio": ("AUDIO", ),
                "fade_type": (["in", "out"],),
                "fade_duration": ("FLOAT", {"min": 0.01}),
            },
            "optional": {
                "fade_start": ("FLOAT", {"default": 0, "min": 0}),
            },
        }

    RETURN_TYPES = ("AUDIO", )
    RETURN_NAMES = ("audio", )
    FUNCTION = "apply_fade"
    CATEGORY = "SALT/Audio/Process"

    def apply_fade(self, audio, fade_type, fade_duration, fade_start=0):
        audio_segment = AudioSegment.from_file(io.BytesIO(audio), format="wav")

        start_ms = int(fade_start * 1000)
        duration_ms = int(fade_duration * 1000)

        before_fade = audio_segment[:start_ms]
        during_and_after_fade = audio_segment[start_ms:]

        if fade_type == "in":
            faded_part = during_and_after_fade.fade_in(duration_ms)
        else:
            faded_part = during_and_after_fade.fade_out(duration_ms)

        output = before_fade + faded_part

        return(get_buffer(output), )

2.8 KiB Raw Permalink Blame History