SB Render

AI Video Media

v1.6.6

Last updated Jan 7, 2026

n8n community node for video rendering with customizable subtitles, BGM, and narration

132 Weekly Downloads

773 Monthly Downloads

View on NPM GitHub Repository

Included Nodes

SB Render

Description

n8n-nodes-sb-render

![npm version](https://badge.fury.io/js/n8n-nodes-sb-render)
![License: MIT](https://opensource.org/licenses/MIT)

This is an n8n community node for video rendering with customizable subtitles, background music (BGM), and narration using FFmpeg.

sb-render allows you to automate video composition workflows in n8n, combining video files with:

🎵 Background music with volume control and fade effects
🎙️ Narration audio with timing control
📝 Customizable subtitles with extensive styling options
🎨 Multiple output formats and quality presets
🖼️ AI-powered parallax effects from static images (Depth Anything V2)
🔀 Video merging with transitions and audio sync

Inspired by n8n-nodes-mediafx.

Installation
Prerequisites
Operations
Parallax Effect
Configuration
Examples
Development
Troubleshooting
License

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in n8n
2. Select Install
3. Enter n8n-nodes-sb-render
4. Agree to the risks and install

Manual Installation

npm install n8n-nodes-sb-render

For n8n self-hosted installations:

cd ~/.n8n
npm install n8n-nodes-sb-render
Restart n8n

Prerequisites

n8n version: 1.0.0 or higher
Node.js: 16.0.0 or higher
FFmpeg: Auto-detected from system or installed via npm packages

FFmpeg Installation (Docker/n8n Users)

For Docker or self-hosted n8n, installing system ffmpeg is recommended:

Alpine-based containers (n8n official image)
docker exec  apk add --no-cache ffmpeg
Debian/Ubuntu-based containers
docker exec  apt-get update && apt-get install -y ffmpeg

docker-compose.yml example:

services:
  n8n:
    image: n8nio/n8n
    command: >
      sh -c "
        apk add --no-cache ffmpeg &&
        n8n start
      "

The node will automatically:
1. ✅ Use system ffmpeg/ffprobe if available (most reliable)
2. ✅ Fall back to npm packages with auto-permission fix
3. ✅ Gracefully degrade with limited functionality

> Note: v1.1.20+ automatically handles ffmpeg/ffprobe detection and permission issues!

Operations

Video → Render

Compose a video with optional background music, narration, and subtitles.

Features:

✅ Multiple input sources (URL or binary data)
✅ Audio mixing with independent volume controls
✅ Fade in/out effects for BGM
✅ Customizable subtitle positioning and styling
✅ Multiple output formats (MP4, MOV, WebM)
✅ Quality presets (Low, Medium, High, Custom)
✅ Smart audio merging (handles mixed audio/silent video inputs)

Image → Parallax

Create 2.5D parallax video effects from static images using AI depth estimation.

Features:

✅ AI-powered depth estimation (Depth Anything V2)
✅ True layer separation with inpainting
✅ Direction + Zoom combination effects
✅ Intensity control (subtle, normal, dramatic)
✅ Falls back to Ken Burns effect if AI not available

Parallax Effect

The parallax feature uses Depth Anything V2 AI model to create professional 2.5D parallax effects from static images.

How It Works

1. Depth Estimation: AI model analyzes the image to create a depth map
2. Layer Separation: Foreground is extracted based on depth (closer objects)
3. Inpainting: Background is filled where foreground was removed
4. Animation: Layers move at different speeds creating parallax illusion

Parameters

Combined Effects

You can combine zoom with direction for richer effects:

{
  "direction": "left",
  "zoom": "in",
  "intensity": "normal",
  "duration": 5
}

Effect Combinations:

left + zoomIn: Pan left while zooming in
right + zoomOut: Pan right while zooming out
up + zoomIn: Pan up with zoom in
zoomIn only: Pure zoom in effect (set direction to empty)

Requirements for AI Parallax

For AI-powered depth parallax, the following Python packages are required on the server:

pip3 install torch transformers pillow opencv-python-headless

If not available, the node automatically falls back to Ken Burns (zoompan) effect.

Configuration

Video Input

Background Music (BGM)

Narration

Subtitles

Output Options

Examples

Example 1: Simple Video with Subtitles

{
  "videoSource": "url",
  "videoUrl": "https://example.com/video.mp4",
  "enableSubtitles": true,
  "subtitles": {
    "subtitle": [
      {
        "text": "Welcome to our video!",
        "startTime": 0,
        "endTime": 5,
        "position": "bottom",
        "fontSize": 48,
        "fontColor": "#FFFFFF",
        "alignment": "center"
      }
    ]
  },
  "outputFormat": "mp4",
  "quality": "high"
}

Example 2: Video with BGM and Narration

{
  "videoSource": "url",
  "videoUrl": "https://example.com/video.mp4",
  "enableBGM": true,
  "bgmSource": "url",
  "bgmUrl": "https://example.com/music.mp3",
  "bgmVolume": 20,
  "bgmFadeIn": 3,
  "bgmFadeOut": 3,
  "enableNarration": true,
  "narrationSource": "url",
  "narrationUrl": "https://example.com/narration.mp3",
  "narrationVolume": 90,
  "narrationDelay": 2,
  "outputFormat": "mp4"
}

Example 3: Custom Positioned Subtitles

{
  "videoSource": "url",
  "videoUrl": "https://example.com/video.mp4",
  "enableSubtitles": true,
  "subtitles": {
    "subtitle": [
      {
        "text": "Top-left subtitle",
        "startTime": 0,
        "endTime": 5,
        "position": "custom",
        "customX": 100,
        "customY": 100,
        "fontSize": 36,
        "fontColor": "#FFFF00",
        "alignment": "left",
        "backgroundColor": "#000000",
        "backgroundOpacity": 70,
        "borderColor": "#FFFFFF",
        "borderWidth": 3
      }
    ]
  }
}

Example 4: Workflow Integration

Scenario: Download video from URL, add BGM and subtitles, upload to cloud storage

HTTP Request → SB Render → Google Drive

1. HTTP Request: Download video file
2. SB Render: Add BGM and subtitles
3. Google Drive: Upload rendered video

Development

Build

npm install
npm run build

Development Mode

npm run dev

Linting

npm run lint
npm run lintfix

Project Structure

sb-render/
├── nodes/
│   └── SbRender/
│       ├── SbRender.node.ts         # Main node implementation
│       ├── SbRender.node.json       # Node metadata
│       ├── services/
│       │   ├── FileManager.ts       # File handling
│       │   ├── AudioMixer.ts        # Audio composition
│       │   ├── SubtitleEngine.ts    # Subtitle generation
│       │   └── VideoComposer.ts     # Video rendering
│       ├── interfaces/
│       │   └── index.ts             # TypeScript types
│       └── utils/
│           ├── ffmpeg.ts            # FFmpeg helpers
│           └── validation.ts        # Input validation
├── fonts/                           # Custom fonts
├── package.json
├── tsconfig.json
└── README.md

Troubleshooting

FFmpeg Not Found

The node automatically installs FFmpeg via @ffmpeg-installer/ffmpeg. If you encounter issues:

npm install @ffmpeg-installer/ffmpeg --force

File Download Errors

Issue: Video/audio URLs fail to download

Solutions:

Verify URL accessibility
Check for authentication requirements
Ensure sufficient disk space
Try using binary data input instead

Subtitle Not Appearing

Issue: Subtitles don’t show in output video

Solutions:

Verify timing (start/end times within video duration)
Check subtitle position and size
Ensure font is available on system
Try different output format (MP4 recommended)

Memory Issues

Issue: Process crashes with large video files

Solutions:

Reduce video resolution before processing
Use lower quality preset
Process videos in smaller batches
Increase Node.js memory limit:

export NODE_OPTIONS="--max-old-space-size=4096"

Audio Sync Issues

Issue: Audio out of sync with video

Solutions:

Ensure all audio files are in compatible formats
Check narration delay settings
Verify video frame rate compatibility
Try re-encoding source files

Technical Details

FFmpeg Commands

The node uses fluent-ffmpeg to construct FFmpeg commands:

Audio Mixing:

-filter_complex "[0:a]volume=1.0[original];[1:a]volume=0.3,afade=t=in:st=0:d=2[bgm];[original][bgm]amix=inputs=2[mixed]"

Subtitle Overlay:

-vf "ass=subtitles.ass"

Complete Command:

ffmpeg -i video.mp4 -i bgm.mp3 -filter_complex "..." -vf "ass=..." -c:v libx264 -crf 18 output.mp4

Subtitle Formats

SRT: Simple subtitle format (limited styling)
ASS: Advanced SubStation Alpha (full styling support) ← Used by default

ASS format provides:

Custom fonts and colors
Precise positioning
Background colors and opacity
Border/outline effects
Multiple alignment options

Performance

Resource Usage

Times measured on standard VPS (2 CPU, 4GB RAM)

Optimization Tips

1. Use appropriate quality: High quality for final output, medium for testing
2. Compress BGM: Use lower bitrate audio files (128-192 kbps)
3. Batch processing: Process multiple videos in parallel workflows
4. Cache audio files: Reuse same BGM/narration across multiple videos

Compatibility

Supported Video Formats

Input: MP4, MOV, WebM, AVI, MKV
Output: MP4, MOV, WebM

Supported Audio Formats

Input: MP3, WAV, AAC, OGG, M4A
Output: AAC (default)

Codec Compatibility

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Development Guidelines

Follow existing code style (ESLint configured)
Add TypeScript types for new features
Update documentation for new parameters
Test with various video formats

Roadmap

v1.1 (Planned)

[ ] Multiple video layers
[ ] Video transitions
[ ] Logo/watermark overlay
[ ] Preset subtitle templates
[ ] Batch processing mode

v2.0 (Future)

[ ] GPU acceleration (NVENC, VideoToolbox)
[ ] Cloud storage integration
[ ] Progress callbacks
[ ] Advanced video effects

Credits

Inspired by n8n-nodes-mediafx
Uses FFmpeg for video processing
Built with fluent-ffmpeg

License

MIT

Support

Issues: GitHub Issues
Documentation: GitHub Wiki
n8n Community: n8n Community Forum

—

Made with ❤️ for the n8n community

Included Nodes

Description

n8n-nodes-sb-render

Table of Contents

Installation

Community Nodes (Recommended)

Manual Installation

Restart n8n

Prerequisites

FFmpeg Installation (Docker/n8n Users)

Alpine-based containers (n8n official image)

Debian/Ubuntu-based containers

Operations

Video → Render

Image → Parallax

Parallax Effect

How It Works

Parameters

Combined Effects

Requirements for AI Parallax

Configuration

Video Input

Background Music (BGM)

Narration

Subtitles

Output Options

Examples

Example 1: Simple Video with Subtitles

Example 2: Video with BGM and Narration

Example 3: Custom Positioned Subtitles

Example 4: Workflow Integration

Development

Build

Development Mode

Linting

Project Structure

Troubleshooting

FFmpeg Not Found

File Download Errors

Subtitle Not Appearing

Memory Issues

Audio Sync Issues

Technical Details

FFmpeg Commands

Subtitle Formats

Performance

Resource Usage

Optimization Tips

Compatibility

Supported Video Formats

Supported Audio Formats

Codec Compatibility

Contributing

Development Guidelines

Roadmap

v1.1 (Planned)

v2.0 (Future)

Credits

License

Support

More in AI Video

MediaFX

UseAPI

Video Api Hub

Vidopi Upload Video

Ffmpeg

fal.ai

Faceless Video

VEED AI Video API