Overview
This node merges multiple audio binary inputs into a single audio output sequence with customizable gaps and fade effects between segments. It supports various audio formats and allows specifying the gap durations between audio segments, fallback gap duration, fade length, and output format. This node is useful for audio editing workflows where multiple audio clips need to be combined seamlessly, such as podcast editing, music production, or creating audio montages.
Use Case Examples
- Merging multiple podcast segments with smooth fades and specific silence gaps between them.
- Combining several music tracks into one continuous audio file with controlled transitions.
- Creating an audio montage from various sound clips with defined gaps and fade effects.
Properties
| Name | Meaning |
|---|---|
| Binary property | The name of the binary property in the input items that contains the audio data. |
| Gap list | A comma-separated list of gap durations (in seconds or milliseconds) to insert between audio segments. If a value is greater than 10, it is treated as seconds; otherwise, milliseconds. |
| Fallback gap (s) | The default gap duration in seconds to use between audio segments if no specific gap is provided in the gap list. |
| Fade length (s) | The duration in seconds of the fade-in and fade-out effect applied to each audio segment to create smooth transitions. |
| Format | The output audio format. Can be set to 'Same as first' to keep the format of the first input audio, or explicitly to WAV, MP3, or FLAC. |
| Output binary | The name of the binary property in the output item where the merged audio data will be stored. |
Output
JSON
json- Empty JSON object as the node does not output JSON data other than the binary.binary- The merged audio binary data stored under the specified output binary property name.
Dependencies
- fluent-ffmpeg
- fs
- os
- path
- ../helpers/ffmpeg-utils
Troubleshooting
- Error 'Need at least 2 items' occurs if fewer than two input audio items are provided; ensure at least two audio inputs are connected.
- Error 'FFmpeg produced an empty buffer' indicates a failure in audio processing; check input audio validity and format compatibility.
- If the output audio format is set to 'Same as first' but the first input audio format is unsupported, conversion may fail; specify an explicit output format to resolve.