Remotion – Videos mit React erstellen
Quelle: remotion-dev/remotion · 43,6k ⭐ · v4.x · 🟢 aktiv 2026
NPM:remotion·@remotion/cli·@remotion/player·@remotion/lambda
Dokumentation: https://www.remotion.dev/
1. Kernkonzept
- Ein Video ist eine Sequenz von React-Komponenten, die Bild für Bild gerendert wird
- Du erhältst eine
frame-Nummer (0 → N) und eine leere Leinwand – der Rest ist CSS / SVG / Canvas / WebGL - Remotion kompiliert dein React zu einer Serie von PNG/JPEG-Bildern und kodiert diese mittels FFmpeg zu MP4
2. Wann einsetzen
- Programmatische Videogenerierung (Erklärvideos, personalisierte Videoanzeigen, datengetriebene Videos)
- Jahresrückblick- / Statistiken-Videos (wie GitHub Unwrapped, Spotify Wrapped)
- Marketing-Erklärvideos aus Text + Daten (nicht manuell in AE/Premiere bearbeitet)
- Entwicklertools / Tutorial-Videos, die aus Code generiert werden
Wann NICHT einsetzen
- Bearbeitung von Live-Action-Videos (bleibe bei Premiere / Final Cut)
- Traditionelle Bewegtgrafik (After Effects ist effizienter)
- Einmalige Videos – der Aufwand lohnt sich nicht
3. Installation (neues Projekt)
npx create-video@latest my-video
cd my-video
npm install
npm start # Öffnet Remotion Studio
Angebotene Vorlagen
- Hello World
- TypeScript
- JavaScript
- React 18 / 19
- Audiogram
- Stargazer (GitHub-Sterne-Animation)
- Three.js
- Leer
Zu bestehendem Projekt hinzufügen
npm install remotion @remotion/cli
Erstelle src/Root.tsx:
import { Composition } from 'remotion';
import { MyVideo } from './MyVideo';
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={150}
fps={30}
width={1920}
height={1080}
defaultProps={{ title: 'Hallo' }}
/>
);
};
Registriere Root in remotion.config.ts:
import { Config } from '@remotion/cli/config';
Config.setEntryPoint('./src/index.ts');
4. Kernkonzepte
<Composition />
Definiert ein Video: welche Komponente rendert, Dauer, fps, Auflösung, Standard-Props.
useCurrentFrame()
Gibt die aktuelle Bildnummer zurück (0-basiert). Alles animiert sich von hier aus:
import { useCurrentFrame, useVideoConfig, interpolate } from 'remotion';
export const MyVideo: React.FC<{ title: string }> = ({ title }) => {
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: 'clamp' });
return (
<div style={{ flex: 1, backgroundColor: '#0a0a0f', color: 'white', opacity, display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
<h1 style={{ fontSize: 120 }}>{title}</h1>
</div>
);
};
interpolate(frame, [from, to], [startVal, endVal], options)
Bildet die Bildnummer auf jeden Wert ab (Position, Deckkraft, Skalierung, Farbe etc.).
spring(...)
Natürliche Bewegungskurve:
import { spring, useCurrentFrame, useVideoConfig } from 'remotion';
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const scale = spring({
frame,
fps,
config: { damping: 100, stiffness: 200, mass: 0.5 },
});
<div style={{ transform: `scale(${scale})` }}>Inhalt</div>
<Sequence from={f} durationInFrames={n}>
Versetzt eine Komponente, sodass sie bei Bild f startet:
import { Sequence } from 'remotion';
<Sequence from={0} durationInFrames={60}><Intro /></Sequence>
<Sequence from={60} durationInFrames={120}><Szene1 /></Sequence>
<Sequence from={180} durationInFrames={90}><Outro /></Sequence>
<Audio src={...} />
import { Audio } from 'remotion';
import bgMusic from './music.mp3';
<Audio src={bgMusic} volume={0.5} />
<Img src={...} /> / <Video src={...} />
Binde Bilder / Videoclips in die Timeline ein.
staticFile('...')
Referenziere Dateien in public/ – Remotion kümmert sich um die Pfadauflösung:
import { staticFile } from 'remotion';
<Img src={staticFile('logo.svg')} />
5. Rendern
Lokales Rendern (CLI)
npx remotion render MyVideo out/video.mp4
npx remotion render MyVideo out/video.mp4 --props='{"title":"Hallo"}'
npx remotion render MyVideo out/video.mp4 --quality=high --codec=h265
Remotion Studio (Vorschau + Timeline)
npm start # Öffnet http://localhost:3000
Remotion Player (in deine React-App einbetten)
import { Player } from '@remotion/player';
import { MyVideo } from './MyVideo';
<Player
component={MyVideo}
durationInFrames={150}
fps={30}
compositionWidth={1920}
compositionHeight={1080}
inputProps={{ title: 'Hallo' }}
controls
style={{ width: '100%' }}
/>
Remotion Lambda (Cloud-Rendering)
Für Batch- / Server-seitiges Rendern:
npm install @remotion/lambda
Richte AWS Lambda-Funktion ein, deploye Remotion:
npx remotion lambda functions deploy
npx remotion lambda sites create
npx remotion lambda render MyVideo --input-props='{"title":"Benutzer 123"}'
6. Beispiel – datengetriebenes Video
Erstelle ein personalisiertes „Jahr im Rückblick“-Video:
import { Composition } from 'remotion';
import { YearInReview } from './YearInReview';
export const RemotionRoot = () => (
<Composition
id="Rückblick"
component={YearInReview}
durationInFrames={8 * 30} // 8 Sekunden bei 30fps
fps={30}
width={1080}
height={1920} // Hochformat (mobil)
defaultProps={{
user: { name: 'Alice', stats: { commits: 1284, prs: 42, reviews: 89 } },
}}
/>
);
Rendere für jeden Benutzer:
for user in $(cat users.json); do
npx remotion lambda render Rückblick --input-props="$user"
done
7. Preise / Lizenzierung
| Stufe | Wer | Preis |
|---|---|---|
| Einzelperson / Team ≤ 3 | Privat, kleines Unternehmen | Kostenlos (MIT-ähnlich) |
| Unternehmen ≤ 10 Mitarbeiter | Kleines Startup | Kostenlos |
| Größeres Unternehmen | > 10 Mitarbeiter | 100 $/Monat + 25 $/Sitzplatz |
| Editor Starter | Eigenen Video-Editor mit Remotion bauen | 600 $ einmalig |
| Lambda | Cloud-Rendering | Bezahlung pro Render (ca. wenige Cent pro Minute Video) |
Siehe https://www.remotion.dev/docs/license für verbindliche Bedingungen.
8. VERBOTEN
- ❌ NIEMALS Remotion für Echtzeit-Videowiedergabe-Engines verwenden – es ist für Render-zu-Datei ausgelegt, nicht für Live-Streaming
- ❌ NIEMALS tatsächliche Videodateien > 100 MB in das Bundle packen –
staticFile()mit großen Mediendateien separat hosten - ❌ NIEMALS
setTimeout,setIntervaloderrequestAnimationFrameinnerhalb einer Remotion-Komponente verwenden – Determinismus kommt nur vonuseCurrentFrame() - ❌ NIEMALS Daten innerhalb des Renders abrufen – vorab abrufen und über
inputPropsübergeben - ❌ NIEMALS mehr Frames pro Komponente rendern als nötig – jeder Frame kostet Renderzeit
- ❌ NIEMALS kommerzielle Lambda-Renders ohne Lizenz für Teams > 3 ausliefern
- ❌ NIEMALS
Math.random()direkt verwenden – die Ausgabe wird nicht deterministisch. Verwenderandom()von Remotion mit einem Seed. - ❌ NIEMALS mit CSS-Übergängen animieren – Remotion rendert Bild für Bild; CSS-Übergänge werden nicht angewendet. Verwende
interpolate()+ frame.
9. Vorab-Checkliste
- [ ] remotion + @remotion/cli installiert
- [ ] src/Root.tsx mit <Composition />, das/die Video(s) definiert
- [ ] Alle Animationen durch useCurrentFrame() gesteuert – kein setTimeout/setInterval
- [ ] Zufallswerte verwenden Remotions random() mit Seed (nicht Math.random)
- [ ] Schrifteinbindung: useFont oder <link> im <head>
- [ ] Audiodateien via <Audio> mit passendem Volume/Trim
- [ ] Für Produktion: Rendern via Lambda ODER remotion render CLI
- [ ] Preise geprüft – korrekte Stufe für Teamgröße
- [ ] inputProps typisiert (TypeScript) für jede Composition
- [ ] Kurzes Test-Rendering vor dem vollständigen Rendern
10. Dial-fit
Hängt vollständig vom Design des Videos ab – Remotion ist ein Framework, keine visuelle Bibliothek.
11. Integration mit DesignDNA
Remotion lässt sich gut mit den Marken-DNAs von DesignDNA kombinieren: Verwende die DESIGN.md-Token einer Marke (Farben, Schriften, Abstände) als visuelle Sprache deines generierten Videos. Beispiel:
import { tokens } from '../design-md/stripe/tokens';
<div style={{ color: tokens.colors['stripe-purple'], fontFamily: tokens.typography.families[0] }}>
Stripe-branded Intro
</div>
Dein „Jahr im Rückblick“-Video wird so zur Markenidentität passen.
12. Alternativen
| Szenario | Alternative |
|---|---|
| Traditionelles, nicht-code-basiertes Video | Adobe After Effects / Premiere |
| Daten-Visualisierungs-Videos | D3 + Bildschirmaufnahme ODER Remotion + D3 |
| Animierte React-Komponenten (keine vollständigen Videos) | Framer Motion · Motion · React Bits (siehe Skill) |
| Interaktive Web-Animationen | Lottie · GSAP |