Redaktionelle Bewegtgrafik (Remotion)
Verwandelt die Geschichte eines Experiments, Tests oder einer Idee in ein 15–30 Sekunden langes Video, das im Wesentlichen aus Zahlen und Text besteht. Das Erscheinungsbild ist festgelegt und sorgfältig: elegante Serifen-Überschrift + kursives Hervorhebungswort (himmelblau), eng gesetzte Mono-Großbuchstaben-Label, fette groteske Zahlen; ein durchgehender dünner Rahmen (Marke oben links, „01 — KAPITEL“ oben rechts, unterteilter Fortschrittsbalken + Zeit unten), ein leichtes Raster im Hintergrund, Randabdunkelung, feines Korn. Du schreibst die Geschichte als JSON, die Darstellung wird daraus generiert.
Wenn Zeichnungen, Charaktere oder handgemachte Szenen benötigt werden, ist dies nicht der richtige Skill – dafür gibt es das Skill animation (PIL-Tinte).
Beispiel: ornekler/x-animasyon/ornek.json („Ich habe dieselbe Aufgabe mit drei verschiedenen Einstellungen ausgeführt“; die Zahlen sind erfundene Demodaten, auf dem Bildschirm erscheint „Beispieldaten“).
Installation (einmalig)
cd remotion && npm install # Node 18+; der Ordner fontlar/ wird automatisch nach public/fonts kopiert
Beim ersten Rendern wird Chrome Headless Shell heruntergeladen (~100 MB). Python-Seite: numpy, Pillow, ffmpeg.
Verwende in den Befehlen .venv/bin/python für Python (Windows: .venv\Scripts\python).
Ablauf
1. Verstehe die Geschichte
Was ist die einzeilige Behauptung? Welche Zahlen gibt es und woher kommen sie? Plattform und Seitenverhältnis (X: 16:9, Reels/Shorts: 9:16, beides möglich), Dauer (X 15–30 Sek.). Wenn es keine Zahlen gibt, erfinde sie nicht: Fordere entweder gemessene Zahlen vom Benutzer an oder verwende Szenen ohne Zahlen (Titel, Liste, Frage).
2. Schreibe die Szenenliste: calisma/x-animasyon/<name>.json
Kopiere aus dem Beispiel. Regeln:
- Jede Szene enthält eine einzige Idee, 3–7 Wörter pro Zeile, natürliches und einfaches Deutsch. Lange Sätze stattdessen auf zwei Zeilen aufteilen.
*wort*= Hervorhebung (kursiv in Serife + blau). Höchstens eine Hervorhebung pro Szene.- Zahlen dürfen nur gemessen sein. Wenn du ungemessene/Beispielzahlen verwendest, belasse auf oberster Ebene
"etiket": "örnek veri"und teile dies dem Benutzer mit. - Im Deutschen steht das Prozentzeichen hinter dem Wert:
"onek": "%"→80%. Bei Geld- und Zeitvergleichen gib vorbereiteten Text an:"0,61 €","5 Min 12 Sek". bolumöffnet einen neuen Abschnitt (oben rechts Label + Teil des Fortschrittsbalkens); 3–5 Abschnitte sind ausreichend.- Status-Badges wie „wartet“, „demnächst“ sowie Notizen an dich selbst; jeder Text auf dem Bildschirm ist für das Publikum bestimmt.
tur | Felder | Wofür | Empfohlene Dauer (Sek.) |
|---|---|---|---|
baslik | ust?, satirlar | Haken: erste 2–3 Sek. | 2,4–3 |
yazi | satirlar?, ust?, metin (≤160) | Eingabeaufforderung/Befehl wird Buchstabe für Buchstabe geschrieben, mit Tastaturgeräusch | 0,55 + Buchstabe × 0,09 + 0,9 |
sayac | ust?, deger, baslangic?, ondalik?, onek?, sonek?, alt? | Einzige große Zahl, die herunterzählt | 3 |
olcer | satirlar, seviyeler[2-6] (ad, etiket?) | Konzeptuelle Stufe: von niedrig nach hoch nacheinander gefüllt | 3–4 |
sutunlar | satirlar, ogeler[2-6] (ad, deger, etiket?), onek/sonek/ondalik?, not? | Gemessene Ergebnisse, automatischer Reihenfolgenlabel | 4–4,5 |
karsilastirma | satirlar (einzeilig), a, b (ad, ust?, deger, altEtiket?, alt?), fark? (deger, etiket?, alt?) | A vs. B: Kosten, Zeit | 4–5 |
liste | satirlar, ogeler[2-5] | Schlussfolgerung, Regel, Schritt | 1,6 + 0,5 × Punkt |
soru | satirlar, alt? | Abschlussfrage / Aufruf | 3 |
In jeder Szene ist sure (Dauer in Sek.) erforderlich, bolum optional. Obere Ebene: marka (Name oben links), etiket?, tema?, sahneler. Schema: remotion/src/x/sema.ts.
3. Entwurf (schneller Überblick)
.venv/bin/python .claude/skills/x-animasyon/araclar/uret.py calisma/x-animasyon/<name>.json --oran ikisi --taslak
Erzeugt einen halbhohen, stummen Render + eine Themenseite (<name>-<oran>-taslak-sessiz-sayfa.jpg). Öffne die Seite und schau sie dir an: überlaufende Zeilen, überlappende Elemente, unlesbare Labels, große leere Flächen. Korrigiere und erstelle einen neuen Entwurf. Für Live-Bearbeitung: cd remotion && npx remotion studio.
4. Rendern + Ton
.venv/bin/python .claude/skills/x-animasyon/araclar/uret.py calisma/x-animasyon/<name>.json --oran ikisi
Ausgaben in calisma/x-animasyon/: <name>-16x9.mp4 (1920×1080, 60 fps) und <name>-9x16.mp4 (1080×1920, 30 fps), mit Ton. Die Standardlautstärke beträgt -26 LUFS: deutlich unter dem Niveau von Sprache (-14..-16), so dass eine nachträgliche Sprachaufnahme oder ein Sprecherkopf die Tonspur nicht übersteuert. Wenn das Video separat versendet wird, verwende --lufs -18; falls kein Hintergrundmusik gewünscht ist, --muziksiz.
Schritt für Schritt (gleicher Effekt):
cd remotion && npx remotion render XAnimasyon16x9 ../calisma/x-animasyon/<name>-16x9-sessiz.mp4 \
--props=../calisma/x-animasyon/<name>.json --muted && cd ..
.venv/bin/python .claude/skills/x-animasyon/araclar/ses.py calisma/x-animasyon/<name>.json \
--video calisma/x-animasyon/<name>-16x9-sessiz.mp4 --cikti calisma/x-animasyon/<name>-16x9.mp4
5. Prüfen – du kannst nicht zuschauen, nicht zuhören
uret.py führt am Ende olc.py aus (manuell: olc.py <mp4> --json <json>):
- Sind Framecount und Dauer identisch mit den Erwartungen aus dem JSON? Haben Audio und Video die gleiche Länge?
- Themenseite: zwei Frames aus jeder Szene (Mitte und kurz vor Ende) – unbedingt öffnen und ansehen.
- Integrierter LUFS und True Peak; wie viele dB liegt der Whoosh pro Schnitt über der Hintergrundmusik (Warnung bei 2 dB darunter)? Bei Schnitten unmittelbar nach einer Schreibszene ist der Unterschied gering: das liegt an den Tastaturgeräuschen im vorherigen Fenster, das ist normal.
Was du nicht messen kannst (ob die Musik angenehm ist, ob der Rhythmus stimmt), musst du explizit dem Benutzer überlassen.
6. Ablieferung
Dateipfade, Dauer, Renderzeit und Messzusammenfassung. Wenn Beispieldaten verwendet wurden, muss dies erneut erwähnt werden.
Erscheinungsbild anpassen
- Farbe: Im JSON:
"tema": {"vurgu": "#38bdf8", "zemin": "#111113", "yazi": "#ece7df", "soluk": "#8b8883", "seri": [...]}. Es bleibt bei einer einzigen Hervorhebungsfarbe;seriFarben für Messbalken/Säulendiagramme. Standardwerte inremotion/src/x/parcalar.tsx. - Marke:
"marka"oben links (Name des Kanals oder der Serie). - Schriftart: Nur frei verteilbare Schriftarten (wie OFL). Lege die TTF und den Lizenztext in
fontlar/ab, füge sie zur Liste inremotion/scripts/fontlari-kopyala.mjsund zuYUZLERinremotion/src/x/fontlar.tshinzu, führe dannnpm run fontlaraus. Betriebssystem-Schriftarten (macOS/Windows-Systemschriften) werden nicht ins Repository aufgenommen und können nicht verteilt werden. - Layout: Zwei Ausrichtungen in
useDuzen()(parcalar.tsx). Im Hochformat liegt der Inhalt zwischen y 300–1320: Reels/Shorts bedecken oben ~190 px, unten ~520 px und die untere rechte Ecke. - Neuer Szenentyp: Füge das Schema in
sema.tshinzu, die Komponente insahneler.tsx, einen Zweig inSahneCiz, den Namen inuret.pyTURLER. Wenn die Szene ein szeneninternes Geräusch (wie Tastatur) benötigt, berechne dessen Zeit mitzaman.tsinaraclar/ortak.pymit der GLEICHEN Formel.
Fallstricke (gemessen)
- Zeit als einzige Quelle:
remotion/src/x/zaman.tsundaraclar/ortak.pyverwenden dieselbe Berechnung (Framegrenzung, Schreibrhythmus). Wenn du eine änderst und die andere vergisst, verschiebt sich der Whoosh-Schnitt oder das Tastaturgeräusch vom Buchstaben. - Kompositions-ID hat keinen Unterstrich;
--propserwartet einen Dateipfad, kein eingebettetes JSON. - Schriftarten werden über die FontFace-API geladen; auf
document.fonts.readywird nicht gewartet (wurde bei langen Renderings in einem Tab nie aufgelöst beobachtet). Wenn eine Schriftart nicht geladen werden kann, bricht das Rendern mit einem Fehler ab und fällt nicht stillschweigend auf eine Ersatzschriftart zurück. - Das Korn wird nicht in jedem Frame per SVG
feTurbulenceberechnet (blockiert das Rendern), sondern ein einmal erzeugtes Rauschtile wird verschoben. - Türkische Großbuchstaben werden per CSS (
lang="tr"+text-transform) korrekt dargestellt (İ/ı). Verwende nichttoUpperCase()in JS. - Gib keinen Zoom-/Pop-Effekt auf Text (das zittert). Eingang = Anheben aus einer Maske + Transparenz.
- Wenn lange 60-fps-Renderings hängen, teile sie in Teile auf wie
--frames=0-899und füge sie mit ffmpeg concat zusammen. - Gemessene Renderzeit (M1 Pro, 16 GB, Standardparallelität): 27,4 Sek. Beispielvideo 16:9@60 ~67 Sek., 9:16@30 ~40 Sek.; Entwurf (halbe Höhe) 33 / 18 Sek.
Lizenzhinweis: Remotion
Remotion ist nicht MIT-lizenziert. Für Einzelpersonen und kleine Unternehmen ist es kostenlos; Unternehmen ab einer bestimmten Größe müssen eine kostenpflichtige Lizenz erwerben. Überprüfe vor der Nutzung die aktuellen Bedingungen: https://www.remotion.dev/license – der Code in diesem Repository ist MIT, aber Remotion selbst unterliegt seiner eigenen Lizenz.