MediaFX icon

MediaFX

Process videos, audio, and media files with FFmpeg

Actions13

Overview

The node "MediaFX" provides media processing capabilities using FFmpeg, including video, audio, font, subtitle, and image manipulations. Specifically, the Image → To Video operation converts a single image into a video file of specified duration and size.

This operation is useful when you want to create a video slideshow or a video clip from a static image, for example:

  • Creating a promotional video with a logo or product image.
  • Generating a background video from an image for social media posts.
  • Converting images into video format for compatibility with video platforms.

The node supports input images either by URL or binary data and outputs a video file in MP4 format.

Properties

Name Meaning
Source Image The source image to convert. Can be provided as:
- URL: A direct link to the image (e.g., https://example.com/image.png)
- Binary Data: Binary property name containing the image data
Duration (seconds) The length of the output video in seconds. Must be at least 0.1 seconds.
Video Size Dimensions of the output video. Defaults to the original image size if not specified.
- Width Width of the video in pixels (minimum 1). Default is 1920 px.
- Height Height of the video in pixels (minimum 1). Default is 1080 px.
Output Format Format of the output video. Currently only MP4 is supported.

Output

The node outputs a binary video file representing the generated video from the input image.

  • The json output field is empty ({}) because the main output is binary data.
  • The binary data is available under the property named data (default binary property).
  • The binary data contains the video file encoded in MP4 format.

Dependencies

  • Requires FFmpeg installed and accessible in the environment where n8n runs.
  • No external API keys or services are needed; all processing is local.
  • Uses Node.js modules for file system operations and temporary file management.

Troubleshooting

  • No binary data found in property: If using binary input, ensure the binary property name matches the actual binary data property in the input item.
  • Invalid URL or inaccessible image: When using URL as source, verify the URL is reachable and points directly to an image file.
  • Duration too short or invalid: Duration must be a positive number greater than or equal to 0.1 seconds.
  • Video size invalid: Width and height must be positive integers.
  • FFmpeg not found or error during processing: Ensure FFmpeg is installed and properly configured in the system PATH.
  • Operation did not produce an output: This error may occur if the input image is invalid or corrupted.

Links and References

Discussion