Communitygithub.com

Filmmaterial und Screenshots

Holen Sie sich die Bilder, aus denen ein Film besteht. Finden und lizenzieren Sie echtes Stock-Filmmaterial und Fotos, besetzen Sie konsistente Personen, schneiden Sie Clips aus ihren Quellen, korrigieren Sie alles auf einen Look, erfassen Sie echte Produktbildschirme und erstellen Sie einen QR-Code. Verwenden Sie es, nachdem das Drehbuch existiert und immer dann, wenn Filmmaterial, Fotos, Screenshots oder die Farbkorrektur geändert werden müssen.

Was ist Filmmaterial und Screenshots?

Diese Anleitung beschreibt einen vollständigen Workflow zur Erstellung von Filmmaterial und Screenshots für Video-Produktionen, die auf echten, nicht generierten Inhalten basieren. Sie umfasst die Suche und Lizenzierung von Stock-Filmmaterial über APIs wie Pexels sowie die Auswahl und Bearbeitung von Clips. Der Workflow betont die konsistente Besetzung von Personen, die Farbkorrektur (Grading) aller Clips mit einem einheitlichen Look und die Integration von Produkt-Screenshots aus Live-Umgebungen oder Demo-Konten. Er unterstützt jede Art von Produkt (Websites, Web-Apps, mobile Apps, physische Produkte) und stellt sicher, dass Screenshots die tatsächliche Benutzeroberfläche zeigen. Zusätzlich werden typografische Details (Schriftarten, Farben) aus dem Branding übernommen, ein QR-Code mit Fehlerkorrektur erstellt und alle Quellen in einer CREDITS.md-Datei dokumentiert. Die Anleitung ist plattformunabhängig und konzentriert sich auf praktische Schritte mit Kommandozeilen-Tools wie ffmpeg und Playwright.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-footage-and-screens

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Filmmaterial und Screenshots?

1. Echtes Filmmaterial, nicht generiert

Verwenden Sie echtes Stock-Filmmaterial von echten Menschen, es sei denn, die Person bittet um generiertes Video. Zuschauer erkennen generierte Gesichter, und ein Film über echte Probleme verliert seine Glaubwürdigkeit, wenn sie es tun.

Wo. Pexels (Pexels-Lizenz: kostenlos für kommerzielle Nutzung, keine Namensnennung) über die offizielle API: scripts/stock_search.py videos "<Abfrage>" out_dir speichert Thumbnails und eine Liste mit der größten Datei jedes Clips (meist 4K). Es benötigt einen kostenlosen PEXELS_API_KEY. Andere Bibliotheken, bei denen die Person ein Konto hat, sind ebenfalls in Ordnung. Notieren Sie die ID von allem, was Sie herunterladen.

Wie man sucht. Suchen Sie nach der Handlung und der Stimmung, nicht nach der Handlung: "Mann besorgt Laptop", "Frau Kaffee Laptop Cafe", "Paar planend Tisch". Laden Sie Thumbnails herunter, ordnen Sie sie in einem Kontaktbogen an und wählen Sie durch Hinschauen aus.

Eine Person, mehrere Clips. Eine Figur braucht mehr als eine Einstellung: ruhig für die Einleitung, besorgt für das Problem, entspannt für das Ende. Finden Sie einen Dreh, nicht einen Clip. Auf der Seite eines Clips sind die benachbarten IDs desselben Erstellers normalerweise derselbe Schauspieler in derselben Kleidung und im selben Raum. Zwei oder drei Clips einer Person sind mehr wert als zehn Clips von zehn Personen.

Besetzung vor der Namensgebung. Schauen Sie, wen das Filmmaterial tatsächlich zeigt, und wählen Sie dann Namen, Berufe und Städte, die dazu passen. Gemischte Besetzungen sind in Ordnung. Setzen Sie keinen Namen auf ein Gesicht, dem er offensichtlich nicht passt.

Ablehnen von Clips mit sichtbaren Markenlogos, die Sie nicht zuschneiden oder unscharf machen können, lesbaren Bildschirmen anderer Produkte, Kennzeichenschildern, Text in der falschen Sprache für die Geschichte oder einer Stimmung, die dem Takt widerspricht (ein lächelndes Gesicht im Problem).

2. Die Sekunden auswählen

Erstellen Sie einen Kontaktbogen jedes Kandidaten mit einem Bild pro Sekunde (scripts/sheet.sh). Notieren Sie pro Clip die Sekunden, die ruhig sind, die Sekunden, die besorgt sind, und jede Sekunde mit einem Logo oder einer Kamerabeule. Eine Überblendung oder eine Enthüllung am Anfang eines Clips ist normalerweise unbrauchbar.

Wenn eine Aufnahme eine lange Zeile abdecken muss, schneiden Sie sie mit einem Punch-In in zwei Teile: derselbe Clip, der zu einem späteren Zeitpunkt in 1,2-facher Größe erneut gezeigt wird. Wenn eine Aufnahme zu kurz ist, verlangsamen Sie sie: bis auf 80% läuft gut; darunter interpolieren Sie Einzelbilder mit ffmpeg minterpolate (mi_mode=mci) und prüfen Sie das Ergebnis auf Verzerrungen, bevor Sie es verwenden.

3. Schneiden und Grading

Schreiben Sie jeden Schnitt in footage.tsv (Name, Quelldatei, Start, Dauer) und erstellen Sie die Clips mit scripts/footage.sh footage.tsv grade.vf assets/footage 3840x2160. Ein Durchlauf erledigt den Schnitt, die Skalierung und das Grading direkt aus der Quelldatei.

  • Behalten Sie das Manifest. Es ist die einzige Aufzeichnung, woher ein Schnitt stammt. Wenn es verloren geht, kann scripts/match.py durch Vergleich von Einzelbildern wieder einen Offset finden.
  • Schneiden Sie in der Auflösung, in der Sie ausliefern werden. Hochskaliertes 1080p-Filmmaterial in einem 4K-Film wirkt unscharf neben scharfem Text.
  • Behalten Sie die Quelldownloads, die der Film verwendet; löschen Sie den Rest, sobald die Besetzung feststeht.

Ein Grading für alles. Clips aus fünf Drehs sehen aus wie fünf Filme, bis sie ein gemeinsames Grading haben. grade.vf ist ein neutrales Startrezept: leicht verringerte Sättigung, angehobene Schwarztöne, gehaltene Weißtöne, feines Korn, eine leichte Vignette. Um Filmmaterial an eine Marke zu binden, fügen Sie einen colorbalance-Schritt vor noise hinzu, der die Schatten in Richtung der dunklen Farbe der Marke und die Lichter in Richtung ihrer hellen Farbe lenkt, höchstens ein paar Prozent, zum Beispiel colorbalance=rs=0.045:gs=-0.03:bs=0.06:rh=0.055:gh=0.025:bh=-0.045 für pflaumenfarbene Schatten und cremefarbene Lichter. Betrachten Sie nach dem Grading einen Ausschnitt in Originalgröße eines Gesichts: Die Haut muss immer noch wie Haut aussehen.

Eine weichgezeichnete Kopie eines Clips (Skalieren auf 480 Pixel, Weichzeichnen, Zurückskalieren) ergibt einen Hintergrund für Text.

4. Fotos und Requisiten

Fotos, die als Requisiten verwendet werden (das Ding, das eine Person will, ein Ort), stammen aus denselben Quellen unter denselben Lizenzregeln. Wählen Sie Bilder ohne erkennbare Gesichter: eine Hochzeit gezeigt als Hände und Ringe, nicht als Paar, das nicht Ihre Figur ist. Verwischen Sie den Namen eines Herstellers mit ffmpeg delogo. Beschneiden Sie alle Requisiten auf ein einheitliches Seitenverhältnis, damit sie ein gemeinsames Rahmendesign teilen können.

5. Das echte Produkt

Was vom Produkt gezeigt wird, ist das echte Produkt. Zeichnen Sie niemals eine Benutzeroberfläche neu und geben Sie niemals Stock-Material als solches aus.

ProduktWas erfassen
Websitedie Live-Site in einem Desktop-Viewport: der Hero-Bereich, wichtige Abschnitte und Scrolling-Aufnahmen der gesamten Seite zum Darüberfahren
Web-App oder SaaSjeden Zustand der Aufgabe, eingeloggt in ein Demo-Konto mit glaubwürdigen Daten
Mobile Appdasselbe, in einem Handy-Viewport, gezeigt innerhalb eines Handy-Rahmens
Physisches Produkt oder Geschäftdie eigenen Fotos und Filmmaterial des Unternehmens; die Produktseite; fragen Sie nach Dateien, wenn die der Site klein sind
Dienstleistungden Buchungs- oder Anmeldevorgang und echte Ergebnisse, die das Unternehmen zeigen darf

Wie. Verwenden Sie einen Headless-Browser (Playwright) gegen die Live-Site oder das lokal in seinem Demo- oder Mock-Modus ausgeführte Produkt mit einem Geräte-Skalierungsfaktor von 3, damit Bildschirme beim Vergrößern scharf bleiben. Erfassen Sie jeden Zustand, den das Drehbuch durchläuft, in der richtigen Reihenfolge, und benennen Sie die Dateien nach Schritt. Wenn Sie keinen Zugriff auf ein eingeloggtes Produkt haben, sagen Sie dies und fragen Sie nach einem Demo-Login oder Screenshots; erfinden Sie die Screenshots nicht.

Das Demo-Konto. Geben Sie ihm die Zahlen der Geschichte, sodass der Bildschirm das sagt, was der Erzähler sagt. Wenn das Produkt Ergebnisse berechnet (Daten, Beträge), verwenden Sie das, was es tatsächlich für diese Eingaben berechnet, selbst wenn die Geschichte mit runderen Zahlen sauberer wäre.

Ändern Sie das Produkt nicht. Wenn die Demo-Daten geändert werden müssen, ändern Sie eine Wegwerf-Kopie des Mock- oder Fixture-Layers und behalten Sie den Diff und das Erfassungsskript im Projekt. Bearbeiten Sie niemals Interface-Code, um ein besseres Bild zu machen, und committen Sie niemals in deren Repository.

Pinnen Sie, was Sie verwenden. Kopieren Sie die Aufnahmen, die der Film verwendet, in assets/screens/. Tools und Wiederholungen überschreiben Arbeitsordner.

Herausgezogene Teile. Der stärkste Weg, einen Bildschirm zu zeigen, ist das Telefon auf einer Seite mit einem Teil dieses Bildschirms (einer Karte, einer Zahl, einem Satz) daneben vergrößert. Erfassen Sie dieses Element separat in hoher Auflösung; ein Ausschnitt des gesamten Bildschirms wird beim Vergrößern unscharf und noch unscharfer in 4K.

Sagen Sie, was nicht live ist. Überprüfen Sie, von welchem Branch oder welcher Umgebung Ihre Aufnahmen stammen. Wenn ein Bildschirm im Film nicht in Produktion ist, schreiben Sie es in REVIEW.md und sagen Sie es der Person.

6. Die Marke

Nehmen Sie Schriftarten und Farben vom Produkt und der Website selbst, nicht aus dem Gedächtnis: Lesen Sie die Schriftarten-Importe und CSS-Variablen der Site und der App. Sie können sich unterscheiden (eine Marketing-Website mit einem anderen Schriftpaar, die App mit einem anderen); fragen Sie, welcher der Film folgen soll, wenn es nicht offensichtlich ist, und lassen Sie Screenshots ihre eigene Typografie behalten. Laden Sie die Schriftartendateien (Google Fonts liefert woff2 pro Subset) in assets/fonts/ herunter und notieren Sie die Lizenz.

Überprüfen Sie, ob die Schriftarten die Glyphen haben, die der Film benötigt: Währungssymbole (₹, €), Pfeile, das Multiplikations- und Minuszeichen. Wo eine Glyphe fehlt, setzen Sie sie in einer Fallback-Schriftart.

7. Der QR-Code

scripts/qr.py erstellt ein SVG mit 30% Fehlerkorrektur, damit ein Logo in der Mitte platziert werden kann. Fügen Sie UTM-Tags an den Link an (utm_source, utm_medium=qr, utm_campaign), damit Besuche vom Film gezählt werden können, und zeigen Sie die kurze Adresse als Text neben dem Code an. Überprüfen Sie, dass die Adresse antwortet, bevor Sie sie verwenden. Nachdem die Endkarte erstellt ist, decodieren Sie den Code aus einem gerenderten Frame mit scripts/scan.py.

8. Credits

Fügen Sie jede Quelle zu CREDITS.md hinzu, sobald Sie sie nehmen: Datei, ID oder URL, Ersteller falls bekannt, Lizenz, wo sie verwendet wird. Tun Sie es im Moment des Downloads; eine spätere Rekonstruktion kostet mehr und übersieht Dinge.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills