phloglucinol/skill-subtítulos-bilingües-video

¿Qué hace skill-subtítulos-bilingües-video?

Alinea forzosamente transcripciones en chino a MP4 (stable-ts), traduce al inglés, multiplexa 3 pistas suaves y quema subtítulos bilingües para pipelines de agentes.

Descripción

Este skill toma un archivo MP4 y una transcripción en chino, la alinea temporalmente con el audio usando stable-ts, traduce el texto al inglés, y produce un video final con:

• 3 pistas de subtítulos suaves (chino, inglés, bilingüe combinado)
• Subtítulos bilingües quemados (hardsub) en el video

Requisitos

• ffmpeg instalado y en el PATH
• Python 3.8+ con stable-ts instalado
• Modelo de traducción: argos-translate o API de traducción configurada

Uso

python bilingual_subtitles.py --video input.mp4 --transcript transcript.txt --output output.mp4

Parámetros

Parámetro	Descripción
--video	Ruta al archivo MP4 de entrada
--transcript	Archivo de texto con la transcripción en chino (una línea por segmento)
--output	Ruta del archivo MP4 de salida (por defecto: output.mp4)
--lang-src	Idioma de origen (por defecto: zh)
--lang-tgt	Idioma de destino (por defecto: en)

Proceso

1. Alineación forzosa: Usa stable-ts para alinear la transcripción con el audio del video.
2. Traducción: Traduce cada segmento al inglés usando argos-translate.
3. Generación de subtítulos: Crea 3 pistas SRT (chino, inglés, bilingüe).
4. Multiplexado: Inserta las pistas suaves en el MP4 usando ffmpeg.
5. Quemado: Genera un video final con subtítulos bilingües incrustados.

Ejemplo

python bilingual_subtitles.py --video clase.mp4 --transcript clase_zh.txt --output clase_bilingue.mp4

Esto producirá clase_bilingue.mp4 con subtítulos suaves y quemados.

Notas

• Asegúrate de que el archivo de transcripción tenga una línea por segmento de audio.
• Para videos largos, el proceso puede tomar varios minutos.
• Compatible con Claude Code, Cursor y Codex.

Licencia

MIT