Communitygithub.com

video-filmstrip

Extrait les images d'une vidéo et génère une grille 4K à 4 colonnes, un code-barres de couleur moyenne et un CSV des valeurs RVB moyennes à l'aide de FFmpeg et Python.

Qu'est-ce que video-filmstrip ?

Cette compétence permet d'analyser n'importe quel fichier vidéo pour en extraire toutes les images-clés et produire une série de visuels synthétiques : une archive d'images extraites, une grille de filmstrip en 4K à 4 colonnes (avec ou sans numéros de trame), un code-barres représentant la couleur moyenne de chaque image, et un fichier CSV listant les valeurs RVB moyennes par trame. Elle utilise exclusivement FFmpeg et la bibliothèque standard Python (aucun paquet tiers requis), ce qui la rend légère et portable. Compatible avec les assistants IA comme Claude Code, Cursor, Codex, etc., elle fonctionne sur Windows, macOS et Linux, et gère automatiquement la fragmentation des grilles lorsque la hauteur dépasse la limite JPEG de 65500px de FFmpeg. L'utilisateur peut personnaliser le taux d'images, les dimensions, le préfixe des fichiers, le répertoire de sortie, ainsi que le début et la durée du clip à traiter.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Filmstrip Vidéo

Génère une archive d'images extraites, une grille de filmstrip 4K à 4 colonnes, un code-barres de couleur moyenne et un CSV des valeurs RVB moyennes à partir de n'importe quel fichier vidéo en utilisant FFmpeg et la bibliothèque standard Python (aucun paquet tiers requis).

Prérequis

Vérifiez que ffmpeg, ffprobe et python sont disponibles dans le PATH avant de lancer :

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

Étapes

  1. Résoudre le chemin de la vidéo d'entrée et demander à l'utilisateur s'il souhaite que les tuiles de la grille de filmstrip soient numérotées avec des badges de trame ou non (sauf s'il l'a déjà spécifié dans sa demande), ainsi que toute option facultative de remplacement (taux d'images, répertoire de sortie, préfixe, début/durée de découpage, ou dimensions personnalisées).
  2. Exécuter generate_filmstrip.py avec le chemin de la vidéo d'entrée :
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

Passer les options facultatives uniquement en cas de remplacement des valeurs par défaut :

  • --no-frame-numbers : Omettre les badges de trame de 16 pixels en bas à gauche sur les feuilles de grille (à passer lorsque l'utilisateur choisit des tuiles non numérotées)
  • --output-dir <dir> : Répertoire de destination (par défaut : <prefix>_filmstrip à côté de la vidéo d'entrée)
  • --prefix <name> : Préfixe du nom de fichier de sortie (par défaut : nom de base de la vidéo d'entrée)
  • --fps <rate> : Images par seconde à extraire (par défaut : 1.0)
  • --cols <count> : Nombre de colonnes de la grille (par défaut : 4)
  • --grid-width <px> : Largeur totale de la grille en pixels (par défaut : 3840)
  • --barcode-height <px> : Hauteur du code-barres de couleur moyenne en pixels (par défaut : 715)
  • --barcode-stripe-width <px> : Largeur du code-barres par image en pixels (par défaut : 1)
  • --quality <2-31> : Qualité MJPEG de FFmpeg, plus basse = meilleure (par défaut : 2)
  • --start <sec> : Décalage de début en secondes (-ss)
  • --duration <sec> : Durée du clip en secondes (-t)
  1. Vérifier les artefacts générés dans le dossier de sortie :
    • frames/<prefix>-001.jpeg ... (images extraites conservées à la résolution originale de la vidéo, sans badge)
    • <prefix>_grid.jpeg ou numérotés <prefix>_grid-001.jpeg ... (feuilles de grille de filmstrip à 4 colonnes, avec badges de trame de 16 pixels en bas à gauche sauf si --no-frame-numbers a été passé, fragmentées automatiquement à la limite de hauteur JPEG de 65500px de FFmpeg)
    • <prefix>_averagesRGB.jpeg (code-barres de couleur moyenne)
    • <prefix>_averagesRGB.csv (lignes frame,timestamp_sec,r,g,b correspondant au nombre d'images extraites)
  2. Signaler le répertoire de sortie et fournir des liens cliquables pour la ou les feuilles de grille générées, le code-barres, le CSV et le dossier des images.

Skills associés