Communitygithub.com

bubble202603/video-subtitle-skill

Habilidad OpenClaw — subtítulos automáticos en chino para videos (similar a JianYing). Procesamiento en JS.

¿Qué es video-subtitle-skill?

Esta habilidad permite a un agente AI (como Claude Code o similar) procesar automáticamente videos y agregarles subtítulos en chino, emulando la funcionalidad de herramientas como JianYing (剪映). Funciona en tres etapas: primero, utiliza el modelo Whisper AI (implementación faster-whisper) para reconocer el habla del audio del video y generar subtítulos en inglés. Luego, traduce esos subtítulos al chino mediante la API de Google Translate. Finalmente, emplea FFmpeg para incrustar (hardcode) los subtítulos chinos en el video. Es compatible con formatos comunes como MP4, MOV y AVI. La habilidad requiere que FFmpeg esté instalado en el sistema y también ciertas bibliotecas de Python (faster-whisper y translators). Su interfaz principal es a través de un script JavaScript (add-subtitle.js), que se puede invocar desde la línea de comandos o integrar en flujos de trabajo de agentes. Es útil para creadores de contenido, desarrolladores o cualquier persona que necesite subtitular videos de forma automatizada y eficiente, con opciones de personalización del modelo Whisper (base, large) y posibilidad de corregir subtítulos manualmente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add bubble202603/video-subtitle-skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Subtítulos para Video

Agrega automáticamente subtítulos en chino a videos, similar a la función de subtítulos automáticos de JianYing.

Funcionalidades

  • Utiliza Whisper AI para reconocer el habla del video y generar subtítulos en inglés
  • Traduce automáticamente a subtítulos en chino
  • Usa FFmpeg para incrustar los subtítulos en el video

Cómo usar

# Uso básico
clawhub install video-subtitle

# O simplemente díselo al agente
"Agrega subtítulos en chino a este video"

Requisitos previos

  1. ffmpeg - Debe estar instalado

    apt-get install -y ffmpeg
    
  2. Entorno Python - Se requieren los siguientes paquetes:

    pip install faster-whisper translators
    

Uso en línea de comandos

# Agregar subtítulos a un video
node /root/.openclaw/workspace/skills/video-subtitle/add-subtitle.js <ruta del video> [idioma de destino]

# Ejemplo
node add-subtitle.js /path/to/video.mp4 zh

Flujo completo

  1. Reconocimiento de voz - Usa faster-whisper para extraer subtítulos en inglés
  2. Traducción - Usa la API de Google Translate para convertir a chino
  3. Incrustación - FFmpeg codifica los subtítulos directamente en el video

Salida

  • Nuevo archivo de video con el video original + subtítulos en chino
  • Archivo de subtítulos .srt con el mismo nombre (opcional)

Notas importantes

  • La duración del video afecta el tiempo de procesamiento (el reconocimiento de voz es el cuello de botella)
  • Compatible con formatos de video comunes como MP4, MOV, AVI
  • Usa el modelo Whisper "base" por defecto (amigable con CPU)
  • Para mayor precisión, se puede usar el modelo "large" (requiere más memoria)

Corrección de subtítulos

Si los subtítulos generados tienen errores (por ejemplo, nombres propios mal reconocidos), puedes:

  1. Editar manualmente el archivo .srt generado
  2. Volver a ejecutar el paso de incrustación
# Solo volver a incrustar subtítulos (sin volver a reconocer)
ffmpeg -i input.mp4 -vf "subtitles=corrected.srt" -c:a copy output.mp4

Autor: Bubble 🫧
Versión: 1.0.0
Actualización: 2026-03-05

Skills relacionados