ffmpeg Node icon

ffmpeg Node

n8n Node for some Ffmpeg functionality
Join our community

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 that support subtitle tracks.

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) or Hardcoded (subtitles burned into video).
Video Processing Options Collection of optional video settings:
- Video Bitrate: Numeric value specifying bitrate.
- Fram Rate: Numeric value specifying frames per second.
- Resolution: String specifying resolution in format like "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 output binary field name.

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

Dependencies

  • Requires an API key credential for accessing the underlying ffmpeg-based video processing service.
  • The node depends on ffmpeg functionality exposed via an external API or service configured in n8n credentials.
  • No additional environment variables are explicitly required beyond the API authentication.

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 in the workflow.
  • Unsupported Subtitle Formats: The subtitle file must be in a supported format (commonly SRT). Unsupported formats may cause processing errors.
  • Incorrect Output Field Name: The output binary field name must be unique and not conflict with existing fields.
  • API Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Processing Failures: If the video processing fails, check the video options such as bitrate, frame rate, and resolution for valid values.

Links and References

Discussion