Remotion mit professionellem Finish
Diese Skill kümmert sich nicht darum, was erzählt wird oder wie es aussieht – sie sorgt dafür, dass das Endergebnis sauber ist. Fast alle Mängel, die ein Kunde bemerkt („Abriss im Hintergrund“, „komische Halos“, „der Text zittert“, „klingt wie ein YouTube-Tutorial“) haben fünf Ursachen: Das Timing, der 8-Bit-Browser, die Komprimierung, das Audio und die Tatsache, dass das Ergebnis nicht wirklich angesehen wurde.
Referenzen (lies sie, wenn du an den entsprechenden Teilen arbeitest):
- reference/motion.md: Tempogitter, Kurven, Kamera, Lesbarkeit, Übergänge.
- reference/image.md: Banding, Glanzlichter, Schatten, Hintergründe, Farbe, warum Chrome versagt.
- reference/blur.md: Bewegungsunschärfe durch gemittelte Einzelbilder außerhalb des Browsers.
- reference/audio.md: Effekte, Musik, Ducking und Mastering auf −14 LUFS.
- reference/delivery.md: Master, Web-MP4 nach Größe, WebM, Standbild und Kontaktabzug.
Voraussetzungen
Node 18+ mit Remotion 4, ffmpeg mit libx264, libvpx-vp9 und libopus, ImageMagick 7 (magick) und Python 3 mit numpy, scipy, soundfile und pillow. Skripte sind unter Linux getestet und auch für macOS ausgelegt (bash 3.2, ohne df, nproc oder mktemp -p).
Bausteine
Kopiere sie in dein Projekt und passe sie an. <skill> ist das Verzeichnis dieser Skill.
| Baustein | Wofür |
|---|---|
templates/beat.ts | fps, Tempo, PER_BEAT, CHAPTERS und TOTAL: die Zeit des Videos an einem Ort |
templates/Main.tsx, templates/Root.tsx | Grundgerüst mit einem Sequence pro Kapitel und den beiden Kompositionen (normal und für Einzelbilder) |
templates/motion.ts | Kurven, ease, mix, keys, sample (Tabellen ohne Rundung), integrate, typed, seeded |
templates/Typed.tsx | Getippter Text, der nicht nachrutscht |
templates/Subframes.tsx | Die Komposition mit 24 Einzelbildern pro Frame für die Unschärfe |
templates/Halo.tsx | Glanzlicht, das Licht hinzufügt, ohne dunklen Hof |
templates/Sfx.tsx | <Sfx at name />, <Typing /> und <Words /> framegenau synchronisiert |
scripts/sfx.py | Bibliothek für synthetisierte Effekte → public/sfx/*.wav |
scripts/glow.py | Halo mit Dithering → public/textures/glow.png |
scripts/blur.sh | Master mit Bewegungsunschärfe, gemittelt außerhalb von Chrome |
scripts/deliver.sh | Audio auf −14 LUFS, Web-MP4 nach Größe, WebM, Standbild und Kontaktabzug |
scripts/master.py | Audiomastering (wird von deliver.sh verwendet) |
scripts/qa.sh, scripts/bgcheck.py | Prüfbögen und Hintergrundmessung |
Typischer Start:
npx create-video@latest # oder ein bestehendes Remotion-Projekt
cp <skill>/templates/*.ts* src/ # Root.tsx ersetzt die Vorlagenversion
mkdir -p scripts && cp <skill>/scripts/* scripts/
python3 scripts/sfx.py public/sfx
python3 scripts/glow.py public/textures/glow.png --color 133,149,191
Arbeitsablauf
- Briefing und Storyboard in Zeit. Dauer, Format, fps (Standard 30), Musik-Tempo und Kapitel in Frames, die auf Zeiten fallen (
beat.ts). Schreibe das Storyboard in einer.md-Datei und halte es aktuell: Nur so kannst du etwas ändern, ohne den Rest zu beschädigen. - Kapitelweise aufbauen, jedes Kapitel eine eigene Komponente mit lokalen Frames. Keine losen Zeiten: benannte Konstanten (
MAIL_IN,fillAt(i),STAMP), die voneinander abgeleitet sind. - Entwürfe ohne Unschärfe für schnelle Iteration. Rendere nur den veränderten Abschnitt (
--frames=a-b) und zeige ihn dem Nutzer; das gesamte Video erst am Ende einer Runde. - Prüfung mit eigenen Augen, bevor du etwas zeigst (siehe „Wirklich hinsehen“).
- Master mit
scripts/blur.shund Liefergegenstände mitscripts/deliver.sh. Endkontrolle anhand der komprimierten Datei, nicht des Renders.
Design-Feedback: Bei konzeptionellen Fragen schlage erst etwas vor, bevor du loslegst; technische Korrekturen wende ohne Nachfrage an. Wenn eine Idee nicht zweimal überzeugt, biete Alternativen mit Vorschau an, statt eine dritte Variante blind zu erstellen. Zeige jeden geänderten Teil isoliert; mache nichts neu, was bereits gefallen hat.
Finish-Regeln (die am häufigsten gebrochen werden)
Zeit
- Alles ist eine reine Funktion von
frameund akzeptiert gebrochene Frames. KeinMath.roundund keine ganzzahligen Tabellen in Positionen oder Kameras (sample()interpoliert). Die Unschärfe tastet Zwischenbilder ab; wenn die Zeit gerundet wird, entstehen Doppelgänger. - Schnitte, Wort-Einblendungen, Schläge und Akzente auf dem Tempogitter. Synchronisieren ist nicht „pulsieren“: Nichts sollte mit der Musik mitwippen.
- Immer nur eine Sache zum Lesen. Mindestens ~1,2 s für eine Überschrift und ~0,4 s pro zusätzlichem Wort. Wenn sich die Kamera bewegt, stoppt sie im Moment des Lesens.
Layout
- Text, der getippt oder größer wird, darf nicht nachrutschen: Reserviere seine Breite (
Typed). Ein zentrierter Text, der Buchstabe für Buchstabe neu zentriert wird, erscheint bei Unschärfe doppelt. - Nichts verdeckt das, was gelesen werden muss: Überprüfe Überlappungen in den Einblende-, Ausblende- und Kreuzungs-Frames, nicht nur im Ruhezustand.
- Lesbar bei der tatsächlichen Anzeigebreite (z. B. 900 px im Web: ein 1080p-Video wird mit 47 % gesehen). Wichtiger Text ≥ 24 px bei 1080p; 18–20 px nur für Beschriftungen.
Kamera und Bewegung
- Damit „die Kamera fährt“ und nicht die Objekte: Feste Welt und eine Kamera, die sich bewegt; jedes Element wird entsprechend seiner Tiefe projiziert. Nahes bewegt sich mehr: das ist Parallaxe.
- Kurven mit Absicht (schnelles Herauszoomen für Einblendungen, In-Out für Fahrten, Beschleunigung für Ausblendungen). Nichts Linear außer Tippen und Scans.
Bild (Chrome malt mit 8 Bit)
- Keine breiten Farbverläufe mit wenigen Stufen auf Dunklem (Vignetten, lange schwarze Schatten, riesige Halos): Sie brechen in Streifen und die Komprimierung verwandelt sie in Klötze. Einfache Hintergründe; kurze Schatten auf Dunklem.
- Große Halos: Bild mit Dithering (
glow.py), nichtfilter: blur(). Licht-Highlights mitmix-blend-mode: plus-lighter(Halo), das keinen dunklen Hof hinterlässt. - Niemals Unschärfe innerhalb des Browsers für den Master (
CameraMotionBluroder Ebenen mit Deckkraft): Sie färbt Dunkles ein und verschiebt den Hintergrund bereichsweise. Siehe reference/blur.md. - Bilder mit
<Img>von Remotion (wartet auf das Laden); niemalsbackground-imagein CSS. - Eigene SVG-Logos: Überprüfe sie vergrößert; ein gedrehter Pfad kann mit seiner Füllung nicht übereinstimmen.
Farbe und Ausgabe
- BT.709 im Render markieren (
--color-space=bt709) und bei jedemffmpeg. Ohne Markierung interpretiert jeder Player die Farbe anders. - Master fast verlustfrei und nur eine starke Komprimierung bis zum Liefergegenstand. Das Web-MP4 in zwei Durchläufen mit der gewünschten Größe,
aq-mode=3für mehr Bits in dunklen Bereichen.
Audio
- Ein Effekt pro visuellem Ereignis, framegenau. Tastatur, Wörter, Klicks und Sweeps unterscheidbar voneinander. Sweeps und Glanzlichter mit Tiefpass (~3 kHz): sonst klingen sie schrill.
- Musik begleitet: 8–12 dB unter den Effekten und mit Ducking dort, wo getippt oder gelesen wird.
- −14 LUFS integriert und −1 dBTP gemessen am finalen AAC.
Wirklich hinsehen
Ein schöner Einzelbild im Studio beweist nichts. Bevor du ein Ergebnis zeigst:
- Kontaktabzug (
scripts/qa.sh sheet video.jpg sheet.jpg f1 f2 …): Komposition, Überlappungen, abgeschnittener Text, leere Momente. - Übergangs-Frames, nicht nur Ruhebilder: Mitte jeder Einblendung, jedes Ausblendens und jedes Sweeps. Hier tauchen Stufenkopien, doppelter Text und Überlappungen auf.
- Übersteigerter Kontrast auf Dunklem (
scripts/qa.sh boost …, Pegel 0–30 %): Zeigt Streifen, Rechtecke, Farbstiche und Klötze, die auf einem guten Monitor oder im Dunkeln sichtbar sind. - Hintergrund messen mit
scripts/bgcheck.py: ohne Referenz die Streuung des einfarbigen Hintergrunds; mit--ref, was die Komprimierung hinzugefügt hat. Referenz: der Master bei Bewegung (gleiche Unschärfe), einremotion stillnur bei Standbildern. Gut: ≤ 0,6 Stufen; zwischen 0,6 und 0,8 sieh dir die Überhöhung an (meist eine unsichtbare halbe Stufe); die Browser-Unschärfe ergab ~1 und war sichtbar. - Unkomprimiert vs. komprimiert am selben Frame: Ist der Fehler in beiden, liegt es am Design oder am Render; nur im Komprimierten, am Encoder. Die Behebung ist unterschiedlich.
Dekodiere immer mit scale=in_color_matrix=bt709; sonst siehst du nicht vorhandene Farbstiche.
Umgebungsfallen
- Lange Render im Hintergrund und vorher den Speicherplatz prüfen (
blur.shmacht das)./tmpkann im RAM liegen: Das temporäre Verzeichnis von Remotion liegt dort, woTMPDIRhinzeigt. ProRes HQ 1080p ≈ 170 KB pro Einzelbild, und das finale Zusammenfügen erstellt eine Kopie. - Um die endgültige Unschärfe in einem Abschnitt zu prüfen, ohne alles zu rendern:
RANGE=a-b scripts/blur.sh …. remotion renderin H.264 unterstützt kein--crf=0; für verlustfreie Zwischenschritte ProRes oder PNG.- Um einen Render zu stoppen:
pkill -f "[r]emotion render"(die eckigen Klammern verhindern, dass deine eigene Shell getötet wird). - Bei Einzelbildern darf keine Komponente
fpsvonuseVideoConfig()lesen: Es würdeFPS·SUBgelten. - Zahlen im Video: Überprüfe sie (Summen, Gesamtbeträge) vor dem finalen Render. Eine falsch addierte Summe in einem Werbevideo ist schlimmer als jedes Banding.
Abgabeliste
- Kontaktabzug und Übergangs-Frames geprüft; nichts überdeckt nichts; nichts rutscht nach.
- Dunkle Hintergründe ohne Rechtecke, Farbstiche oder Klötze im finalen MP4 (Überhöhung +
bgcheck). - Unschärfe kontinuierlich bei den schnellsten Bewegungen, ohne Stufenkopien.
- Text in tatsächlicher Breite lesbar; jede Lesephase mit ausreichend Zeit.
- Audio bei −14 LUFS ±0,5 und Spitze ≤ −1 dBTP; Effekte unterscheidbar; Musik darunter.
- BT.709 in MP4 und WebM markiert; Größe innerhalb des Limits;
+faststart. - Standbild und Kontaktabzug; Storyboard aktuell; Skripte, die alles regenerieren.
- Dem Nutzer: Größen, Lautstärke und was illustrativ oder fiktiv ist. Die Freigabe liegt bei ihm.