wjs-burning-subtitles

Burn SRT subtitles into videos or create toggleable soft-mux tracks.

114|17|Updated May 11, 2026
One-click install
npx skills add https://github.com/jianshuo/claude-skills --skill wjs-burning-subtitles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wjs-burning-subtitles
Source: https://github.com/jianshuo/claude-skills/tree/main/wjs-burning-subtitles
Command: npx skills add https://github.com/jianshuo/claude-skills --skill wjs-burning-subtitles

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of adding subtitles to videos, ensuring they are either always visible or can be toggled as needed for various platforms.

Core Features & Use Cases

  • Burn-in Subtitles: Adds subtitles to a video so they are always visible, ideal for platforms like WeChat and抖音.
  • Soft-mux Subtitles: Creates a subtitle track that can be toggled on and off for platforms that support embedded subtitle tracks like QuickTime and VLC.
  • Final Composite: Handles the final composite step for the localization pipeline, including burning subs, mixing a dub track, and keeping the original audio at a low volume.
  • Libass Support: Automatically downloads a static ffmpeg build with libass if needed.
  • Audio Mixing: Keeps the original audio at a low volume under the dub for a professional translation feel.

Quick Start

Use the wjs-burning-subtitles skill to burn subtitles into your video by running the command: python3 ~/.claude/skills/wjs-burning-subtitles/scripts/render.py --video IN.mp4 --srt SUB.srt --out OUT.mp4

Frequently Asked Questions about wjs-burning-subtitles

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

FAQPage Schema
How do I burn subtitles into an MP4 video so they are always visible?

To burn subtitles into a video, you need a tool that permanently renders the text onto the video frames. This process ensures subtitles are always visible, making the output ideal for platforms like WeChat and Douyin that do not support toggling subtitle tracks.

Can I add an SRT subtitle file as a togglable track instead of burning it in?

Yes, you can soft-mux an SRT subtitle file into your video to create a togglable subtitle track. This embeds the subtitles without altering the video frames, allowing viewers to turn the text on or off in compatible players like QuickTime and VLC.

Do I need ffmpeg with libass to process SRT subtitles for video editing?

Yes, ffmpeg with libass support is required to process and render SRT subtitles correctly. If your current environment lacks libass, the tool will automatically download a static ffmpeg build equipped with the necessary libass library to handle the subtitle rendering.

How do I mix a dub track with the original audio during video localization?

To mix a dub track during video localization, the tool combines the new dub audio while keeping the original audio at a low volume. This final composite step ensures a professional translation feel by blending both audio tracks into the output video.

What is the difference between hardcoding subtitles and soft-muxing for video outputs?

Hardcoding subtitles permanently renders the text into the video frames, making them always visible on any platform. Soft-muxing embeds the subtitle file as a separate track, allowing viewers to toggle the subtitles on or off in supported media players.