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.