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 specified highlights. It allows users to input a video URL and define multiple highlight segments with start and end times along with reasons for those highlights. The node then extracts these segments from the original video and merges them into a single output video. Optionally, it can add visual transitions between the merged segments to create a smooth viewing experience.

Common scenarios where this node is beneficial include:

  • Creating highlight reels from long videos by extracting key moments.
  • Editing event recordings to focus on important parts.
  • Generating summarized versions of tutorials or presentations.
  • Adding professional transitions between clips for polished video content.

For example, a user could input a full-length webinar video URL and specify highlights such as "Introduction" (00:00 - 00:10) and "Main Event" (01:00 - 01:30). The node will trim these segments and merge them, optionally adding fade transitions between them.

Properties

Name Meaning
Video Url A valid URL pointing to the source video to be processed.
Video Highlights JSON-formatted array of objects specifying highlight segments. Each object contains highlight_reason (description) and highlight_time (time range in format "HH:MM - HH:MM"). Example: [{"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 the trimmed video segments.
Transition Type If transitions are enabled, specifies the type of transition effect to apply between segments. Options include: 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 containing the processed video data. This typically includes the merged video file composed of the trimmed highlight segments, optionally with transitions applied. If binary data output is supported, it would represent the final video file ready for download or further use in workflows.

Dependencies

  • Requires access to an external video processing service or API capable of handling video trimming, merging, and applying transitions.
  • Needs a valid API authentication token configured in n8n credentials to interact with the video processing backend.
  • The input video must be accessible via the provided URL.

Troubleshooting

  • Invalid Video URL: Ensure the video URL is publicly accessible and correctly formatted. Private or restricted URLs may cause failures.
  • Malformed Highlights JSON: The Video Highlights property must be a valid JSON string representing an array of objects with correct keys and time formats. Invalid JSON or incorrect time ranges will cause errors.
  • Transition Errors: If transitions are enabled but the transition type or duration is invalid, the node may fail or produce unexpected results. Use only supported transition types and reasonable durations.
  • API Authentication Issues: Missing or incorrect API credentials will prevent the node from processing videos. Verify that the required API key or token is properly set up in n8n.
  • Timeouts or Large Videos: Processing very large videos or many highlight segments might lead to timeouts or performance issues depending on the backend service limits.

Links and References

Discussion