FFmpeg AdvancedInstall

Summary

Concatenate Videos

Inputs

• inputSourceConcat — Select input method: 'binaryItems' for multiple items with binary data, or 'pathList' for a single item containing a list of file paths.
• filesListField — Comma-separated paths or an expression resolving to an array of strings. Mandatory when inputSourceConcat is 'pathList'.
• concatenationMethod — Concatenation approach: 'copy' for stream-copy (fast, requires identical codecs/resolutions) or 'reencode' for compatibility with different codecs via re-encoding.
• outputExtension — File extension for the resulting output (e.g., mp4, mp3). Defaults to 'mp4'.
• saveToFile — If true, writes the concatenated file to disk; if false, returns binary data in the workflow.
• filePath — Full absolute path for the output file. Required when saveToFile is true; the directory must exist and be writable.
• fileName — Optional custom filename (without extension) for the binary output. If omitted, a UUID is generated. Relevant when saveToFile is false.
• binaryPropertyName (required) — Name of the binary property containing the media file to process. Defaults to 'data'.

Output shape

binary data or saved file reference

Returns an array containing the concatenated video binary data and metadata (including concatenatedCount). If saveToFile is true, the output includes saved: true and outputFilePath. Temporary input files and the filelist are cleaned up after processing.

Examples

Example 1: Binary items concatenation

Set inputSourceConcat to 'binaryItems', provide video binaries via incoming items, leave concatenationMethod as 'copy' for fast merging if codecs match, and set saveToFile to false to receive the result as binary data.

Example 2: File path list concatenation

Set inputSourceConcat to 'pathList', populate filesListField with a comma-separated list of absolute paths, choose concatenationMethod, and specify saveToFile and filePath if a saved output is desired.