SB Render icon

SB Render

Render videos with subtitles, BGM, and narration using FFmpeg

Actions4

Video → Render

AI-generated

Summary

Render a video by combining a source video with optional background music (BGM), narration audio, and subtitles, producing a new video file with specified format, codec, and quality settings.

Inputs

  • Video Source (required) — Select the source of the video file to process, either a URL or binary data from a previous node.
  • Video URL (required) — Provide the URL of the video file to process if 'URL' is selected as the video source.
  • Video Binary Property (required) — Specify the name of the binary property in the input item containing the video data if 'Binary Data' is selected as the video source.
  • Enable Background Music (BGM) — Enable this to add background music audio overlay to the video.
  • BGM Source (required) — Source of the background music file, either a URL or binary data; required if BGM is enabled.
  • BGM URL — URL of the background music file when BGM source is URL.
  • BGM Binary Property — Name of the binary property containing the background music data when BGM source is binary.
  • BGM Volume — Adjust the volume level of the background music (0-100).
  • BGM Fade In (Seconds) — Specify fade-in duration for background music in seconds.
  • BGM Fade Out (Seconds) — Specify fade-out duration for background music in seconds.
  • Enable Narration — Enable this to add a narration audio track to the video.
  • Narration Source (required) — Source of the narration audio, either URL or binary data; required if narration is enabled.
  • Narration URL — URL of the narration audio file when narration source is URL.
  • Narration Binary Property — Name of the binary property containing the narration audio when narration source is binary.
  • Narration Volume — Adjust the volume level of the narration audio (0-100).
  • Narration Delay (Seconds) — Delay in seconds before the narration audio starts.
  • Enable Subtitles — Enable this to add subtitles to the video.
  • Subtitle Source (required) — Source of subtitle data when subtitles are enabled, one of manual input, SRT string, SRT file URL, or SRT file binary.
  • SRT Content (required) — SRT subtitle content as a string in SRT format when subtitle source is 'SRT String'.
  • SRT File URL (required) — URL of the SRT subtitle file when subtitle source is 'SRT File (URL)'.
  • SRT Binary Property (required) — Name of the binary property containing the SRT file when subtitle source is 'SRT File (Binary)'.
  • Subtitles (required) — Manual subtitle entries as a collection with text, timing, position, and style options when subtitle source is 'Manual Input'.
  • Output Format (required) — Specifies the output video container format: MP4, MOV, or WebM.
  • Video Codec (required) — Select the video codec for encoding: H.264 (libx264), H.265 (libx265), or VP9.
  • Quality (required) — Choose output video quality preset (Low, Medium, High) or specify custom CRF value.
  • Custom CRF — Custom CRF value (0-51) to control video quality; lower values mean better quality; required if quality is set to custom.
  • Half Frame Rate (2x Duration) — Whether to reduce frame rate by half to double the video duration (displays same frames slower)
  • Output Binary Property (required) — Name of the binary property in the output item where the rendered video will be stored.
  • Debug Mode — Enable debug logging to a file at /tmp/sb-render-debug.log for troubleshooting.

Output shape

a single binary file representing the rendered video

The output video includes combined audio tracks (original audio, optional BGM and narration), embedded subtitles if enabled, encoded with selected codec and quality. The rendered video is stored in the specified output binary property. Debug logging can be enabled for detailed process information.

Examples

Example 1: Render a video from a URL with background music and subtitles.

Specify the video URL, enable BGM with its URL and volume settings, enable subtitles providing manual subtitle entries, and select output format and quality. The node downloads all media, mixes audio tracks with volume controls and fade effects, applies subtitles, and produces the final video stored as binary data.

Links

Discussion