Habilidade de Legendas para Vídeo
Adiciona automaticamente legendas em chinês a vídeos, semelhante ao recurso de legendas automáticas do JianYing.
Funcionalidades
- Usa o Whisper AI para reconhecer a fala do vídeo e gerar legendas em inglês
- Traduz automaticamente para legendas em chinês
- Usa o FFmpeg para queimar as legendas no vídeo
Como Usar
# Uso básico
clawhub install video-subtitle
# Ou simplesmente diga ao agente
"Adicione legendas em chinês a este vídeo"
Pré-requisitos
-
ffmpeg - Deve estar instalado
apt-get install -y ffmpeg -
Ambiente Python - Necessita dos seguintes pacotes:
pip install faster-whisper translators
Uso via Linha de Comando
# Adicionar legendas a um vídeo
node /root/.openclaw/workspace/skills/video-subtitle/add-subtitle.js <caminho-do-video> [idioma-alvo]
# Exemplo
node add-subtitle.js /path/to/video.mp4 zh
Fluxo Completo
- Reconhecimento de Fala - Usa o faster-whisper para extrair legendas em inglês
- Tradução - Usa a API Google Tradutor para converter para chinês
- Queima - FFmpeg codifica as legendas diretamente no vídeo
Saída
- Novo arquivo de vídeo com o vídeo original + legendas em chinês
- Arquivo .srt de legendas com o mesmo nome (opcional)
Observações
- A duração do vídeo afeta o tempo de processamento (o reconhecimento de fala é o gargalo)
- Suporta formatos de vídeo comuns como MP4, MOV, AVI
- Usa o modelo Whisper "base" por padrão (compatível com CPU)
- Para maior precisão, use o modelo "large" (requer mais memória)
Correção de Legendas
Se as legendas geradas estiverem incorretas (por exemplo, erros de reconhecimento de nomes próprios), você pode:
- Editar manualmente o arquivo .srt gerado
- Reexecutar a etapa de queima
# Apenas queimar legendas novamente (sem re-reconhecer)
ffmpeg -i input.mp4 -vf "subtitles=corrected.srt" -c:a copy output.mp4
Autor: Bubble 🫧
Versão: 1.0.0
Atualização: 2026-03-05