ffmpeg NodeInstall

Overview

This node provides various ffmpeg-related video processing functionalities within n8n. Specifically, for the "Video Processing" resource and the "Combine Audio To Video" operation, it allows users to merge an audio track with a video file. This is useful when you have separate audio and video sources and want to produce a single combined media file.

Common scenarios include:

• Adding background music or narration to a silent video.
• Replacing the original audio track of a video with a different audio source.
• Combining externally recorded audio (e.g., voiceover) with video footage.

Example: You have a video file without sound and a separate audio recording. Using this node, you can input both files and output a new video file that contains the video visuals along with the provided audio track.

Properties

Output

The node outputs a binary file in the specified output field containing the resulting video with the combined audio track. The json output typically includes metadata about the processed file, but the main content is the binary data representing the merged video and audio.

If the input was binary data, the output binary field will contain the newly created video file with audio embedded.

Dependencies

• Requires an API key credential for accessing the underlying ffmpeg service or API.
• The node depends on an external ffmpeg processing backend accessible via the configured credentials.
• No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

• Invalid Input URLs or Binary Fields: Ensure that the video and audio inputs are either valid URLs or correctly named binary fields present in the incoming data.
• Unsupported Formats: The node relies on ffmpeg capabilities; unsupported video or audio formats may cause errors.
• Missing Credentials: The node requires a valid API key credential for the ffmpeg service. Missing or invalid credentials will prevent execution.
• Output Field Conflicts: Make sure the output binary field name does not conflict with existing fields to avoid overwriting important data.

Common error messages might indicate:

• Failure to fetch input files (check URLs or binary data).
• Unsupported codec or format errors (verify input file compatibility).
• Authentication failures (check API key validity).

Resolving these usually involves verifying input correctness, ensuring proper credentials, and confirming supported media formats.

Links and References

• FFmpeg Official Documentation
• n8n Documentation on Binary Data Handling
• Using External APIs in n8n