Communitygithub.com

godot-fun/storyboard-av-mix

Mischt pro-Einstellung Storyboard-Videos mit chinesischem und englischem Voice-Over, indem das Video zeitlich an die VO-Dauer angepasst wird. Schreibt Video-Chinese/ und Video-English/ (abgeglichen durch Shot-ID 01, 02, …).

Was ist storyboard-av-mix?

Diese Fähigkeit (Skill) automatisiert die Audiovisuell-Mischung (A/V-Mix) von Storyboard-Videos mit zweisprachigem Voice-Over auf Chinesisch und Englisch. Sie nimmt ein Storyboard-Video pro Einstellung (Shot) und zwei Sprachdateien (Chinesisch/Englisch) und passt die Videodauer mittels `setpts` (FFmpeg-Filter) an die Länge des jeweiligen Voice-Overs an. Das Ergebnis ist für jeden Shot ein synchronisiertes Video in zwei Sprachversionen, abgelegt in den Ordnern `Video-Chinese/` und `Video-English/`, benannt nach der Shot-ID (z. B. 01.mp4, 02.mp4). Dies ist besonders nützlich für Content-Ersteller, die Storyboards mit professionellem zweisprachigem Voice-Over versehen möchten, etwa für Animatic-Videos, Erklärvideos oder Dubbing-Projekte. Der Skill läuft in CLI-basierten Entwicklungsumgebungen wie Claude Code, Cursor oder Codex und nutzt FFmpeg als Kernwerkzeug. Er ermöglicht Batch-Verarbeitung mehrerer Shots und erspart manuelle Retiming-Arbeit, indem er Video- und Audiospuren automatisch aufeinander abstimmt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/godot-fun/godot-agent/tree/main/.cursor/skills/storyboard-av-mix

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht storyboard-av-mix?

Mischt pro-Einstellung Storyboard-Videos mit chinesischem und englischem Voice-Over, indem das Video zeitlich an die VO-Dauer angepasst wird (setpts). Schreibt Video-Chinese/ und Video-English/ (abgeglichen durch Shot-ID 01, 02, …). Verwenden Sie diesen Skill, wenn der Benutzer wünscht: Storyboard A/V-Mix, VO-Dubbing-Mix, Video-Retiming auf Audio, Video-Chinese, Video-English, zweisprachiges VO auf geschnittenem Video oder Batch-Mux von Video/ + Chinese/ + English/.

Verzeichnisstruktur

  • Video/ - Enthält die Storyboard-Videos pro Einstellung (z. B. 01.mp4, 02.mp4, …)
  • Chinese/ - Enthält die chinesischen Voice-Over-Audiodateien (z. B. 01.wav, 02.wav, …)
  • English/ - Enthält die englischen Voice-Over-Audiodateien (z. B. 01.wav, 02.wav, …)
  • Video-Chinese/ - Ausgabeordner für Videos mit chinesischem VO (wird erstellt)
  • Video-English/ - Ausgabeordner für Videos mit englischem VO (wird erstellt)

Funktionsweise

  1. Der Skill sucht nach Dateien in den Ordnern Video/, Chinese/ und English/, die durch dieselbe Shot-ID (z. B. 01.mp4 und 01.wav) verknüpft sind.
  2. Für jedes gefundene Shot-Triplett wird ein FFmpeg-Befehl ausgeführt, der das Video mit setpts an die Länge des Voice-Over anpasst und dann das Audio hinzufügt.
  3. Das Ergebnis wird als 01.mp4 in Video-Chinese/ (mit chinesischem VO) bzw. Video-English/ (mit englischem VO) gespeichert.

Verwendung

Stellen Sie sicher, dass die Eingabedateien vorhanden sind:

Video/
├── 01.mp4
├── 02.mp4
└── …

Chinese/
├── 01.wav
├── 02.wav
└── …

English/
├── 01.wav
├── 02.wav
└── …

Führen Sie den Skill aus mit:

godot-fun/storyboard-av-mix

Anforderungen

  • FFmpeg muss im Pfad installiert sein.
  • Die Dateinamen müssen konsistent sein (z. B. 01.mp4 in Video/, 01.wav in Chinese/ und 01.wav in English/).
  • Unterstützte Videoformate: .mp4, .mov, .mkv; Audio: .wav, .mp3, .aac.

Batch-Verarbeitung

Der Skill verarbeitet automatisch alle Shots im aktuellen Arbeitsverzeichnis. Sie können auch nur einen Teil der Shots verwenden, indem Sie nicht benötigte Dateien entfernen oder umbenennen.

Beispielbefehl (zur Referenz)

Intern wird folgender FFmpeg-Befehl für jeden Shot generiert:

ffmpeg -i Video/01.mp4 -i Chinese/01.wav -filter_complex "[0:v]setpts=PTS/1.2[v]" -map "[v]" -map 1:a -c:v libx264 -c:a aac -shortest Video-Chinese/01.mp4

Hinweise

  • Die Retiming-Funktion ist einfach: Das Video wird beschleunigt oder verlangsamt, um der Audiolänge zu entsprechen. Bei stark abweichenden Dauern kann das Video unnatürlich wirken.
  • Der Skill ist für kleine bis mittlere Projekte optimiert.
  • Bei Problemen überprüfen Sie die FFmpeg-Installation und die Dateinamen.

Lizenz

Apache 2.0

Verwandte Skills