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 trims the video into these segments 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 longer videos by extracting key moments.
  • Editing event footage to focus on important parts without manual video editing.
  • Automatically generating summarized videos with transitions for presentations or social media.

For example, a user could input a full-length conference recording and specify highlights such as "Introduction" (00:00 - 00:10) and "Main event" (01:00 - 01:30). The node would produce a trimmed video containing only these segments, 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 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 the trimmed video segments.
Transition Type Type of transition effect to apply between segments if transitions are enabled. Options: Cross Zoom, Dissolve, Fade, Wipe Left, Wipe Right
Transition Duration Duration in seconds for each transition effect between video segments.

Output

The node outputs a JSON object representing the processed video. This typically includes metadata about the resulting video file and may contain a binary field holding the actual merged and trimmed video data. If transitions are added, the output video will have smooth effects between segments.

If binary data is included, it represents the final video file ready for download or further workflow steps.

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg-based video processing service.
  • The node depends on external video processing libraries or services capable of handling video trimming, merging, and applying transitions.
  • Proper network access to the provided video URL is necessary for fetching the source video.

Troubleshooting

  • Invalid Video URL: Ensure the video URL is accessible and points to a supported video format. Network issues or incorrect URLs will cause failures.
  • Malformed Highlights JSON: The Video Highlights property must be a valid JSON string matching the expected format. Parsing errors will prevent execution.
  • Unsupported Transition Type or Duration: If transitions are enabled, ensure the type is one of the allowed options and duration is a positive number.
  • API Authentication Errors: 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 exhaustion. Consider splitting tasks or increasing timeout settings.

Links and References

Discussion