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.
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 Additional video processing settings:
- Video Bitrate (number, e.g., 480)
- Frame Rate (fps, number, e.g., 480)
- Resolution (string, e.g., "640x480")

Output

The node outputs a binary video file with the subtitles added according to the selected method. The output is stored in the specified binary field name.

  • The json output contains metadata about the processed video.
  • The binary output contains the actual video file with subtitles embedded either softly or hardcoded.

Dependencies

  • Requires an API key credential for the underlying ffmpeg service or API.
  • The node depends on ffmpeg functionality accessible via an external service configured in n8n.
  • Input video and subtitle files must be accessible either as URLs or 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 necessary files.
  • Unsupported Subtitle Formats: The subtitle file must be in a supported format (e.g., SRT). Unsupported formats may cause errors during processing.
  • Incorrect Output Field Name: The output binary field name must be unique and not conflict with existing fields to avoid overwriting data.
  • API Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Video Processing Parameters: Invalid values for bitrate, frame rate, or resolution may cause processing failures. Use reasonable defaults or verify parameters before execution.

Links and References

Discussion