cli-anything-videocaptioner
Herramienta de subtitulación de video impulsada por IA. Transcribe voz → optimiza subtítulos → traduce → quema en el video.
Instalación
pip install cli-anything-videocaptioner
Requisitos previos:
- Python 3.10-3.12 (
videocaptioner1.4.1 requiere>=3.10,<3.13) videocaptionerdebe estar instalado (pip install videocaptioner)- FFmpeg necesario para la síntesis de video
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-videocaptioner --help
# Iniciar modo interactivo REPL
cli-anything-videocaptioner
# Transcribir un video (gratuito, sin configuración)
cli-anything-videocaptioner transcribe video.mp4 --asr bijian
# Traducir subtítulos (traductor Bing gratuito)
cli-anything-videocaptioner subtitle input.srt --translator bing --target-language en
# Pipeline completa: transcribir → traducir → quemar subtítulos
cli-anything-videocaptioner process video.mp4 --asr bijian --translator bing --target-language en --subtitle-mode hard
# Revisar consistencia entre subtítulos y guion antes de la quema final
cli-anything-videocaptioner synthesize video.mp4 -s subtitles.srt \
--subtitle-mode hard \
--review-script approved_script.txt
# Renderizar una previsualización de un fotograma de subtítulos para revisión
cli-anything-videocaptioner review subtitles.srt \
--script approved_script.txt \
--preview-video video.mp4 \
--preview-output review_5s.png
# Salida JSON (para consumo por parte de agentes)
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
Modo REPL
Cuando se invoca sin un subcomando, la CLI inicia una sesión interactiva REPL:
cli-anything-videocaptioner
# Ingresa comandos interactivamente con autocompletado y historial
Grupos de comandos
transcribe — Voz a subtítulos
transcribe <input> [--asr bijian|jianying|whisper-api|whisper-cpp] [--language CODE] [--format srt|ass|txt|json] [-o PATH]
bijian(predeterminado): Gratuito, chino e inglés, sin configuraciónwhisper-api: Todos los idiomas, requiere--whisper-api-key
subtitle — Optimizar y traducir
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]
- Tres pasos: Dividir → Optimizar → Traducir
- Los traductores Bing/Google son gratuitos
- Se admiten 38 idiomas destino (códigos BCP 47)
synthesize — Quemar subtítulos en el video
synthesize <video> -s <subtitle> [--subtitle-mode soft|hard] [--quality ultra|high|medium|low] [-o PATH] [--review-script PATH] [--max-script-diff-ratio FLOAT]
- Refleja la superficie de síntesis del backend estable
- La apariencia de los subtítulos está controlada por el backend, no por banderas adicionales
--review-scriptverifica la deriva entre subtítulos y guion antes de la exportación final- Un
--max-script-diff-ratiomás bajo cuando la precisión de copia importa más que la resiliencia
process — Pipeline completa
process <input> [--asr ...] [--translator ...] [--target-language ...] [--subtitle-mode ...] [--layout ...] [--no-optimize] [--no-translate] [--no-synthesize] [-o PATH]
review — Verificación de consistencia y previsualización
review <input.srt|input.ass> [--script PATH] [--max-diff-ratio FLOAT] [--preview-video PATH] [--preview-at TC] [--preview-output PATH]
- Detecta deriva entre subtítulos y guion antes de una quema dura
- Puede renderizar un solo fotograma de revisión en lugar de producir un video final completo
styles — Listar preajustes de estilo
styles
- Informa si el backend instalado expone soporte de estilos predefinidos
config — Gestionar configuración
config show
config set <key> <value>
download — Descargar video en línea
download <URL> [-o DIR]
Salida JSON
Todos los comandos admiten --json para salida legible por máquina:
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
# {"output_path": "/path/to/output.srt"}
Notas del backend
- El backend aguas arriba actualmente requiere Python
>=3.10,<3.13; se prefiere Python3.12para ejecuciones matriciales. - Las banderas de estilo avanzadas en tiempo de síntesis dependen de la versión del backend. Usa
stylespara verificar si el backend instalado las expone. - Las banderas de compatibilidad como
layout,render_mode,style,style_overrideyfont_filedeben tratarse como no estables a menos questylesy el backend instalado confirmen que son compatibles.
Idiomas destino
Códigos BCP 47: zh-Hans zh-Hant en ja ko fr de es ru pt it ar th vi id y 23 más.