ffmpeg Node icon

ffmpeg Node

n8n Node for some Ffmpeg functionality

Actions11

Overview

This node provides video processing capabilities focused on trimming and merging video segments based on user-defined highlights. It allows users to input a video URL and specify multiple highlight segments with start and end times along with reasons for those highlights. The node then trims the video into these segments and optionally merges them back together, adding transitions between segments if desired.

Common scenarios where this node is beneficial include:

  • Creating highlight reels from longer videos by extracting key moments.
  • Editing videos to remove unwanted parts and stitch important clips seamlessly.
  • Adding professional-looking transitions between video segments to improve viewer experience.

For example, a user could input a full-length event recording and specify highlights such as "Introduction" (00:00 - 00:10) and "Main event" (01:00 - 01:30). The node would trim these segments and merge them, optionally adding fade or wipe transitions between them.

Properties

Name Meaning
Video Url A valid URL pointing to the source video to be processed.
Video Highlights JSON array of objects specifying highlight segments with their time ranges and reasons. Example format:
[{"highlight_reason": "Introduction", "highlight_time": "00:00 - 00:10"}, {"highlight_reason": "Main event", "highlight_time": "01:00 - 01:30"}]
Add Transitions Boolean flag indicating whether to add transitions between trimmed video segments.
Transition Type Type of transition effect to apply between video segments if transitions are enabled. Options: Cross Zoom, Dissolve, Fade, Wipe Left, Wipe Right.
Transition Duration Duration in seconds for each transition effect applied between video segments.

Output

The node outputs a JSON object representing the processed video result. This typically includes metadata about the newly created video composed of the trimmed and merged segments. If binary data output is supported (not explicitly shown in the provided code), it would represent the final video file ready for download or further use.

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg-based video processing service.
  • The node depends on external video processing libraries and services abstracted behind the API.
  • Proper network access to the video URL and the API endpoint is necessary.

Troubleshooting

  • Invalid Video URL: Ensure the provided video URL is accessible and points to a valid video file.
  • Malformed Highlights JSON: The Video Highlights property must be a correctly formatted JSON string representing an array of highlight objects. Invalid JSON will cause errors.
  • Transition Errors: If transitions are enabled but the type or duration is invalid, the node may fail. Use only the provided transition options and positive numeric durations.
  • API Authentication Failures: Verify that the API key credential is correctly configured and has permissions for video processing.
  • Timeouts or Large Videos: Processing very large videos or many segments might lead to timeouts or resource limits; consider splitting tasks or optimizing inputs.

Links and References

Discussion