Verwendungszweck
Laden Sie dieses Skill, wenn Sie Remotion-Code lesen oder schreiben – vom Aufsetzen eines Projekts bis zum Rendern des finalen Videos.
Häufige Fehler, die KI vermeiden sollte
Überprüfen Sie jede Remotion-Codeänderung vor dem Commit auf diese wiederkehrenden Fehlermodi:
- Nicht-deterministische Zufälligkeit – verwenden Sie
random(seed)ausremotion, niemalsMath.random(),Date.now()odernew Date(). Parallele Renderings erzeugen sonst flimmerndes Rauschen. - Unmemoisede
<Player>inputProps– übergeben Sie immer memoised Props; unmemoised Props verursachen Re-Render-Stürme durch den gesamten Baum. - Fehlender
delayRender()/continueRender()– um asynchrone Arbeit (Fetch, Schrift laden, Messung) herum. Ohne sie hängt das Rendern bei 30.000 ms. - Nicht-monotoner
inputRangebei Untertiteln –interpolate'sinputRangemuss strikt steigen. Für kurze Clips verwenden SieMath.min(10, Math.floor(duration / 3))für das Ausblendfenster. - Überall lineares Easing – bevorzugen Sie
spring()für natürliche Bewegungen; verwenden Sie linear nur für explizite technische Anforderungen. - Vergessene
@remotion/google-fonts-Importe – jede Schriftart benötigt einen explizitenloadFont({ weights, subsets })-Aufruf. - Monolithische Single-Composition-Ausgabe – unterteilen Sie Szenen in kleine, fokussierte Kompositionen und setzen Sie diese mit
<Sequence>oder<TransitionSeries>zusammen. - Veraltete
startFrom/endAt– verwenden Sie stattdessentrimBefore/trimAfter.
Neues Projekt einrichten
Wenn Sie sich in einem leeren Ordner oder Workspace ohne bestehendes Remotion-Projekt befinden, richten Sie eines ein mit:
npx create-video@latest --yes --blank --no-tailwind mein-video
Ersetzen Sie mein-video durch einen geeigneten Projektnamen.
Vorschau starten
Starten Sie das Remotion Studio zur Vorschau eines Videos:
npx remotion studio
Optional: Ein-Frame-Render-Check
Sie können einen einzelnen Frame mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen. Überspringen Sie dies bei trivialen Änderungen, reinen Refactorings oder wenn Sie bereits genug Vertrauen aus dem Studio oder vorherigen Renderings haben.
npx remotion still [composition-id] --scale=0.25 --frame=30
Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).
Regelindex
Lesen Sie die einzelnen Regeldateien für detaillierte Erklärungen und Codebeispiele.
Kern
- core/compositions.md – Kompositionen, Stills, Ordner, Standard-Props und dynamische Metadaten definieren
- core/sequencing.md – Sequenzierungsmuster – Verzögerung, Trimmen, Begrenzung der Dauer von Elementen
- core/timing.md – Timing mit interpolate, Bezier-Easing und springs
- core/animations.md – Grundlegende Animationsfähigkeiten
- core/trimming.md – Anfang oder Ende von Animationen trimmen
- core/parameters.md – Ein Video mit einem Zod-Schema parametrisieren
- core/calculate-metadata.md – Dynamisch Dauer, Abmessungen und Props einer Komposition festlegen
- core/primitives.md – Layout- und Timing-Primitive: Loop, Freeze, Series, Null, IFrame, AnimatedImage, premount
Medien
- media/images.md – Bilder mit der Img-Komponente einbetten
- media/videos.md – Videos einbetten – Trimmen, Lautstärke, Geschwindigkeit, Schleifen
- media/gifs.md – GIFs synchron zur Remotion-Zeitleiste anzeigen
- media/lottie.md – Lottie-Animationen einbetten
- media/transparent-videos.md – Ein Video mit Transparenz rendern
- media/assets.md – Bilder, Videos, Audio und Schriftarten importieren
- media/light-leaks.md – Light-Leak-Overlay-Effekte
- media/3d.md – 3D-Inhalte mit Three.js und React Three Fiber
Audio
- audio/audio.md – Audio und Ton verwenden – Importieren, Trimmen, Lautstärke, Geschwindigkeit, Tonhöhe
- audio/voiceover.md – KI-generierte Sprachaufnahmen mit ElevenLabs TTS
- audio/audio-visualization.md – Audio visualisieren (Spektrumbalken, Wellenformen, Bass-Reaktion)
- audio/silence-detection.md – Adaptive Stilleerkennung mit FFmpeg
- audio/sfx.md – Soundeffekte verwenden
- audio/subtitles.md – Untertitel und Beschriftungen – Übersicht
- audio/get-audio-duration.md – Die Dauer einer Audiodatei mit Mediabunny ermitteln
- audio/ai-captions.md – KI-Transkription: @remotion/openai-whisper, whisper-web, install-whisper-cpp
Text
- text/text-animations.md – Typografie- und Textanimationsmuster
- text/measuring-text.md – Textabmessungen messen, Text in Container einpassen
- text/fonts.md – Google Fonts und lokale Schriftarten laden
- text/google-fonts.md – @remotion/google-fonts pro-Schrift-Pakete mit erforderlichen Gewichten/Untergruppen
- text/display-captions.md – Untertitel auf dem Bildschirm anzeigen
- text/import-srt-captions.md – SRT-Untertiteldateien importieren
Fortgeschritten
- advanced/maps.md – Eine Karte mit Mapbox hinzufügen und animieren
- advanced/charts.md – Diagramme und Datenvisualisierung (Balken, Kreis, Linie, Aktie)
- advanced/transitions.md – Szenenübergangsmuster (Grundlagen)
- advanced/transitions-package.md – @remotion/transitions vollständige Referenz – Präsentationen, Timing, benutzerdefiniert
- advanced/tailwind.md – TailwindCSS in Remotion verwenden
- advanced/measuring-dom-nodes.md – DOM-Elementabmessungen messen
- advanced/hdr.md – Farbraum und HDR-Ausgabe: bt709, displayp3, rec2020, ProRes
Dienstprogramme
- utilities/ffmpeg.md – FFmpeg für Videooperationen verwenden
- utilities/can-decode.md – Prüfen, ob ein Video mit Mediabunny decodiert werden kann
- utilities/extract-frames.md – Einzelbilder zu bestimmten Zeitstempeln extrahieren
- utilities/get-video-dimensions.md – Breite und Höhe einer Videodatei ermitteln
- utilities/get-video-duration.md – Die Dauer einer Videodatei in Sekunden ermitteln
- utilities/transcribe-captions.md – Untertitel transkribieren
Produktion
- production/delay-render.md – Rendern während asynchroner Arbeit unterbrechen: delayRender, continueRender, cancelRender
- production/determinism.md – Deterministische Renderings mit random(seed); niemals Math.random / Date.now
- production/rendering.md – @remotion/renderer Node SSR: bundle, selectComposition, renderMedia
- production/cli.md – npx remotion Unterbefehle und Flags (render, still, bundle, studio, benchmark)
- production/config.md – remotion.config.ts Config-Setter (codec, CRF, concurrency, Webpack)
- production/lambda.md – AWS Lambda: deployFunction, deploySite, renderMediaOnLambda, Kostentuning
- production/player.md – @remotion/player einbetten, PlayerRef, memoised inputProps, Pufferereignisse
- production/video-tag-decision.md – Zwischen Video / OffthreadVideo / Html5Video / @remotion/media wählen
- production/input-props.md – Prop-Auflösungsreihenfolge, Zod-Validierung, --props-CLI-Flags, Render-Boundary-Sicherheit
- production/caption-timing-safety.md – Monotoner inputRange und adaptives Ausblendfenster für Untertitel
- production/performance.md – Hardwarebeschleunigung, Parallelität, Bildformat, GPU-Vorberechnung, Benchmarking
- production/env-vars.md – REMOTION_-Präfix, .env-Laden, Geheimnisse via inputProps / envVariables
Integration
- integration/nextjs.md – Next.js App Router: Player SSR-Guard, transpilePackages, API-Route für Lambda
- integration/docker.md – Docker: Basis-Image, --shm-size, Schriftarten, Chromium-Flags, CI-Beispiel
- integration/mediabunny-migration.md – Migration von veraltetem media-parser/webcodecs zu Mediabunny Video/Audio
- integration/v5-prep.md – Zukunftssichere v4-Codebasis gegen v5-Breaking-Changes
Pakete
- packages/paths.md – @remotion/paths SVG-Pfad-Dienstprogramme (interpolatePath, warpPath, getLength)
- packages/shapes.md – @remotion/shapes vorgefertigte SVG-Primitive (Triangle, Circle, Star, Pie, Heart)
- packages/noise.md – @remotion/noise gesätes Perlin-Rauschen (noise2D, noise3D, noise4D)
- packages/motion-blur.md – @remotion/motion-blur Trail und CameraMotionBlur (sparsam verwenden)
- packages/skia.md – @remotion/skia leistungsstarke Leinwand (React Native Skia)
- packages/rive.md – @remotion/rive Animationen mit Zustandsautomaten (Lottie-Alternative)