video-dub

Merge ZH TTS audio and burn ZH SRT subtitles into MP4 videos.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/zlovexforever/zlx-claude-skills --skill video-dub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: video-dub
Source: https://github.com/zlovexforever/zlx-claude-skills/tree/main/video-dub
Command: npx skills add https://github.com/zlovexforever/zlx-claude-skills --skill video-dub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, Pillow, ffmpeg, ffprobe.

What problem does it solve?

Turning a YouTube video into a Chinese-dubbed version usually requires juggling downloading, audio replacement, and subtitle rendering—this Skill automates the end-to-end dubbing delivery so you get ready-to-share outputs quickly.

Core Features & Use Cases

  • 3 deterministic outputs: produces an original reference copy, a Chinese-dubbed video without subtitles, and a Chinese-dubbed video with hard-burned subtitles.
  • YouTube or local input: supports a YouTube URL (downloads best quality) or a local video file.
  • Subtitle burning without libass: hard-burns SRT into the video via Pillow-rendered transparent PNG overlays and ffmpeg compositing.
  • Use case: when you have translated subtitles (ZH SRT) and a Chinese TTS track (ZH WAV), you can generate a final Chinese version of the video suitable for distribution.

Quick Start

Run the Skill to create all three outputs by giving it a YouTube URL (or local video), the ZH TTS WAV from your TTS step, and the ZH SRT from your translation step.

Frequently Asked Questions about video-dub

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I burn Chinese subtitles into a YouTube video with ffmpeg?▼

To burn Chinese subtitles into a YouTube video, this Skill uses Pillow to render SRT entries into transparent PNG overlays and ffmpeg compositing with timing-accurate enable between(t,start,end) to hard-burn subtitles. It outputs a final MP4 with permanently rendered text without relying on libass.

Can I replace a YouTube video's audio track with a Chinese TTS WAV file?▼

Yes, you can replace the original audio with a Chinese TTS WAV file by using ffmpeg to merge the provided ZH TTS audio track with the downloaded video source, producing a Chinese-dubbed MP4 output ready for distribution.

Do I need yt-dlp to download a YouTube video for Chinese dubbing?▼

You need yt-dlp only if you want to download a YouTube URL at best quality for Chinese dubbing; otherwise, you can use a local video file as the source input to generate the dubbed outputs without downloading.

What is the best way to automate YouTube to Chinese dubbing with burned subtitles?▼

The best way to automate YouTube to Chinese dubbing is providing a YouTube URL, a ZH TTS WAV audio track, and a ZH SRT subtitle file to generate three deterministic outputs: an original reference copy, a dubbed video without subtitles, and a dubbed video with hard-burned subtitles.

Why does hard-burning SRT subtitles with ffmpeg require Pillow?▼

Hard-burning SRT subtitles with ffmpeg requires Pillow because the Skill renders each SRT entry into a PNG image overlay, which ffmpeg then composites onto the video using timing-accurate enable between(t,start,end) commands to bypass libass dependency.