Actions11
- Filters and Effect Actions
- Metadata Actions
- RTMP Restreaming Actions
- Transcoding Actions
- Video Processing Actions
Video Processing → Add Subtitle
AI-generatedOverview
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. |
| 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 a selectable track) or Hardcoded (subtitles burned in). |
| 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 with subtitles embedded according to the selected method. The output is placed in a binary field named as specified by the "Video Output Name" property.
- The
jsonoutput contains metadata about the processed video. - The binary output contains the actual video file data with subtitles added.
Dependencies
- Requires an API key credential for accessing the underlying ffmpeg-based video processing service.
- The node depends on external ffmpeg functionality exposed via an API endpoint configured in n8n credentials.
- Input video and subtitle files can be provided either as URLs or as binary data fields within the workflow.
Troubleshooting
- Invalid Input URLs or Binary Fields: Ensure that the video and subtitle inputs are correctly specified as accessible URLs or valid binary fields; otherwise, the node will fail to retrieve the media.
- Unsupported Subtitle Formats: The subtitle file must be in a supported format (commonly SRT). Unsupported formats may cause errors during processing.
- API Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Resource Limits: Large video files or high-resolution settings might exceed processing limits or timeouts.
- Error Messages: Common errors may indicate missing inputs, invalid parameters, or processing failures. Check the node's execution logs for detailed error messages and verify all required properties are set.