cli-anything-videocaptioner
KI-gestütztes Videountertitelungswerkzeug. Sprache transkribieren → Untertitel optimieren → übersetzen → in Video einbrennen.
Installation
pip install cli-anything-videocaptioner
Voraussetzungen:
- Python 3.10-3.12 (
videocaptioner1.4.1 benötigt>=3.10,<3.13) videocaptionermuss installiert sein (pip install videocaptioner)- FFmpeg wird für die Videosynthese benötigt
Verwendung
Grundlegende Befehle
# Hilfe anzeigen
cli-anything-videocaptioner --help
# Interaktiven REPL-Modus starten
cli-anything-videocaptioner
# Video transkribieren (kostenlos, keine Einrichtung)
cli-anything-videocaptioner transcribe video.mp4 --asr bijian
# Untertitel übersetzen (kostenloser Bing-Übersetzer)
cli-anything-videocaptioner subtitle input.srt --translator bing --target-language en
# Vollständige Pipeline: transkribieren → übersetzen → Untertitel einbrennen
cli-anything-videocaptioner process video.mp4 --asr bijian --translator bing --target-language en --subtitle-mode hard
# Untertitel-/Skript-Konsistenz vor endgültigem Hard-Burn prüfen
cli-anything-videocaptioner synthesize video.mp4 -s subtitles.srt \
--subtitle-mode hard \
--review-script approved_script.txt
# Einzelbild-Untertitelvorschau für die Überprüfung rendern
cli-anything-videocaptioner review subtitles.srt \
--script approved_script.txt \
--preview-video video.mp4 \
--preview-output review_5s.png
# JSON-Ausgabe (für Agenten)
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
REPL-Modus
Wird die CLI ohne Unterbefehl aufgerufen, startet eine interaktive REPL-Sitzung:
cli-anything-videocaptioner
# Befehle interaktiv mit Tab-Vervollständigung und Verlauf eingeben
Befehlsgruppen
transcribe — Sprache in Untertitel
transcribe <input> [--asr bijian|jianying|whisper-api|whisper-cpp] [--language CODE] [--format srt|ass|txt|json] [-o PATH]
bijian(Standard): Kostenlos, Chinesisch & Englisch, keine Einrichtungwhisper-api: Alle Sprachen, erfordert--whisper-api-key
subtitle — Optimieren und übersetzen
subtitle <input.srt> [--translator llm|bing|google] [--target-language CODE] [--layout target-above|source-above|target-only|source-only] [--no-optimize] [--no-translate] [-o PATH]
- Drei Schritte: Aufteilen → Optimieren → Übersetzen
- Bing-/Google-Übersetzer sind kostenlos
- 38 Zielsprachen unterstützt (BCP‑47-Codes)
synthesize — Untertitel in Video einbrennen
synthesize <video> -s <subtitle> [--subtitle-mode soft|hard] [--quality ultra|high|medium|low] [-o PATH] [--review-script PATH] [--max-script-diff-ratio FLOAT]
- Spiegelt die stabile synthesize-Oberfläche des Backends wider
- Das Aussehen der Untertitel wird durch das Untertitel-Asset bzw. die Backend-Version gesteuert, nicht durch zusätzliche Harness-Flags
--review-scriptprüft Abweichungen zwischen Untertitel und Skript vor dem endgültigen Export- Niedrigeren
--max-script-diff-ratioverwenden, wenn Kopiergenauigkeit wichtiger ist als Robustheit
process — Vollständige Pipeline
process <input> [--asr ...] [--translator ...] [--target-language ...] [--subtitle-mode ...] [--layout ...] [--no-optimize] [--no-translate] [--no-synthesize] [-o PATH]
review — Konsistenzprüfung und Vorschau
review <input.srt|input.ass> [--script PATH] [--max-diff-ratio FLOAT] [--preview-video PATH] [--preview-at TC] [--preview-output PATH]
- Erkennt Abweichungen zwischen Untertitel und Skript vor einem Hard-Burn
- Kann ein einzelnes Prüfbild rendern, anstatt ein vollständiges finales Video zu erzeugen
styles — Stilvorlagen auflisten
styles
- Zeigt an, ob das installierte Backend Unterstützung für voreingestellte Stile bietet
config — Einstellungen verwalten
config show
config set <key> <value>
download — Online-Video herunterladen
download <URL> [-o DIR]
JSON-Ausgabe
Alle Befehle unterstützen --json für maschinenlesbare Ausgabe:
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
# {"output_path": "/path/to/output.srt"}
Backend-Hinweise
- Das vorgelagerte Backend erfordert derzeit Python
>=3.10,<3.13; für Matrix-Tests wird Python3.12bevorzugt. - Erweiterte Style-Flags zur Synthesezeit sind abhängig von der Backend-Version. Mit
styleslässt sich prüfen, ob das installierte Backend diese unterstützt. - Kompatibilitätsflags wie
layout,render_mode,style,style_overrideundfont_filesollten als nicht stabil betrachtet werden, es sei denn,stylesund das installierte Backend bestätigen ihre Unterstützung.
Zielsprachen
BCP‑47-Codes: zh-Hans zh-Hant en ja ko fr de es ru pt it ar th vi id und 23 weitere.