ffmpeg Node

Overview

This node provides functionality to add filters and effects to media files (video or audio) using ffmpeg capabilities. It is useful in scenarios where you want to programmatically apply transformations such as scaling, grayscale, or other filter chains to media content within an n8n workflow. For example, you could use it to resize videos, convert them to black and white, or apply audio equalization effects automatically.

Properties

Output

The node outputs the processed media file in a binary field named as specified by the "Media File Output" property. The json output field typically contains metadata about the operation or the processed file, but the main output is the transformed media binary data with applied filters and effects.

Dependencies

• Requires an API key credential for accessing the underlying ffmpeg service.
• The node depends on an external ffmpeg processing backend accessible via the configured API.
• Proper configuration of this API credential in n8n is necessary for the node to function.

Troubleshooting

• Common issues:
  • Invalid media input URL or missing binary input field can cause failures.
  • Incorrect filter syntax or unsupported filters may result in errors from ffmpeg.
  • Mismatched media type selection (e.g., selecting "audio" but providing a video file) can cause unexpected results.
• Error messages:
  • Errors related to filter parsing usually indicate malformed filter strings; verify the filter syntax.
  • Authentication errors suggest misconfigured or missing API credentials.
  • File not found or invalid input errors mean the input media was not correctly provided or accessible.

Links and References

• FFmpeg Filters Documentation
• n8n Documentation on Binary Data Handling