ffmpeg Node icon

ffmpeg Node

n8n Node for some Ffmpeg functionality

Actions11

Overview

This node provides functionality related to media file processing using ffmpeg. Specifically, for the "Metadata" resource with the "Extract Metadata" operation, it extracts metadata information from a given media file. This is useful when you need to analyze or retrieve details such as codec, duration, resolution, bitrate, and other embedded metadata from audio or video files.

Common scenarios include:

  • Automatically gathering media file properties before further processing.
  • Validating media files by checking their metadata.
  • Extracting technical details for reporting or cataloging media assets.

Example: You provide a video file URL or upload a binary media file, and the node returns detailed metadata about that file.

Properties

Name Meaning
Media File Input A valid media URL or the name of the input binary field containing the media file to analyze.

Output

The node outputs a JSON object containing the extracted metadata of the provided media file. This typically includes fields such as format, streams (audio/video), codec information, duration, bit rate, and other relevant technical details describing the media content.

If the input was provided as binary data, the node processes this binary media file to extract metadata accordingly.

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg service.
  • The node depends on an external ffmpeg-based service or library integrated via the API credential.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Invalid Media Input: If the media URL is invalid or the binary field does not contain a proper media file, the node may fail to extract metadata. Ensure the input is a valid media URL or correctly uploaded binary data.
  • Authentication Errors: Missing or incorrect API credentials will prevent the node from functioning. Verify that the API key credential is properly configured.
  • Unsupported Media Format: Some media formats might not be supported by the underlying ffmpeg service, leading to errors or incomplete metadata extraction.
  • Timeouts or Network Issues: When providing URLs, network connectivity issues can cause failures. Check URL accessibility and network status.

Links and References

Discussion