MediaFX icon

MediaFX

Process videos, audio, and media files with FFmpeg

Actions13

Overview

The node provides video processing capabilities using FFmpeg, specifically for the "Image" resource with the "Stamp" operation. This operation allows users to overlay (stamp) an image onto a source video at a specified position, size, rotation, opacity, and optionally control the time interval during which the stamp appears.

Common scenarios where this node is beneficial include:

  • Adding watermarks or logos to videos.
  • Overlaying branding images or icons on promotional videos.
  • Displaying timestamps or badges dynamically on video content.
  • Creating custom video effects by stamping images at specific times.

For example, you can stamp a company logo in the bottom-right corner of a marketing video, controlling its size and transparency, and make it appear only during the first 5 seconds of the video.

Properties

Name Meaning
Source Video Defines the input video to be stamped. Can be provided as a URL or binary data.
Stamp Image Defines the image to overlay on the video. Can be provided as a URL or binary data.
Width (pixels) Width of the stamp image in pixels. Use -1 to keep the original aspect ratio.
Height (pixels) Height of the stamp image in pixels. Use -1 to keep the original aspect ratio.
Position X Horizontal position of the stamp on the video. Can be a pixel value (e.g., "10") or an expression (e.g., "(main_w-overlay_w)-10" to align right with 10px margin).
Position Y Vertical position of the stamp on the video. Can be a pixel value (e.g., "10") or an expression (e.g., "(main_h-overlay_h)-10" to align bottom with 10px margin).
Rotation (degrees) Clockwise rotation angle of the stamp image in degrees.
Enable Time Control Boolean flag to enable control over when the stamp appears and disappears during the video playback.
Start Time (seconds) When the stamp should start appearing in the video timeline (only if time control is enabled).
End Time (seconds) When the stamp should stop appearing in the video timeline. Leave empty to show the stamp for the entire video duration (only if time control is enabled).
Opacity Opacity level of the stamp image, from 0.0 (fully transparent) to 1.0 (fully opaque).

Output

The node outputs the processed video file with the stamp applied. The output is provided as binary data under the data binary property, paired with the corresponding input item.

The JSON output contains metadata about the operation success and details only if no binary output is generated (which is not the case here).

Binary output meaning:

  • The binary data represents the stamped video file ready for further use or download.

Dependencies

  • Requires FFmpeg installed and accessible in the environment where n8n runs.
  • Uses temporary file storage for processing input and output media files.
  • No external API keys are required; all processing is local.
  • The node relies on helper utilities for resolving inputs and cleaning up temporary files.

Troubleshooting

  • No binary data found: If the source video or stamp image is set to binary but the specified binary property does not exist or is empty, the node will throw an error. Ensure the correct binary property name is used and that the input contains valid binary data.
  • File not found errors: When providing local file paths (if applicable), ensure the path exists and is accessible by n8n.
  • FFmpeg errors: If FFmpeg is not installed or not in the system PATH, the node will fail. Install FFmpeg and verify accessibility.
  • Invalid expressions for position: Position X and Y support expressions referencing video dimensions. Incorrect expressions may cause failures or unexpected positioning.
  • Time control misconfiguration: If time control is enabled but start/end times are invalid (e.g., end time before start time), the stamp may not appear correctly.

To resolve errors, check the input parameters carefully, verify binary data presence, and confirm FFmpeg installation.

Links and References

Discussion