Communitygithub.com

Video-Filmstreifen

Extrahiert Videobilder und erstellt ein 4K-4-Spalten-Filmstreifenraster, ein Durchschnittsfarb-Barcode-Bild und eine durchschnittliche RGB-CSV-Datei mit FFmpeg und Python.

Was ist Video-Filmstreifen?

Dieses Skill ermöglicht die automatische Extraktion von Einzelbildern aus Videodateien und die Erstellung visueller Zusammenfassungen in mehreren Formaten. Es erzeugt ein 4-spaltiges 4K-Filmstreifen-Raster (ggf. mit oder ohne Bildnummern), ein Durchschnittsfarb-Barcode-Bild sowie eine CSV-Datei mit den durchschnittlichen RGB-Werten jedes extrahierten Bildes. Der gesamte Prozess nutzt FFmpeg für die Bildverarbeitung und ausschließlich die Python-Standardbibliothek – es sind keine Drittanbieter-Pakete erforderlich. Der Skill unterstützt die Skalierung auf 4K-Auflösung, optionale Zeitbegrenzungen, benutzerdefinierte Bildraten und die automatische Aufteilung in mehrere Rasterblätter, falls die JPEG-Höhengrenze von FFmpeg (65500 Pixel) überschritten wird. Entwickler und KI-Agenten können dieses Skill nahtlos mit FFmpeg, ffprobe und Python auf dem Systempfad verwenden, um aus jedem Videoformat schnell archivierte Frames, ein Raster und Farbmetadaten zu generieren. Dies ist besonders nützlich für Videoanalyse-Workflows, Inhaltsübersichten oder die schnelle visuelle Navigation durch Videomaterial. Unterstützte Plattformen: Claude Code, Cursor, Codex und andere KI-Agenten, die FFmpeg und Python ausführen können.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Video-Filmstreifen?

Erzeuge ein Archiv extrahierter Bilder, ein 4-spaltiges 4K-Filmstreifenraster, ein Durchschnittsfarb-Barcode-Bild und eine durchschnittliche RGB-CSV-Datei aus jeder Videodatei mit FFmpeg und der Python-Standardbibliothek (keine Drittanbieter-Pakete erforderlich).

Voraussetzungen

Stelle sicher, dass ffmpeg, ffprobe und python im PATH verfügbar sind, bevor du fortfährst:

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

Schritte

  1. Löse den Pfad der Eingabevideodatei auf und frage den Benutzer, ob die Kacheln des Filmstreifenrasters mit Bildnummern (Frame Badges) versehen oder ohne Nummern sein sollen (sofern nicht bereits in der Anfrage angegeben), sowie optionale Überschreibungen (Bildrate, Ausgabeverzeichnis, Präfix, Start-/Dauertrimmung oder benutzerdefinierte Maße).
  2. Führe generate_filmstrip.py mit dem Pfad des Eingabevideos aus:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

Übergib optionale Flags nur, wenn die Standardwerte überschrieben werden sollen:

  • --no-frame-numbers: Entfernt die 16px großen Bildnummern (Frame Badges) unten links in den Rasterblättern (übergib dies, wenn der Benutzer Kacheln ohne Nummern wählt)
  • --output-dir <verzeichnis>: Zielverzeichnis (Standard: <präfix>_filmstrip neben dem Eingabevideo)
  • --prefix <name>: Ausgabedateinamenspräfix (Standard: Dateiname des Eingabevideos ohne Erweiterung)
  • --fps <rate>: Bilder pro Sekunde extrahieren (Standard: 1.0)
  • --cols <anzahl>: Anzahl der Rasterspalten (Standard: 4)
  • --grid-width <px>: Gesamtbreite des Rasters in Pixeln (Standard: 3840)
  • --barcode-height <px>: Höhe des Durchschnittsfarb-Barcodes in Pixeln (Standard: 715)
  • --barcode-stripe-width <px>: Barcode-Breite pro Bild in Pixeln (Standard: 1)
  • --quality <2-31>: FFmpeg MJPEG-Qualität, niedriger = besser (Standard: 2)
  • --start <sek>: Start-Offset in Sekunden (-ss)
  • --duration <sek>: Clip-Dauer in Sekunden (-t)
  1. Überprüfe die erzeugten Artefakte im Ausgabeverzeichnis:
    • frames/<präfix>-001.jpeg ... (gespeicherte extrahierte Bilder in Originalvideoauflösung, ohne Bildnummern)
    • <präfix>_grid.jpeg oder nummeriert <präfix>_grid-001.jpeg ... (4-spaltige Filmstreifen-Rasterblätter, mit 16px großen Bildnummern unten links, sofern nicht --no-frame-numbers übergeben wurde; automatische Aufteilung bei FFmpegs JPEG-Höhengrenze von 65500px)
    • <präfix>_averagesRGB.jpeg (Durchschnittsfarb-Barcode)
    • <präfix>_averagesRGB.csv (frame,timestamp_sec,r,g,b-Zeilen entsprechend der Anzahl extrahierter Bilder)
  2. Melde das Ausgabeverzeichnis und klickbare Links für die erzeugten Rasterblätter, den Barcode, die CSV-Datei und das Frames-Verzeichnis.

Verwandte Skills