Communitygithub.com

poppatompong-dev/dreisprachiger-untertitel-baukasten

Erstellt direkt hochladbare SRT-Untertiteldateien auf Thailändisch, Englisch und vereinfachtem Chinesisch (oder jeder anderen Sprachkombination) für YouTube Shorts, TikTok oder Reels – mit perfekt synchronen Zeiten, natürlicher Übersetzung und zeilenweisen Brüchen für das 9:16-Format.

Was ist dreisprachiger-untertitel-baukasten?

Dieser Skill baut aus einem Skript, einem Transkript mit Zeitstempeln oder einer bestehenden SRT-Datei drei Untertiteldateien in Thailändisch, Englisch und vereinfachtem Chinesisch (zh-Hans) – oder einer beliebigen anderen Sprachkombination –, die exakt dieselben Timings teilen und wie gesprochene, natürliche Sprache klingen. Er unterstützt die gängigsten Kurzvideo-Plattformen (YouTube Shorts, TikTok, Reels) und optimiert die Texte für vertikale 9:16-Bildschirme, indem er Zeilen auf maximal 15–38 Zeichen begrenzt und eine Lesbarkeitsprüfung durchführt (Zeichendichte, minimale Einblenddauer, Vermeidung von Überlappungen). Das mitgelieferte Python-Skript (nur Standardbibliothek) erzeugt die SRT-Dateien aus einem JSON-Segmentformat und meldet Qualitätsprobleme (z. B. zu lange Zeilen oder zu schnelle Lesegeschwindigkeit) – erst wenn null Fehler übrig sind, gilt die Arbeit als abgeschlossen. Der Skill kann grobe Zeitangaben aus der Textlänge schätzen (mit `--estimate`), warnt aber explizit, dass diese im Editor korrigiert werden müssen. Zusätzlich gibt er Hinweise, wie die SRT-Dateien in YouTube Studio hochgeladen oder direkt ins Video eingebrannt werden, je nach Plattformunterstützung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/poppatompong-dev/trilingual-subtitles-skill/tree/HEAD/skills/shorts-trilingual-srt

In Ihrer bevorzugten KI fragen

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

Dokumentation

Dreisprachiger SRT-Baukasten (TH / EN / ZH)

Ein Kurzvideo mit Untertiteln in drei Sprachen erreicht Zuschauer, die sich nie eine Stimme anhören würden, die sie nicht verstehen. Aber schlechte Untertitel sind schlimmer als keine: asynchrone Zeilen, mitten im Wort abgeschnittene Sätze oder Chinesisch, das wie eine Maschinenübersetzung klingt, lassen einen Clip billig wirken. Dieses Skill produziert drei SRT-Dateien, die exakt dieselben Timings teilen, natürlich lesbar sind und auf einen Telefonbildschirm passen.

Das Skript scripts/make_srt.py (nur Python-Standardbibliothek) schreibt die Dateien und prüft sie. Verwende es, wenn du Code ausführen kannst; wenn nicht, befolge dieselben Regeln von Hand und gib den SRT-Text in Code-Blöcken aus.

Schritt 1 – Den zeitgestempelten Quelltext besorgen

Ermittle, welche dieser Quellen der Benutzer hat, am besten zuerst:

  1. Ein Transkript mit Zeitstempeln (SRT/VTT aus der Bearbeitungs-App, YouTube-Autountertitel, ein Speech-to-Text-Tool) → verwende dessen Timings. Fasse Hinweise zusammen oder teile sie auf, sodass jeder Hinweis eine einzelne Idee von 1–3,5 Sekunden repräsentiert.
  2. Das finale Skript + die Clip-Länge → teile das Skript in Hinweise auf (je ein gesprochener Satz) und lasse das Skript mit --estimate <Sekunden> Timings schätzen. Sage dem Benutzer, dass die Timings Schätzungen sind und im Editor an die Stimme angepasst werden müssen – geschätzte Untertitel sind der häufigste Grund für „die Untertitel fühlen sich falsch an“.
  3. Nur eine Audio-/Videodatei → wenn dir in dieser Sitzung ein Speech-to-Text-Tool zur Verfügung steht, transkribiere zuerst mit Wort-Zeitstempeln. Wenn nicht, sag es klar und bitte um einen Transkriptexport aus der Bearbeitungs-App (die meisten Editoren und YouTube Studio können Untertitel exportieren). Erfinde niemals, was gesagt wurde.

Behalte die Quellsprache genau so, wie sie gesprochen wurde – Untertitel, die von der Stimme abweichen, verwirren die Zuschauer. Korrigiere nur offensichtliche Transkriptionsfehler (falsch verstandene Wörter, Markennamen) und teile dem Benutzer mit, welche du korrigiert hast.

Schritt 2 – Zeilenweise übersetzen

Übersetze jeden Hinweis separat, damit die Timings sprachübergreifend identisch bleiben. Regeln:

  • Gesprochen, kurz, natürlich. Untertitel werden in ein oder zwei Sekunden gelesen. Bevorzuge „Schalte es nachts aus“ gegenüber „Es wird empfohlen, das Gerät während der Nachtstunden auszuschalten.“
  • Bedeutung vor Wörtern. Thailändische Füllwörter (นะครับ, เลย, อ่ะ) verschwinden im Englischen/Chinesischen. Redewendungen bekommen ein Äquivalent, keine wörtliche Kopie.
  • Halte Zahlen, Einheiten, Modellnamen und App-Namen in allen drei Dateien identisch und im selben Format (z. B. 80%, 20W, iOS 26). Prüfe, ob jede Zahl in der thailändischen Zeile auch in den EN- und ZH-Zeilen vorkommt.
  • Chinesisch = vereinfacht (zh-Hans), es sei denn, der Benutzer wünscht traditionell (zh-Hant, für Zuschauer aus Taiwan/Hongkong). Verwende vollbreite Satzzeichen (,。?!). Keine Leerzeichen zwischen chinesischen Zeichen.
  • Menübezeichnungen und UI-Text auf dem Bildschirm: verwende die Bezeichnung, wie sie tatsächlich in der jeweiligen Sprachversion der App/des Telefons erscheint, wenn du sie kennst; wenn du dir der offiziellen Bezeichnung nicht sicher bist, übersetze beschreibend und markiere es, damit der Benutzer auf einem auf diese Sprache eingestellten Gerät nachprüfen kann.
  • Produkt-/Markennamen, Ortsnamen und Personennamen: behalte die offizielle Romanisierung bei; übersetze Markennamen nicht ins Chinesische, es sei denn, die Marke hat einen offiziellen chinesischen Namen, bei dem du dir sicher bist.
  • Füge keine Informationen, Witze oder Emojis hinzu, die nicht in der Stimme sind.

Schritt 3 – Das JSON schreiben und das Skript ausführen

{
  "langs": ["th", "en", "zh-Hans"],
  "segments": [
    {"start": 0.0, "end": 2.6, "th": "ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม?", "en": "Does charging overnight ruin your battery?", "zh-Hans": "整夜充电会伤电池吗?"},
    {"start": 2.7, "end": 6.1, "th": "คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ", "en": "Short answer: not instantly, but heat is the real enemy.", "zh-Hans": "简单说:不会马上坏,但真正的敌人是热量。"}
  ]
}
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01
# noch ohne Timings:
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01 --estimate 38.5

Ausgabe: subs/clip01.th.srt, subs/clip01.en.srt, subs/clip01.zh-Hans.srt plus ein QC-Bericht.

Zeilenumbrüche: Das Skript bricht lange Hinweise in zwei Zeilen um. Thailändisch hat keine Leerzeichen zwischen Wörtern, daher bricht es nur an den Leerzeichen, die thailändische Schreiber zwischen Phrasen setzen – es wird niemals ein thailändisches Wort in der Mitte teilen. Wenn ein thailändischer Hinweis als zu lang markiert wird, füge ein Leerzeichen zwischen Phrasen ein, wo ein Umbruch natürlich ist, oder erzwinge den Umbruch mit | (Leerzeichen-Pipe-Leerzeichen), z. B. "เปิดโหมดชาร์จ | แบบปรับให้เหมาะสม".

Schritt 4 – Jede QC-Meldung beheben

Das Skript prüft pro Sprache:

PrüfungStandardgrenzeWarum wichtig
Zeichen pro ZeileTH 24 · EN 38 · ZH 15Vertikaler Bildschirm; längere Zeilen laufen unter die Like-/Kommentar-Buttons
Zeilen pro Hinweis2Drei Zeilen überdecken das Bild
Lesegeschwindigkeit (Zeichen/Sek.)TH 17 · EN 20 · ZH 9Schneller als das können Zuschauer nicht fertig lesen
Einblenddauer≥ 0,7 sBlitze sind unlesbar
Überschneidungen / Ende vor Start / leerer Textkeine erlaubtPlattformen lehnen die Datei ab oder zeigen sie falsch an

Behebe es, indem du die Übersetzung kürzt (erste Wahl), einen langen Hinweis in zwei aufteilst oder einen Blitz-Hinweis mit seinem Nachbarn zusammenführst. Führe erneut aus, bis es 0 Fehler gibt; ein paar Warnungen sind in Ordnung, wenn du dem Benutzer sagst, was sie sind. Die Grenzen können mit --max-line und --max-cps geändert werden, wenn der Stil des Benutzers abweicht.

Die thailändische Zeichenzählung ignoriert Vokal- und Tonzeichen, die über oder unter einem Buchstaben sitzen, da sie auf dem Bildschirm keine Breite einnehmen.

Schritt 5 – Übergabe

Gib dem Benutzer:

  1. Die drei .srt-Dateien (oder deren Inhalt in Code-Blöcken, wenn du keine Dateien erstellen kannst).
  2. Eine kurze Tabelle mit allen Zeilen, bei denen du dir unsicher warst (UI-Bezeichnungen, Slang, Namen), damit sie nachprüfen können.
  3. Wie man sie verwendet:
    • YouTube Studio: Untertitel → Video auswählen → Sprache hinzufügen → Datei hochladen → „Mit Zeitangabe“. Eine Datei pro Sprache hochladen. Zuerst die Originalsprache des Videos festlegen.
    • Eingebrannte Untertitel (Text auf dem Video): Die meisten Kurzvideo-Zuschauer schauen stumm, daher ist es üblich, die Hauptsprache ins Video einzubrennen und die anderen als SRT hochzuladen. Viele Editoren importieren SRT und gestalten es.
    • TikTok / Reels: Die Unterstützung für das Hochladen von SRT-Dateien variiert je nach App-Version und Region – wenn es keine Upload-Option gibt, brenne die Untertitel stattdessen im Editor ins Video ein. Prüfe die aktuelle Hilfeseite der Plattform.

Beispiel

Benutzer: "Mach mir 3-sprachige Untertitel, Clip 9 Sekunden" + Skript:

ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม? / คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ / เปิดโหมดชาร์จแบบปรับให้เหมาะสม ในตั้งค่าแบตเตอรี่

Was du tust: drei Hinweise → übersetzen → mit --estimate 9 ausführen → die QC warnt, dass thailändischer Hinweis 3 eine 26-Zeichen-Zeile hat (เปิดโหมดชาร์จแบบปรับให้เหมาะสม, Limit 24). Einen Umbruch zu erzwingen würde hier nicht helfen (die zweite Zeile würde zu lang), also kürze den Untertitel stattdessen: "เปิดโหมดถนอมแบต ในตั้งค่าแบตเตอรี่". Ein Untertitel darf etwas kürzer sein als die gesprochene Zeile, solange die Bedeutung gleich bleibt; wenn der Stil des Benutzers wortgetreue Untertitel vorsieht, frage vor dem Kürzen. Erneut ausführen: 0 Fehler, 1 Warnung (Timings geschätzt). Liefere die drei Dateien und sage: "Die Timings sind aus der Textlänge geschätzt – verschiebe sie im Editor, um sie an deine Stimme anzupassen; bitte überprüfe den englischen/chinesischen Namen der Batterieeinstellung auf einem auf diese Sprache eingestellten Telefon".

Ergebnis clip01.th.srt:

1
00:00:00,000 --> 00:00:02,653
ชาร์จมือถือข้ามคืน
แบตเสื่อมจริงไหม?

2
00:00:02,653 --> 00:00:06,347
คำตอบสั้น ๆ คือ ไม่ได้พังทันที
แต่ความร้อนคือตัวการ

3
00:00:06,347 --> 00:00:09,000
เปิดโหมดถนอมแบต
ในตั้งค่าแบตเตอรี่

Verwandte Skills