Communitygithub.com

tiantangcao1980-web/DesignDNA-Skills

Remotion – „Erstelle Videos programmatisch mit React“ (43.6k Sterne, aktiv). Ein React-basiertes Framework, das Entwicklern ermöglicht, Videos mit React-Komponenten, Props, CSS, Canvas und SVG zu erstellen. Nutzbar für die programmatische Videogenerierung (Erklärvideos, personalisierte Anzeigen, datengetriebene Videos, GitHub-Unwrapped-Inhalte). Deckt Installation, Kernkonzepte (Composition, frames, useCurrentFrame), Remotion Player zum Einbetten und Lambda für Cloud-Rendering ab.

Was ist DesignDNA-Skills?

Dieser Skill bietet Entwicklern ein vollständiges Toolkit zur programmatischen Videogenerierung mit React mithilfe von Remotion. Er unterstützt die Erstellung von personalisierten Inhalten wie Jahr-in-Rückblick-Videos (z. B. GitHub Unwrapped), datengetriebenen Erklärvideos und Marketing-Materialien, die über herkömmliche Videobearbeitungswerkzeuge hinausgehen. Der Skill umfasst die Installation, Kernkonzepte wie die Verwendung von `useCurrentFrame()` und `interpolate()` für Animationen, das Rendern mit dem Remotion Player in React-Apps und die Cloud-basierte Skalierung über AWS Lambda. Zudem enthält er wichtige Richtlinien zur Laufzeitbeschränkung (kein `setTimeout`, keine Echtzeit-Wiedergabe) und Lizenzmodellen, sodass Entwickler deterministische, wiederholbare Video-Pipelines erstellen können. Die Integration mit DesignDNA ermöglicht es, Markenidentitäten (Farben, Schriftarten, Abstände) direkt in die Video-Komponenten einzubinden und so visuell konsistente Ergebnisse zu liefern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tiantangcao1980-web/DesignDNA-Skills/tree/HEAD/designdna/skills/remotion

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

StufeWerPreis
Einzelperson / Team ≤ 3Privat, kleines UnternehmenKostenlos (MIT-ähnlich)
Unternehmen ≤ 10 MitarbeiterKleines StartupKostenlos
Größeres Unternehmen> 10 Mitarbeiter100 $/Monat + 25 $/Sitzplatz
Editor StarterEigenen Video-Editor mit Remotion bauen600 $ einmalig
LambdaCloud-RenderingBezahlung 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, setInterval oder requestAnimationFrame innerhalb einer Remotion-Komponente verwenden – Determinismus kommt nur von useCurrentFrame()
  • ❌ 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. Verwende random() 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

SzenarioAlternative
Traditionelles, nicht-code-basiertes VideoAdobe After Effects / Premiere
Daten-Visualisierungs-VideosD3 + Bildschirmaufnahme ODER Remotion + D3
Animierte React-Komponenten (keine vollständigen Videos)Framer Motion · Motion · React Bits (siehe Skill)
Interaktive Web-AnimationenLottie · GSAP

Verwandte Skills