ffmpeg Node icon

ffmpeg Node

n8n Node for some Ffmpeg functionality

Actions11

Overview

This node provides video processing capabilities using ffmpeg, specifically supporting an operation to combine audio with a video. The "Combine Audio To Video" operation allows users to merge an audio track into an existing video file, producing a new video output that includes the added audio.

Common scenarios include:

  • Adding background music or narration to silent videos.
  • Replacing or overlaying audio tracks in video content.
  • Combining separate audio and video files into a single media file for easier distribution or playback.

For example, you might have a recorded video without sound and a separate audio commentary track; this node can merge them into one video file with audio included.

Properties

Name Meaning
Video Input A valid video URL or the name of the input binary field containing the video file to process.
Audio Input A valid audio URL or the name of the input binary field containing the audio file to add.
Video Output Name The name of the output binary field where the resulting video file (with combined audio) will be stored.

Output

The node outputs a binary file representing the processed video with the combined audio track. This binary data is accessible under the specified output binary field name (default is "data"). The JSON output typically contains metadata about the processed item, but the main result is the binary video file ready for further use or download.

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg service.
  • Depends on the external ffmpeg processing backend exposed via an API.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Invalid Input URLs or Binary Fields: Ensure that the provided video and audio inputs are either valid URLs accessible by the service or correctly named binary fields from previous nodes.
  • Unsupported Formats: The node relies on ffmpeg's supported formats. Using unsupported video or audio formats may cause errors.
  • API Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Output Field Conflicts: Make sure the output binary field name does not conflict with existing fields to avoid overwriting data unintentionally.

Links and References

Discussion