subtitle-craft

Generate, translate, repair, and burn subtitles using DashScope ASR and FFmpeg.

2.0k|274|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill subtitle-craft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subtitle-craft
Source: https://github.com/openakita/openakita/tree/main/plugins/subtitle-craft
Command: npx skills add https://github.com/openakita/openakita --skill subtitle-craft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiosqlite, httpx, fastapi, pydantic, playwright.

What problem does it solve?

Producing subtitles for video and audio content requires juggling transcription services, translation tools, timeline repair, and video burning across disconnected tools. This Skill covers the full subtitle lifecycle in one place: automatic speech-to-text with word-level timestamps, multilingual translation, timeline repair, and subtitle burning into video.

Core Features & Use Cases

  • Auto Subtitle: Transcribe video or audio with Paraformer-v2 word-level timestamps, with optional speaker diarization and AI character-name mapping.
  • Translate & Repair: Translate SRT files into other languages (monolingual or bilingual output) and fix timeline overlaps or line-break issues locally at no API cost.
  • Burn & Hook Picking: Burn subtitles into video via FFmpeg ASS or Playwright HTML overlay, and use the AI Hook Picker mode to select the strongest opening dialogue for short-form video.
  • Use Case: Upload a 30-minute Chinese video, generate subtitles with speaker separation, translate them into bilingual English output, and burn the result into the video with a YouTube-style preset.

Quick Start

Ask the assistant to generate subtitles for a video file by providing its path, for example: create subtitles for /videos/interview.mp4 with speaker diarization enabled.

Frequently Asked Questions about subtitle-craft

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

FAQPage Schema
How do I generate subtitles from a video file automatically?

Use the auto_subtitle mode with the video file path to transcribe speech via Paraformer-v2 with word-level timestamps. Enable diarization_enabled to separate multiple speakers, and character_identify_enabled to map SPEAKER_xx labels to character names.

How to translate an SRT subtitle file to English?

Use the translate mode with your SRT path and set target_lang to en. The default qwen-mt-flash model offers the best value, and enabling bilingual keeps both original and translated lines in the output.

What is the difference between ASS and HTML subtitle burning?

ASS burning uses FFmpeg natively and is the recommended default for most videos. HTML burning uses Playwright with Chromium for custom CSS styling but is slower, roughly 340 ms per frame, so it suits videos under 3 minutes.

Does subtitle transcription require an API key?

Yes, auto_subtitle mode requires a DashScope API key for Paraformer-v2 ASR, configured in the plugin settings. Repair and burn modes run entirely locally with FFmpeg and cost nothing.

Why does subtitle burning fail on Windows?

FFmpeg's subtitles filter misinterprets Windows drive-letter paths unless the filename= keyword prefix is used. The plugin handles this escaping automatically, so failures usually indicate FFmpeg is missing from PATH or the SRT is not UTF-8 encoded.

What are the file size and duration limits for transcription?

Files over 2 GB or audio longer than 12 hours are rejected with a duration error kind. Split large media into smaller segments before submitting, and note that Paraformer tasks time out after 900 seconds by default.