docs/integrations/block-integrations/video/concat.md
This block merges multiple video clips into a single continuous video, with optional transitions between clips.
<!-- END MANUAL -->Merge multiple video clips into one continuous video
The block uses MoviePy's concatenate_videoclips function to join multiple videos in sequence. It supports three transition modes: none (direct concatenation), crossfade (smooth blending where clips overlap), and fade_black (each clip fades out to black and the next fades in). At least 2 videos are required. The output is encoded with H.264 video codec and AAC audio codec.
| Input | Description | Type | Required |
|---|---|---|---|
| videos | List of video files to concatenate (in order) | List[str (file)] | Yes |
| transition | Transition between clips | "none" | "crossfade" | "fade_black" | No |
| transition_duration | Transition duration in seconds | int | No |
| output_format | Output format | "mp4" | "webm" | "mkv" | "mov" | No |
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| video_out | Concatenated video file (path or data URI) | str (file) |
| total_duration | Total duration in seconds | float |