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.

Practical examples include:

• Adding visual effects like resizing or color adjustments to videos.
• Applying audio filters such as volume normalization or equalization.
• Automating media processing pipelines that require consistent filter application.

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 the 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 this credential.
• No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

• Invalid media input: If the input media URL or binary field name is incorrect or inaccessible, the node will fail to process the media. Ensure the input is valid and reachable.
• Incorrect filter syntax: Filters must be provided as a comma-separated string following ffmpeg filter syntax. Invalid filters will cause processing errors.
• Mismatched media type and filters: Applying video filters to audio media or vice versa may result in errors. Make sure to select the correct media type and corresponding filters.
• Output field conflicts: Ensure the output binary field name does not conflict with existing fields in the workflow to avoid overwriting data unintentionally.

Links and References

• FFmpeg Filters Documentation
• FFmpeg Official Website
• n8n Documentation on Working with Binary Data