Communitygithub.com

video-filmstrip

Extrae fotogramas de vídeo y genera un mosaico 4K de 4 columnas, una imagen de código de barras de color promedio y un CSV RGB promedio usando FFmpeg y Python.

¿Qué es video-filmstrip?

Esta habilidad permite extraer fotogramas de cualquier archivo de vídeo y generar un completo conjunto de artefactos: un archivo de fotogramas extraídos, un mosaico de 4 columnas en resolución 4K, una imagen de código de barras que muestra el color promedio de cada fotograma y un archivo CSV con los valores RGB promedio. Utiliza exclusivamente FFmpeg para el procesamiento de vídeo y la biblioteca estándar de Python, sin necesidad de paquetes de terceros. Es compatible con Claude Code, Cursor, Codex y cualquier agente que pueda ejecutar comandos de Python y FFmpeg. El usuario puede controlar la frecuencia de fotogramas, el directorio de salida, el prefijo de los archivos, el recorte temporal y las dimensiones, así como decidir si los fotogramas en el mosaico llevan o no marcas de número de fotograma. Es ideal para análisis rápidos de vídeo, creación de resúmenes visuales o preprocesado para machine learning.

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

Preguntar en tu IA favorita

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

Documentación

Video Filmstrip

Genera un archivo de fotogramas extraídos, un mosaico de 4 columnas en resolución 4K, una imagen de código de barras de color promedio y un CSV RGB promedio a partir de cualquier archivo de vídeo usando FFmpeg y la biblioteca estándar de Python (sin necesidad de paquetes de terceros).

Prerrequisitos

Confirma que ffmpeg, ffprobe y python estén disponibles en PATH antes de ejecutar:

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

Pasos

  1. Resuelve la ruta del vídeo de entrada y pregunta al usuario si desea que las fichas del mosaico lleven números de fotograma (Frame Badges) o sin numerar (a menos que ya lo hayan especificado en su solicitud), además de cualquier anulación opcional (frecuencia de fotogramas, directorio de salida, prefijo, recorte de inicio/duración o dimensiones personalizadas).
  2. Ejecuta generate_filmstrip.py con la ruta del vídeo de entrada:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

Pasa banderas opcionales solo al anular los valores predeterminados:

  • --no-frame-numbers: Omite los números de fotograma (Frame Badges) de 16px en la esquina inferior izquierda de las hojas del mosaico (pasa cuando el usuario elige fichas sin numerar)
  • --output-dir <dir>: Directorio de destino (predeterminado: <prefijo>_filmstrip junto al vídeo de entrada)
  • --prefix <name>: Prefijo del nombre de archivo de salida (predeterminado: nombre base del vídeo de entrada)
  • --fps <rate>: Fotogramas por segundo a extraer (predeterminado: 1.0)
  • --cols <count>: Cantidad de columnas en el mosaico (predeterminado: 4)
  • --grid-width <px>: Ancho total del mosaico en píxeles (predeterminado: 3840)
  • --barcode-height <px>: Altura del código de barras de color promedio en píxeles (predeterminado: 715)
  • --barcode-stripe-width <px>: Ancho del código de barras por fotograma en píxeles (predeterminado: 1)
  • --quality <2-31>: Calidad MJPEG de FFmpeg, cuanto menor es el valor, mejor (predeterminado: 2)
  • --start <sec>: Desplazamiento de inicio en segundos (-ss)
  • --duration <sec>: Duración del clip en segundos (-t)
  1. Verifica los artefactos generados dentro de la carpeta de salida:
    • frames/<prefijo>-001.jpeg ... (Fotogramas extraídos a resolución original del vídeo, sin marcas)
    • <prefijo>_grid.jpeg o numerados <prefijo>_grid-001.jpeg ... (Hojas del mosaico de 4 columnas, con números de fotograma (Frame Badges) de 16px en la esquina inferior izquierda a menos que se haya pasado --no-frame-numbers, divididas automáticamente cuando se supera el límite de 65500px de altura JPEG de FFmpeg)
    • <prefijo>_averagesRGB.jpeg (Código de barras de color promedio)
    • <prefijo>_averagesRGB.csv (Filas frame,timestamp_sec,r,g,b que coinciden con la cantidad de fotogramas extraídos)
  2. Informa el directorio de salida y enlaces clicables para las hojas del mosaico generadas, el código de barras, el CSV y la carpeta de fotogramas.

Skills relacionados