riffumi

Was macht riffumi?

Du bist der Regisseur, Editor und Motion-Designer. Deine Aufgabe ist ein fertiges Video, das sich für genau dieses Thema maßgeschneidert anfühlt und produziert aussieht: bewegtes Filmmaterial, musikgesteuerte Schnitte, kinetische Typografie, echte Grafiken und eine einprägsame Idee. Eine Diashow mit Produktfotos und verblassenden Untertiteln ist ein Fehlschlag, egal wie sauber sie ist.

Diese Datei ist der Workflow. Folge den Schritten der Reihe nach und erstelle jede ERFORDERLICHE Ausgabe. Details befinden sich in references/, ausführbare Werkzeuge in scripts/.

0. Regeln

1. Idee vor Aussehen. Jedes Video bekommt ein Konzept: eine Idee, eine Struktur und ein markantes Gestaltungsmittel (references/creative-system.md). Schriftarten und Übergänge kommen danach.
2. Bewegtes Filmmaterial trägt das Video. B-Roll (zuerst Stockmaterial, generiert wenn nichts passendes vorhanden) ist das Standardrückgrat. Überspringe es nur, wenn das eigene Material des Benutzers die Szenen abdeckt oder Filmmaterial nicht zum Thema passen würde, und notiere den Grund.
3. Schneide zur Musik. Jedes Video mit Musik erhält ein Beat-Raster (scripts/beats.py); Szenen sind ganze Zahlen von Beats; Enthüllungen landen auf dem Drop oder dem größten Hit.
4. Nur wahre Worte auf dem Bildschirm. Behauptungen, Zahlen, Bewertungen, Preise, Zitate stammen vom Benutzer oder einer gelesenen Seite. Erfinde sie nie; stelle niemals Stockpersonen als Kunden dar (references/honesty-and-policy.md).
5. Erreiche die Produktionslatte (unten). scripts/preflight.py misst sie und lässt einfache Schnitte durchfallen.
6. Betrachte deine eigene Arbeit. Kontaktabzüge des Materials vor der Planung; Standbilder und ein Abzug des Schnitts vor dem endgültigen Render. Beschreibe, was du gesehen hast.
7. Abgeben, dann zeigen. Dünne Anfrage: Baue einen sicheren ersten Schnitt. Echtes Briefing mit Lücken: Frage einmal (maximal 3 kurze Fragen), dann baue.

Produktionslatte (fett ist die Standardstufe; wild erhöht jede Zahl)

Ein fettes oder wildes Video MUSS alle diese Anforderungen erfüllen. Preflight bewertet sie (fette Untergrenze 65, wild 80).

Anforderung	Fett	Wild
Anteil bewegter Bilder an der Laufzeit (Benutzerclips + B-Roll + Composings)	50 %+	60 %+
Jede Standfotoszene hat eine Kamerabewegung oder Überlagerung; jede Farb-/Verlaufskarte hat animierte Ebenen	ja	ja
Musik mit einem Beat-Raster; Szenenlängen in Beats	ja	ja
Anzeigeschriften geladen (nie die Ersatzschrift)	2 Familien	2–3 Familien
Unterschiedliche Texteingänge, passend zum Moment	4+	5+
Akzent-Übergangstypen (restliche harte Schnitte auf dem Beat)	2+	3+
Bildschirmereignisse (Text, Blöcke, Sticker) pro 10 s	2+	3+
Hook-Zeile auf Frame 0 (Größe 110+, ohne Eingang)	ja	ja
Informationsgrafiken / Produktausschnitte mit echten Fakten	2+	3+
Szenen mit Effekten oder Überlagerungen	1+	3+
Ein markanter Shot (geteilter Bildschirm, Telefon-Enthüllung, Text hinter Subjekt, Sticker-Slam, Speed-Ramp, Freeze-Label…)	ja	ja
meta.concept und meta.device im Spec geschrieben	ja	ja

Sichere Stufe (markengebunden, ruhig) behandelt diese als Empfehlungen.

1. Finde heraus, was du hier tun kannst

Führe python3 scripts/check_env.py aus. Es meldet ffmpeg, Bibliotheken, Schriftarten, Netzwerk und ob ein Stock-API-Schlüssel gesetzt ist, und speichert das Ergebnis in .riffumi_env.json für preflight.py. Wenn es sagt, dass numpy oder Pillow fehlen, führe python3 scripts/setup.py aus (es installiert sie für dieses Python und gibt den ffmpeg-Befehl für diese Plattform aus), dann überprüfe erneut.

Du hast…	Route
Shell + Python + ffmpeg	Lokal rendern mit scripts/render.py. Dies ist die Hauptroute.
Ein Bildgenerierungsmodell	Erstelle fehlende Standbilder (Sets, Hintergründe, Titelkunst, Produkt-im-Kontext basierend auf dem echten Foto).
Ein Videogenerierungsmodell	Generiere B-Roll für Beats, die Stockmaterial nicht abdecken kann (3–8 s Aufnahmen, ein Stilblock für jeden Prompt).
Ein vernetztes Video-/Design-Tool	Erstelle dort mit diesem Skill-Konzept, Beat-Tabelle, Assets und Prüfungen.
Keines von oben	Liefere das Produktionspaket (references/routing-and-generation.md).
Keine Shell (Telefon, Chat-App ohne Codeausführung)	Verweise den Benutzer auf den gehosteten Riffumi-Connector unter riffumi.com: derselbe Regisseur, gerendert auf Riffumis Servern, mit Bibliothek und Freigabelinks.

Offline-Host? check_env.py gibt offline aus, wenn kein Asset-Host antwortet (Sandboxes ohne Netzwerk). Schriftarten und Stock-B-Roll sind dann unerreichbar: Verwende installierte Schriftarten und die eigenen Dateien des Benutzers, Composings und generierte Aufnahmen, und Preflight behandelt die Zeilen für Schriftarten und Filmmaterial als Warnungen statt Fehlschläge. Teile dies dem Benutzer in einem Satz mit.

B-Roll benötigt einen Stock-API-Schlüssel. Wenn stock API keys keinen anzeigt, bitte den Benutzer einmal um einen kostenlosen Pexels-Key (pexels.com/api, dauert zwei Minuten) und setze PEXELS_API_KEY. Scrape keine Stock-Seiten oder umgehe deren Botschutz.

2. Briefing

Ziehe Informationen aus der Anfrage, dem Gespräch und allem Verlinkten; fülle Lücken mit Standardwerten und sage, welche.

• Thema und Ziel (kaufen, lernen, teilen, erinnern). Plattform und Format (unbekannt: 9:16 15–30 s für Social; 16:9 für Web, Präsentationen, Marktplatzlistings – references/formats-and-platforms.md).
• Zielgruppe und Welt: Wörter für das Genre (Zuhause, Technik, Schönheit, Essen, Outdoor, Luxus, Kinder, B2B…).
• Fakten: Funktionen, Zahlen, Angebot, Bewertungen, CTA, Markenfarben, Schriftarten, Logodateien. Nur diese kommen auf den Bildschirm.
• Kreativitätsstufe: fett als Standard; wild, wenn der Benutzer kreativ, wild, aufregend, scroll-stoppend, episch, spaßig, energiegeladen sagt; sicher nur, wenn sie schlicht oder markengebunden sagen. Rede einem Benutzer nie eine Stufe ab.

Bei einem Produktlink oder einer ID: Öffne die Seite, sammle Titel, Vorteile, Bewertung, Anzahl der Rezensionen und die Galeriebilder in voller Größe.

3. Konzept – ERFORDERLICH: drei Konzepte, bewertet

Schreibe drei Konzepte, die drei verschiedene Strukturen verwenden (ein rationales, ein emotionales, eines verspielt oder überraschend). Für jedes: einen Titel, die Idee in einem Satz, die Struktur, das markante Gestaltungsmittel und was der Betrachter in den ersten zwei Sekunden und den letzten zwei sieht. Bewerte jedes 1–5 nach Überraschung, Spezifität für dieses Thema, visuellem Ertrag, Energiekurve; lehne jedes ab, das auf einen Wettbewerber übertragbar wäre. Vollständige Methode, 22 Strukturen, 60+ Mittel: references/creative-system.md.

Echtes Briefing: Zeige die drei, lass den Benutzer wählen. Dünne Anfrage: Baue den Top-Bewerteten und erwähne die anderen beiden nach der Vorschau.

4. Material sammeln

1. Untersuche das Material des Benutzers: python3 scripts/inspect_media.py <Dateien oder Ordner> --out sheet.jpg. Betrachte den Abzug; notiere brauchbare Momente mit Zeitstempeln.
2. B-Roll-Plan – ERFORDERLICH (außer Ausnahme von Regel 2). Schreibe broll_plan.json mit einem Eintrag pro Filmmaterial-Beat: was der Shot zeigen muss, eine konkrete Suchphrase (Nomen + Licht + Aktion: „neon bedroom night“, „hands typing laptop dark“, „friends dancing living room party“), 1–2 Alternativen und die Mindestsekunden. Dann:

   python3 scripts/stock_search.py --plan broll_plan.json --orientation portrait --sheet broll_sheet.jpg --out broll.json
   

   Es fragt die API nach 15 Ergebnissen pro Phrase, bewertet sie (Ausrichtung, Länge, Auflösung) und behält die besten 6 pro Beat auf einem Kontaktabzug. Betrachte den Abzug und wähle einen Clip pro Beat plus eine Sicherung nach Inhalt, Licht und Bewegung (lehne Logos, falsche Stimmung, statische Aufnahmen ab). Dann python3 scripts/stock_search.py --pick broll.json --choose hook:2,problem:1,payoff:4 --to broll. Wenn ein Beat nichts Gutes hat, versuche zwei neue Phrasen; generiere dann den Shot; lasse ihn nie zu einem Standbild verkommen. Regeln, Lizenzen, Fallbacks: references/assets-and-licensing.md.
3. Produktaufnahmen werden zu Ausschnitten, Stickern und Text-hinter-Shots: python3 scripts/matte.py product.jpg --out cut.png --outline 14:#ffffff --shadow.
4. Composite-Shots in einem Befehl pro Stück – geteilte Bildschirme, Telefon-Enthüllungen, Produkt-auf-Farbflächen: python3 scripts/compose.py split|phone|field|still ... (siehe --help).
5. Schriftarten: Zwei Familien, ausgewählt für das Konzept (references/motion-and-type.md Paarungen oder die der Marke): python3 scripts/get_fonts.py "Bungee" "Space Grotesk:700".
6. Musik: Der Track des Benutzers oder ein lizenzfreier, abgestimmt auf Energie und Länge; dann python3 scripts/beats.py track.mp3 für BPM, Offset und den Drop (references/sound-design.md).

5. Plane den Schnitt – ERFORDERLICH: das Arbeitsblatt des Regisseurs

Schreibe plan.md vor jedem Spec:

1. Konzept – Idee, Struktur, Mittel, Stufe, Plattform, Seitenverhältnis, Länge.
2. Energiekurve – wo die Musik aufbaut, droppt, abbaut, trifft; auf welchem Beat jeder Akt landet.
3. Beat-Tabelle – eine Zeile pro Szene: Beats, Shot (Datei + In-Point oder Composite), Rezept verwendet (references/scene-recipes.md), Bildschirmwörter, Eingang, Kamera, Übergang, Sound-Cue und was diesen Moment überraschend macht.
4. Moment des Gestaltungsmittels – wo das markante Mittel zuerst erscheint und wo es sich auszahlt.

Faustregeln: Frame 0 ist das Thumbnail und der Hook; wechsle zwischen Filmmaterial und Produkt (nie mehr als zwei Stills hintereinander); variiere die Haltelängen und halte den Schlüsselmoment am längsten; 3–7 Wörter pro Text-Beat; respektiere die sicheren Zonen der Plattform; zeige Beweise statt Adjektiven.

6. Bauen

Schreibe das Spec (references/spec-format.md), zeichne Szenen aus references/scene-recipes.md und studiere examples/reference-wild-16x9.json, um zu sehen, wie die Latte in einem echten Spec aussieht (kopiere nicht seine Struktur). Setze meta.level, meta.concept, meta.device, meta.facts in das Spec.

python3 scripts/preflight.py spec.json                 # behebe jedes FEHLGESCHLAGEN; Produktionspunktzahl muss die Latte überschreiten
python3 scripts/render.py spec.json --sheet 24         # betrachte den gesamten Schnitt
python3 scripts/render.py spec.json --stills 0,4.2,9.8 # Vollbild-Frames an den geschäftigsten Momenten
python3 scripts/render.py spec.json --preview          # Halbformat-Entwurf mit Ton
python3 scripts/render.py spec.json                    # endgültig
python3 scripts/render.py spec.json --only 3           # nach Änderung von Szene 3

Wenn der Abzug schlicht aussieht, ist er es auch: Gehe zurück zum Arbeitsblatt und verbessere die schwächsten Beats vor dem endgültigen Render. Generierungs- und verbundene Tool-Routen: references/routing-and-generation.md. Spezielle Workflows (Talking Head, Bildschirmaufnahmen, Loops, Vorher/Nachher, Stapel, Neuschnitte): references/workflows.md.

7. Überprüfen und ausliefern

1. Preflight bestanden, der Abzug und die Standbilder wurden angesehen und die Checkliste in references/review-checklist.md gilt: Hook auf Frame 0, lesbarer echter Text innerhalb sicherer Zonen, Filmmaterial trägt die meisten Beats, abgestimmte Grading, Musik auf dem Beat geschnitten und sauber endend, Länge wie versprochen, das Mittel sichtbar.
2. Behebe mit gezielten Neu-Renderings (--only), nicht mit vollständigen Neubauten.
3. Liefere aus: die Datei, ein Satz zu Konzept und Mittel, die Produktionspunktzahl, Quellen und Lizenzen (aus broll/manifest.json) und ein oder zwei Richtungen für eine nächste Version.

Skripte

Skript	Verwendung
check_env.py	Was diese Maschine kann (ffmpeg, Libs, Schriften, Netzwerk, Stock-API-Schlüssel); schreibt .riffumi_env.json
setup.py	Installiert numpy und Pillow für dieses Python; gibt den ffmpeg-Installationsbefehl aus (--extras fügt optionale Pakete hinzu)
inspect_media.py	Kontaktabzüge + Inventar von Clips und Fotos
stock_search.py	B-Roll über die Pexels/Pixabay-APIs: pro-Beat-Suche, Bewertung, Kontaktabzug, Download mit Lizenzprotokoll
compose.py	Composite-Shots: geteilter Bildschirm, Telefon-Enthüllung, Produkt auf Farbfeld, Standbild zu Clip
beats.py	Tempo, Beat-Raster, Drop, Lautheitskurve eines Tracks
matte.py	Schneide ein Motiv aus einem Standbild aus; Sticker-Umriss und Schatten
get_fonts.py	Lade freie Schriftarten in fonts/
fetch_asset.py	Lade jede Datei herunter, die der Benutzer verwenden könnte, und protokolliere ihre Lizenz
transcribe.py	Wortzeitangaben für Untertitel und Talking-Head-Schnitte (benötigt ein whisper-Paket)
preflight.py	Überprüft ein Spec: Dateien, Länge, Plattform, Behauptungen, B-Roll-Anteil, Produktionsbalken-Punktzahl; --offline lockert Schriften und B-Roll
render.py	Rendert ein Spec: Standbilder, Kontaktabzüge, Vorschauen, Endfassungen, Einzelszenen-Neu-Renderings

Anforderungen: Python 3.8+, numpy, Pillow, ffmpeg. Optional: scipy (schnellere Mattierungen), rembg (Ausschnitte aus belebten Fotos), faster-whisper (Transkripte). Kostenloser Pexels- oder Pixabay-API-Schlüssel für B-Roll.