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) and produce a new video with hardcoded subtitles for social media sharing or softcoded subtitles for streaming platforms.

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 will be stored.
Add Method Method to add subtitles:
- Softcoded (subtitles as a separate selectable track)
- Hardcoded (subtitles burned into video)
Video Processing Options Collection of optional video settings:
- Video Bitrate (number, e.g., 480)
- Frame Rate (fps, number, e.g., 480)
- 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. The json output contains metadata about the operation result, typically including information about the processed video.

If the node handles binary data, the output binary field will contain the video file with subtitles added according to the selected method.

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg service.
  • The node depends on ffmpeg functionality exposed via an external API or service configured in n8n.
  • Proper URLs or binary inputs for both video and subtitle files must be provided.

Troubleshooting

  • Invalid Input URLs or Binary Fields: Ensure that the video and subtitle inputs are correctly specified either as accessible URLs or valid binary fields within the workflow.
  • Unsupported Subtitle Format: The subtitle file should be in a supported format (commonly SRT). Unsupported formats may cause errors.
  • API Authentication Errors: Verify that the API key credential is correctly configured and has necessary permissions.
  • Output Field Conflicts: Make sure the output binary field name does not conflict with existing fields in the workflow to avoid overwriting data.
  • Performance Issues: High bitrate, frame rate, or resolution settings may increase processing time or resource usage.

Links and References

Discussion