Actions11
- Filters and Effect Actions
- Metadata Actions
- RTMP Restreaming Actions
- Transcoding Actions
- Video Processing Actions
Overview
This node provides functionality related to media file processing using ffmpeg. Specifically, for the "Metadata" resource and 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, or 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 cataloging or reporting purposes.
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 (video/audio), codec information, duration, bit rate, and other relevant technical details.
If the input was provided as binary data, the node processes this data to extract metadata without requiring an external URL.
No binary output is produced by this operation; the output is purely JSON metadata.
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 n8n 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 file or accessible URL.
- Authentication Errors: Missing or incorrect API credentials will prevent the node from functioning. Verify that the API key credential is correctly configured.
- Unsupported Media Format: Some rare or proprietary media formats might not be supported by the underlying ffmpeg service, resulting in incomplete or failed metadata extraction.
- Timeouts or Network Issues: When providing URLs, network connectivity issues can cause failures. Check URL accessibility and network status.