Communitygithub.com

phloglucinol/bilingual-video-subtitles-skill

Erzwingt das Ausrichten chinesischer Transkripte auf MP4 (stable-ts), übersetzt sie ins Englische, multiplexiert weiche 3-Spur-Untertitel und brennt zweisprachige Hardsubs für Agent-Pipelines ein.

Was ist bilingual-video-subtitles-skill?

Dieses Skill ermöglicht es KI-Agenten, automatisch zweisprachige Untertitel für Videos zu generieren und einzubetten. Es verwendet stable-ts, um chinesische Transkripte präzise auf das Audio eines MP4-Videos auszurichten (Forced Alignment), übersetzt die Untertitel dann ins Englische und multiplexiert sie als drei weiche Untertitelspuren (Chinesisch, Englisch, zweisprachig) in den Container. Optional können die zweisprachigen Untertitel dauerhaft in das Video eingebrannt werden (Hardsub). Das Skill ist für CI/CD-Pipelines und automatische Workflows optimiert. Es wird auf Agent-Plattformen wie Claude Code, Cursor, Codex und anderen CLI-basierten Agenten ausgeführt, die ffmpeg, Python und stable-ts unterstützen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add phloglucinol/bilingual-video-subtitles-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht bilingual-video-subtitles-skill?

Erzwingt das Ausrichten chinesischer Transkripte auf MP4 (stable-ts), übersetzt sie ins Englische, multiplexiert weiche 3-Spur-Untertitel und brennt zweisprachige Hardsubs für Agent-Pipelines ein.

Funktionen

  • Forced Alignment: Verwendet stable-ts, um chinesische Texte (SRT oder TXT) präzise auf das Audio einer MP4-Datei auszurichten.
  • Übersetzung: Übersetzt die ausgerichteten chinesischen Untertitel automatisch ins Englische (z. B. über die OpenAI API).
  • Weiches Multiplexing (Softsub): Erstellt eine MP4-Datei mit drei weichen Untertitelspuren:
    • Spur 1: Chinesisch
    • Spur 2: Englisch
    • Spur 3: Zweisprachig (CN+EN)
  • Hardsub-Einbrennen (optional): Brennt die zweisprachigen Untertitel dauerhaft in das Video ein (Hardsub).
  • Pipeline-freundlich: Entwickelt für die Integration in automatisierte Agent-Workflows und CI/CD-Pipelines.

Voraussetzungen

  • ffmpeg (installiert und im PATH)
  • Python 3.8+ mit den Paketen stable-ts und openai (oder einem anderen Übersetzungsdienst)
  • Eine MP4-Datei und eine chinesische Transkriptdatei (SRT oder TXT)

Verwendung

Grundlegender Befehl (CLI)

python bilingual_subtitles.py --input video.mp4 --transcript transcript.srt --output output.mp4 --lang-source zh --lang-target en

Mit Übersetzungs-API

export OPENAI_API_KEY="dein-api-key"
python bilingual_subtitles.py --input video.mp4 --transcript transcript.txt --output output.mp4 --translate

Hardsub aktivieren

python bilingual_subtitles.py --input video.mp4 --transcript transcript.srt --output output_hardsub.mp4 --hardsub

Ausgabe

  • Eine MP4-Datei mit drei weichen Untertitelspuren (falls --hardsub nicht gesetzt) oder mit eingebranntem zweisprachigen Untertitel (falls --hardsub gesetzt).
  • Temporäre Dateien (ausgerichtete SRT, übersetzte SRT) werden standardmäßig bereinigt.

Unterstützte Plattformen

  • Claude Code
  • Cursor
  • Codex
  • Jeder CLI-basierte Agent mit Python- und ffmpeg-Unterstützung

Lizenz

MIT

Verwandte Skills