ffmpeg Node icon

ffmpeg Node

n8n Node for some Ffmpeg functionality

Actions11

Overview

This node provides video processing capabilities specifically for adding subtitles to videos. It supports two subtitle embedding methods:

  • Softcoded: Subtitles are added as a separate selectable track, allowing viewers to toggle them on or off.
  • Hardcoded: Subtitles are permanently burned into the video frames.

Common scenarios include enhancing accessibility by adding subtitles to videos, preparing content for platforms that require embedded subtitles, or providing multiple subtitle options without altering the original video stream.

For example, you can input a video file and a subtitle file (such as an SRT file), choose whether to hardcode or softcode the subtitles, optionally adjust video bitrate, frame rate, and resolution, and receive a processed video with subtitles embedded accordingly.

Properties

Name Meaning
Video Input A valid video URL or the name of the input binary field containing the video file.
Subtitle Input A valid subtitle file URL or the name of the input binary field containing the subtitle file (e.g., SRT).
Video Output Name The name of the output binary field where the processed video file with subtitles will be stored.
Add Method Method to add subtitles:
- Softcoded (subtitles as selectable track)
- Hardcoded (burned in)
Video Processing Options Optional settings for video processing:
- Video Bitrate (number)
- Frame Rate (fps) (number)
- Resolution (string, e.g., "640x480")

Output

The node outputs the processed video file in a binary field named as specified by the "Video Output Name" property. This binary data contains the video with subtitles added according to the selected method.

The json output field typically includes metadata about the processed video, but the main output is the binary video file ready for further use or download.

Dependencies

  • Requires access to an Ffmpeg API service capable of video transcoding and subtitle embedding.
  • Needs an API authentication token or key configured in n8n credentials to interact with the Ffmpeg service.
  • Input video and subtitle files must be accessible either via URLs or provided as binary data within the workflow.

Troubleshooting

  • Invalid Input URLs or Binary Fields: Ensure that the video and subtitle inputs are correctly specified as valid URLs or existing binary fields; otherwise, the node will fail to retrieve the media.
  • Unsupported Subtitle Formats: The subtitle file should be in a supported format (commonly SRT). Unsupported formats may cause errors during processing.
  • API Authentication Errors: Missing or incorrect API credentials will prevent the node from communicating with the Ffmpeg service.
  • Resource Limits: Large video files or high-resolution settings might exceed API limits or processing timeouts.
  • Error Messages: Common errors may include "Failed to fetch input file," "Subtitle format not supported," or "Authentication failed." Verify inputs, formats, and credentials accordingly.

Links and References

Discussion