Communitygithub.com

video-filmstrip

Extrai quadros de vídeo e gera uma grade de tira de filme 4K com 4 colunas, uma imagem de código de barras de cor média e um CSV RGB médio usando FFmpeg e Python.

O que é video-filmstrip?

Esta habilidade permite extrair quadros de qualquer arquivo de vídeo e gerar uma grade de tira de filme em 4K com 4 colunas, uma imagem de código de barras com a cor média de cada quadro e um arquivo CSV com os valores RGB médios. Ela utiliza exclusivamente FFmpeg e a biblioteca padrão do Python, sem dependências de terceiros. Suporta opções avançadas como taxa de quadros personalizada, recorte temporal, qualidade de compressão, numeração de quadros e dimensões da grade. É útil para análise visual rápida de vídeos, criação de resumos visuais, indexação de mídia e geração de metadados de cor para processamento posterior.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ajtopper/filmstrip-skill/tree/HEAD/skills/video-filmstrip

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Tira de Filme de Vídeo

Gere um arquivo de quadros extraídos, uma grade de tira de filme 4K com 4 colunas, uma imagem de código de barras de cor média e um CSV RGB médio a partir de qualquer arquivo de vídeo usando FFmpeg e a biblioteca padrão do Python (nenhum pacote de terceiros necessário).

Pré-requisitos

Confirme que ffmpeg, ffprobe e python estão disponíveis no PATH antes de executar:

ffmpeg -version; ffprobe -version; python --version

Etapas

  1. Resolva o caminho do vídeo de entrada e pergunte ao usuário se ele deseja que os tiles da Grade de Tira de Filme sejam numerados com Marcadores de Quadro ou não numerados (a menos que já tenham especificado na solicitação), além de quaisquer substituições opcionais (taxa de quadros, diretório de saída, prefixo, recorte de início/duração ou dimensões personalizadas).
  2. Execute generate_filmstrip.py com o caminho do vídeo de entrada:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

Passe flags opcionais apenas ao substituir os padrões:

  • --no-frame-numbers: Omite os Marcadores de Quadro de 16px no canto inferior esquerdo das Folhas de Grade (passe quando o usuário escolher tiles não numerados)
  • --output-dir <dir>: Diretório de destino (padrão: <prefix>_filmstrip ao lado do vídeo de entrada)
  • --prefix <name>: Prefixo do nome do arquivo de saída (padrão: nome base do vídeo de entrada)
  • --fps <rate>: Quadros por segundo a extrair (padrão: 1.0)
  • --cols <count>: Número de colunas da grade (padrão: 4)
  • --grid-width <px>: Largura total da grade em pixels (padrão: 3840)
  • --barcode-height <px>: Altura do código de barras de cor média em pixels (padrão: 715)
  • --barcode-stripe-width <px>: Largura do código de barras por quadro em pixels (padrão: 1)
  • --quality <2-31>: Qualidade MJPEG do FFmpeg, quanto menor melhor (padrão: 2)
  • --start <sec>: Deslocamento inicial em segundos (-ss)
  • --duration <sec>: Duração do clipe em segundos (-t)
  1. Verifique os artefatos gerados dentro da pasta de saída:
    • frames/<prefix>-001.jpeg ... (Quadros Extraídos mantidos na resolução original do vídeo, sem marcação)
    • <prefix>_grid.jpeg ou numerado <prefix>_grid-001.jpeg ... (Folhas de Grade de Tira de Filme com 4 colunas, com Marcadores de Quadro de 16px no canto inferior esquerdo, a menos que --no-frame-numbers tenha sido passado, divididas automaticamente no limite de altura JPEG de 65500px do FFmpeg)
    • <prefix>_averagesRGB.jpeg (Código de Barras de Cor Média)
    • <prefix>_averagesRGB.csv (linhas frame,timestamp_sec,r,g,b correspondentes à contagem de quadros extraídos)
  2. Informe o diretório de saída e links clicáveis para as folhas de grade geradas, código de barras, CSV e pasta de quadros.

Habilidades Relacionadas