A comprehensive command-line utility for inter-converting VTT, SRT, ASS, and LRC subtitle formats with support for time-shifting and bilingual merging.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install subtitle-converter
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install subtitle-converter using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Subtitle Converter?
The Subtitle Converter is a specialized tool designed to bridge the gap between various media platforms and editing software. It provides a robust framework for handling subtitle files, ensuring that creators can move assets between web environments like YouTube and professional editors like Jianying without losing synchronization or metadata. As a key component of the Openclaw Skills ecosystem, it automates the tedious aspects of subtitle management.
Beyond simple format conversion, this tool addresses technical challenges such as cleaning up the messy rolling timestamps found in auto-generated YouTube VTT files and normalizing character encoding to UTF-8. Whether you are a video editor needing to sync audio or a developer building a localization pipeline, this skill provides the necessary precision and flexibility.
Subtitle Converter Use Cases
- Converting auto-generated YouTube VTT subtitles into clean SRT files for video editing software.
- Synchronizing subtitles with video tracks by applying precise positive or negative time offsets.
- Merging two separate language subtitle files into a single bilingual track.
- Performing batch format conversion on entire directories of subtitle assets for archival or distribution.
How Subtitle Converter Works
- The tool identifies the source file format and parses the timestamp and text data into a standardized internal representation.
- If time shifting is requested, the engine recalculates every timestamp based on the specified second offset.
- For bilingual merging, the tool aligns two separate files based on their temporal markers to create a combined entry.
- The processed data is serialized into the target format, applying format-specific rules like generating sequence numbers for SRT or handling line-based timing for LRC.
- The final output is saved as a UTF-8 encoded file to ensure maximum cross-platform compatibility.
Subtitle Converter Setup
To use this skill, ensure you have a Python environment ready. Navigate to your project directory and execute the conversion script via the CLI.
# Basic conversion from VTT to SRT
python scripts/convert.py input.vtt --format srt
# Shift subtitle timing forward by 2.5 seconds
python scripts/convert.py input.srt --shift 2.5
Subtitle Converter Data Schema & Taxonomy
The Subtitle Converter organizes data based on the unique requirements of each supported format. All outputs are normalized to UTF-8.
| Format | Common Use Case | Technical Characteristic |
|---|---|---|
| VTT | Web Video (YouTube) | Supports CSS-like styling and positioning |
| SRT | Universal Editing | Uses sequential indexing and comma-separated milliseconds |
| ASS | Advanced Animation | Supports complex typography and karaoke effects |
| LRC | Audio Lyrics | Line-based timing without explicit end-stamps |
Subtitle Converter Advanced Features
- Smart YouTube VTT Cleanup: Automatically merges rolling text blocks and removes word-level timing tags for a cleaner editing experience.
- Batch Processing: Utilize the
--batchflag to convert entire folders of subtitles simultaneously, significantly speeding up large project workflows. - Precise Time Shifting: Supports floating-point second values for micro-adjustments in subtitle synchronization.
- Bilingual Integration: Merges two distinct subtitle files into one, optimized for language learners and international content creators using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
WordPress WP-CLI Internal API
A professional toolkit for building, inspecting, and extending custom WordPress CLI commands using the official stable internal API.
WordPress WP-CLI Admin
A comprehensive administrative skill for managing WordPress installations through the WP-CLI command-line interface.
Mac Dev Staging
A specialized toolset for converting macOS into a repeatable, local PHP and MariaDB staging environment using native services and Homebrew.
Finnhub API
Access real-time stock market data, financial statements, and company news via the Finnhub API integration for Openclaw Skills.
Mechanics Sketches
A Python-powered tool for generating precise technical engineering sketches including beams, supports, and forces.
Todoist CLI Skill
A command-line integration that allows AI agents to manage Todoist tasks and agendas using the td CLI.
Featured*
