bilingual-subtitle

Category: Content & Multimedia | Uploader: vorojar | Downloads: 0 | Version: v1.0（Latest）

视频字幕提取、翻译、双语合并、烧录。不用于：纯音频转文字、翻译文本文件、视频剪辑

Changelog: Source: GitHub https://github.com/vorojar/AgentClaw

Directory Structure

Current level: tree/master/skills/bilingual-subtitle/

📁 scripts/
- 📄 burn_srt.py 1.5 KB
- 📄 extract_srt.py 2.7 KB
- 📄 merge_srt.py 1.5 KB
- 📄 process.py 42.0 KB
- 📄 test_process.py 9.3 KB
- 📄 translate_srt.py 2.4 KB
📄 SKILL.md 4.4 KB

SKILL.md

---
name: bilingual-subtitle
description: 视频字幕提取、翻译、双语合并、烧录。不用于：纯音频转文字、翻译文本文件、视频剪辑
---

Extract subtitles from video using Whisper (GPU-accelerated), translate to Chinese, and optionally burn bilingual subtitles into video.

All output files go to the working directory (工作目录). Always use `auto_send: true` on the final shell call.

**IMPORTANT: Always use `process.py`. Never invent script names or parameters.**

## From URL (one command handles everything)

The script auto-detects URLs and handles: CC subtitle download → audio/video download → Whisper → translate → merge.

### Plain text subtitles, no timestamps (fastest when user says no timestamps)
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'URL' --source-only --txt-only -m tiny --beam-size 1 -o {WORKDIR}/output_source.txt", "timeout": 1800000, "auto_send": true}
```

### SRT subtitles only
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'URL' --srt-only -o {WORKDIR}/output_bilingual.srt", "timeout": 600000, "auto_send": true}
```

### Subtitles + burn into video
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'URL' -o {WORKDIR}/output_bilingual.mp4", "timeout": 600000, "auto_send": true}
```

### Chinese-only subtitles from URL
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'URL' -l zh --source-only --srt-only -o {WORKDIR}/output_zh.srt", "timeout": 600000, "auto_send": true}
```

## From local file

### Extract subtitles only
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'VIDEO_FILE' --srt-only -o {WORKDIR}/OUTNAME_bilingual.srt", "timeout": 300000, "auto_send": true}
```

### Extract + burn into video
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'VIDEO_FILE' -o {WORKDIR}/OUTNAME_bilingual.mp4", "timeout": 600000, "auto_send": true}
```

### Chinese-only subtitles
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'VIDEO_FILE' --chinese-only --srt-only -o {WORKDIR}/OUTNAME_zh.srt", "timeout": 300000, "auto_send": true}
```

### Source-only subtitles (no translation)
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'VIDEO_FILE' --source-only --srt-only -o {WORKDIR}/OUTNAME_source.srt", "timeout": 300000, "auto_send": true}
```

### Karaoke mode
```
{"command": "python skills/bilingual-subtitle/scripts/process.py 'VIDEO_FILE' --karaoke --fontsize 24 -o {WORKDIR}/OUTNAME_karaoke.mp4", "timeout": 600000, "auto_send": true}
```

## Parameters
| Parameter | Description | Default |
|---|---|---|
| `-o, --output` | Output file path | auto-generated |
| `-l, --language` | Source language (auto-detected by Whisper if omitted) | auto-detect |
| `-t, --target` | Target language | `zh-CN` |
| `-m, --model` | Whisper model (tiny/base/small/medium/large) | `small` |
| `--beam-size` | Whisper beam size; 1 is fastest | `1` |
| `--fontsize` | Subtitle font size | `14` |
| `--margin` | Bottom margin | `25` |
| `--srt-only` | Generate subtitle file only, skip video encoding | - |
| `--txt-only` | Generate plain text without timestamps, skip video encoding | - |
| `--chinese-only` | Output Chinese subtitles only | - |
| `--source-only` | Output source language subtitles only, skip translation entirely | - |
| `--karaoke` | Karaoke mode with word-level highlight | - |
| `--no-speech-threshold` | Filter non-speech segments (0-1) | `0.6` |

## Rules
- ALWAYS use bash shell (default), never PowerShell.
- ALWAYS copy the exact command templates above. Do NOT rename scripts or invent parameters.
- The ONLY script is `skills/bilingual-subtitle/scripts/process.py`. No other scripts should be called directly.
- timeout: 300000 (5min) for local files with --srt-only, 600000 (10min) for normal URLs or video encoding. For long videos or user-provided duration >30 minutes, use 1800000 (30min).
- GPU auto-detected: NVIDIA CUDA > Apple Silicon mlx > CPU int8. No config needed.
- Source language is auto-detected by Whisper. Use `-l` only to override (e.g., `-l zh` to force Chinese). If source and target language match, translation is automatically skipped.
- If the user asks for subtitles without timestamps or pure transcript text, use `--source-only --txt-only -m tiny --beam-size 1` directly. Do not generate SRT and post-process with shell.
- Do NOT run yt-dlp separately. The script handles URL downloading internally.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

bilingual-subtitle

Directory Structure

SKILL.md

Report

Notice