AragornZJF/assistente-de-clipe-de-video

Assistente de Clipe de Vídeo

Assistente de edição automática de vídeos. Baseado no FFmpeg, oferece corte de vídeo, geração de legendas e exportação de vídeos curtos.

Capacidades Principais

1. Corte por Timeline — Extrair trechos usando timestamps
2. Corte por Palavras-chave — Encontrar trechos correspondentes a palavras-chave via ASR (legendas)
3. Queima de Legendas — Incorporar legendas SRT ao vídeo
4. Exportação de Vídeos Curtos — Cortar para proporções 9:16/1:1/16:9
5. Extração de Destaques — Extrair automaticamente os melhores momentos de vídeos longos

Início Rápido

Cortar por tempo

python3 scripts/cut_video.py --input video.mp4 --start 10 --duration 30 --output clip.mp4

Extrair múltiplos trechos

python3 scripts/cut_video.py --input video.mp4 --segments "0-30,60-90,120-150" --output ./clips/

Queimar legenda

python3 scripts/burn_subtitles.py --input video.mp4 --srt subs.srt --output subtitled.mp4

Exportar vídeo curto

python3 scripts/export_social.py --input video.mp4 --format vertical --duration 60 --output shorts/

Descrição dos Scripts

scripts/cut_video.py

Corta vídeos por timeline.

python3 scripts/cut_video.py \
  --input <arquivo de vídeo> \
  --start <segundos> \
  --duration <segundos> \
  [--segments "0-30,60-90"] \
  --output <saída>

scripts/burn_subtitles.py

Queima legendas SRT no vídeo.

python3 scripts/burn_subtitles.py \
  --input <vídeo> \
  --srt <arquivo de legenda> \
  --output <saída>

Suporte a personalização de posição da legenda, tamanho da fonte e cor.

scripts/export_social.py

Exporta para formatos adaptados a múltiplas plataformas.

python3 scripts/export_social.py \
  --input <vídeo> \
  --format <vertical|square|horizontal> \
  --duration <segundos> \
  --output <diretório de saída>

Formato	Proporção	Uso
vertical	9:16	TikTok/Kuaishou/Xiaohongshu
square	1:1	Instagram
horizontal	16:9	YouTube/Bilibili

scripts/extract_highlights.py

Extrai automaticamente os melhores momentos de vídeos longos.

python3 scripts/extract_highlights.py \
  --input <vídeo> \
  --num-clips <número de trechos> \
  --min-duration <duração mínima em segundos> \
  --output <diretório de saída>

Usa algoritmo de detecção de cena para localizar pontos de transição interessantes.

scripts/generate_subtitles.py

Gera arquivos de legenda SRT (requer serviço ASR).

python3 scripts/generate_subtitles.py \
  --input <vídeo> \
  --provider <whisper|funclip> \
  --output <legenda.srt>

Fluxos de Trabalho Típicos

Fluxo 1: Extrair 3 destaques de uma gravação de reunião

# 1. Cortar 3 trechos
python3 scripts/cut_video.py \
  --input meeting.mp4 \
  --segments "300-360,720-780,1200-1260" \
  --output ./clips/

# 2. Exportar cada um para formato TikTok
for f in ./clips/*.mp4; do
  python3 scripts/export_social.py \
    --input "$f" \
    --format vertical \
    --output ./shorts/
done

Fluxo 2: Adicionar legendas a um vídeo

# 1. Gerar legendas
python3 scripts/generate_subtitles.py \
  --input video.mp4 \
  --provider whisper \
  --output video.srt

# 2. Queimar legendas
python3 scripts/burn_subtitles.py \
  --input video.mp4 \
  --srt video.srt \
  --output subtitled.mp4

Fluxo 3: Criar vários vídeos curtos de uma vez

python3 scripts/export_social.py \
  --input long_video.mp4 \
  --format vertical \
  --duration 60 \
  --output ./shorts/

Requisitos de Ambiente

• Obrigatório: FFmpeg (ffmpeg / ffprobe)
• Opcional: FunClip (edição de vídeo ASR de código aberto da Alibaba)
• Opcional: Whisper (modo local ou API)

Referência de Instalação

# Instalar FunClip (recomendado)
pip install funclip

# Instalar Whisper
pip install openai-whisper

# FFmpeg (já instalado)
which ffmpeg  # deve retornar o caminho