Skip to main content

Concatenate

Concatenates two audio segments together sequentially, creating a single combined audio segment.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • First Audio Segment ID - The ID of the first audio segment to concatenate.
  • Second Audio Segment ID - The ID of the second audio segment to concatenate.

Options​

This node does not have any configurable options.

Output​

  • segment_id - The ID of the newly created concatenated audio segment.

How It Works​

The Concatenate node combines two audio segments sequentially, playing the first segment followed by the second segment. When executed, the node:

  1. Retrieves both audio segments using their IDs
  2. Validates that both segment IDs exist
  3. Combines the segments sequentially (first + second)
  4. Creates a new audio segment with a unique ID
  5. Establishes dependencies in the audio processing graph
  6. Returns the ID of the concatenated segment

Requirements​

  • Valid first audio segment ID (created by Create, Slice, or other processing nodes)
  • Valid second audio segment ID (created by Create, Slice, or other processing nodes)
  • Both segments must exist in memory

Error Handling​

The node will return specific errors in the following cases:

  • Either of the audio segment IDs is empty or null
  • Audio segment with the specified ID does not exist
  • One or both segment IDs are invalid

Usage Examples​

Example 1: Combining Audio Files​

Create a single audio file by combining an intro and main content:

  1. Use Create node to load intro.mp3 (outputs segment_id_1)
  2. Use Create node to load content.mp3 (outputs segment_id_2)
  3. Use Concatenate node with both segment IDs
  4. Use Export node to save the combined audio

Example 2: Building Complex Audio​

Create a podcast episode with intro, content, and outro:

  1. Create three audio segments: intro, content, outro
  2. Concatenate intro + content = part1
  3. Concatenate part1 + outro = final
  4. Export final segment as podcast.mp3

Example 3: Adding Silence Padding​

Add silence before and after audio:

  1. Create a silent segment (5 seconds)
  2. Create main audio segment
  3. Create another silent segment (5 seconds)
  4. Concatenate silence + audio = part1
  5. Concatenate part1 + silence = final

Usage Notes​

  • The order of concatenation matters: first segment plays before second segment
  • The resulting segment inherits properties from the first segment (sample rate, channels)
  • If segments have different properties, they are automatically converted to match
  • Concatenation is non-destructive - original segments remain in memory
  • Use the Delete node to free memory when segments are no longer needed
  • Multiple concatenations can be chained to combine more than two segments
  • The node creates a dependency graph for tracking audio transformations

Performance Tips​

  • Concatenating many small segments is less efficient than concatenating fewer large segments
  • Consider the memory usage when working with large audio files
  • Delete intermediate segments when they are no longer needed
  • Pre-normalize audio levels before concatenation for consistent volume

Common Use Cases​

  • Creating podcast episodes from multiple audio files
  • Adding intro/outro music to recordings
  • Combining interview segments
  • Building audio announcements from pre-recorded phrases
  • Creating continuous playlists from separate tracks
  • Adding silence padding for timing control