Wann verwenden
Verwende diese Skills immer dann, wenn du mit Remotion-Code arbeitest, um domänenspezifisches Wissen zu erhalten.
Neue Projekteinrichtung
Wenn du einen leeren Ordner oder einen Arbeitsbereich ohne bestehendes Remotion-Projekt hast, richte ein neues mit folgendem Befehl ein:
npx create-video@latest --yes --blank --no-tailwind my-video
Ersetze my-video mit einem passenden Projektnamen.
Entwerfen eines Videos
Animiere Eigenschaften mit useCurrentFrame() und interpolate(). Verwende Easing, um das Timing der Animation anzupassen.
import { useCurrentFrame, Easing } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Hello World!</div>;
};
CSS-Transitionen oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert.
Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.
Lege Assets im Ordner public/ im Stammverzeichnis deines Projekts ab.
Verwende staticFile(), um Dateien aus dem public/-Ordner zu referenzieren.
Füge Bilder mit der <Img>-Komponente hinzu:
import { Img, staticFile } from "remotion";
export const MyComposition = () => {
return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};
Füge Videos mit der <Video>-Komponente aus @remotion/media hinzu:
import { Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};
Füge Audio mit der <Audio>-Komponente aus @remotion/media hinzu:
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
Assets können auch als entfernte URLs referenziert werden:
import { Video } from "@remotion/media";
export const MyComposition = () => {
return <Video src="https://remotion.media/video.mp4" />
};
Um Inhalte zu verzögern, umschließe sie mit <Sequence> und verwende from.
Um die Dauer eines Elements zu begrenzen, verwende durationInFrames von <Sequence>.
<Sequence> ist standardmäßig eine absolute Füllung. Für Inline-Inhalte verwende layout="none".
import { Sequence } from "remotion";
export const Title = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Title</div>;
};
export const Subtitle = () => {
return <div>Subtitle</div>;
};
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence>
<Background />
</Sequence>
<Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
<Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
Die Breite, Höhe, fps und Dauer eines Videos werden in src/Root.tsx definiert:
import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
durationInFrames={100}
fps={30}
width={1080}
height={1080}
/>
);
};
Metadaten können auch dynamisch berechnet werden:
import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";
const calculateMetadata: CalculateMetadataFunction<
MyCompositionProps
> = async ({ props, abortSignal }) => {
const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
signal: abortSignal,
}).then((res) => res.json());
return {
durationInFrames: Math.ceil(data.duration * 30),
props: {
...props,
videoUrl: data.url,
},
width: 1080,
height: 1080,
};
};
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
fps={30}
width={1080}
height={1080}
defaultProps={{ videoId: "abc123" }}
calculateMetadata={calculateMetadata}
/>
);
};
Vorschau starten
Starte das Remotion Studio, um ein Video in der Vorschau anzusehen:
npx remotion studio
Optional: Einzelbild-Rendering-Prüfung
Du kannst ein einzelnes Bild mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen.
Überspringe dies bei trivialen Änderungen, reinen Refactorings oder wenn du bereits genug Vertrauen aus dem Studio oder vorherigen Renderings hast.
npx remotion still [composition-id] --scale=0.25 --frame=30
Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).
Untertitel (Captions)
Wenn du mit Untertiteln arbeitest, lade die Datei ./rules/subtitles.md für weitere Informationen.
FFmpeg verwenden
Für einige Videooperationen wie das Trimmen von Videos oder die Erkennung von Stille sollte FFmpeg verwendet werden. Lade die Datei ./rules/ffmpeg.md für weitere Informationen.
Stille-Erkennung (Silence detection)
Wenn du stille Segmente aus Video- oder Audiodateien erkennen und trimmen musst, lade die Datei ./rules/silence-detection.md.
Audio-Visualisierung
Wenn du Audio visualisieren musst (Spektrumbalken, Wellenformen, bassreaktive Effekte), lade die Datei ./rules/audio-visualization.md für weitere Informationen.
Soundeffekte
Wenn du Soundeffekte verwenden musst, lade die Datei ./rules/sfx.md für weitere Informationen.
3D-Inhalte
Siehe rules/3d.md für 3D-Inhalte in Remotion mit Three.js und React Three Fiber.
Fortgeschrittene Audio-Features
Siehe rules/audio.md für fortgeschrittene Audio-Funktionen wie Trimmen, Lautstärke, Geschwindigkeit, Tonhöhe.
Dynamische Dauer, Abmessungen und Daten
Siehe rules/calculate-metadata.md für dynamisch gesetzte Kompositionsdauer, Abmessungen und Props.
Fortgeschrittene Kompositionen
Siehe rules/compositions.md zur Definition von Standbildern, Ordnern, Standard-Props und zur Verschachtelung von Kompositionen.
Google Fonts
Ist die empfohlene Methode zum Laden von Schriftarten in Remotion. Siehe rules/google-fonts.md zum Laden von Google Fonts.
Lokale Schriftarten
Siehe rules/local-fonts.md zum Laden lokaler Schriftarten.
Audiodauer ermitteln
Siehe rules/get-audio-duration.md zum Ermitteln der Dauer einer Audiodatei in Sekunden mit Mediabunny.
Videoabmessungen ermitteln
Siehe rules/get-video-dimensions.md zum Ermitteln der Breite und Höhe einer Videodatei mit Mediabunny.
Videodauer ermitteln
Siehe rules/get-video-duration.md zum Ermitteln der Dauer einer Videodatei in Sekunden mit Mediabunny.
GIFs
Siehe rules/gifs.md zur Anzeige von GIFs synchronisiert mit der Zeitleiste von Remotion.
Fortgeschrittene Bilder
Siehe rules/images.md zur Größenanpassung und Positionierung von Bildern, dynamischen Bildpfaden und zum Ermitteln von Bildabmessungen.
Lichtlecks (Light leaks)
Siehe rules/light-leaks.md für Überlagerungseffekte mit Lichtlecks mit @remotion/light-leaks.
Lottie-Animationen
Siehe rules/lottie.md zum Einbetten von Lottie-Animationen in Remotion.
HTML in Canvas
Siehe rules/html-in-canvas.md, wenn du HTML in ein <canvas> rendern musst, um 2D- oder WebGL-Effekte über <HtmlInCanvas> anzuwenden.
DOM-Knoten messen
Siehe rules/measuring-dom-nodes.md zum Messen von DOM-Elementabmessungen in Remotion.
Text messen
Siehe rules/measuring-text.md zum Messen von Textabmessungen, Anpassen von Text an Container und Überprüfen von Überläufen.
Fortgeschrittene Sequenzierung
Siehe rules/sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmen, Begrenzung der Dauer von Elementen.
TailwindCSS
Siehe rules/tailwind.md zur Verwendung von TailwindCSS in Remotion.
Textanimationen
Siehe rules/text-animations.md für Typografie- und Textanimationsmuster.
Fortgeschrittenes Timing
Siehe rules/timing.md für fortgeschrittenes Timing mit interpolate und Bézier-Easing sowie Federn (Springs).
Übergänge (Transitions)
Siehe rules/transitions.md für Szenenübergangsmuster.
Transparente Videos
Siehe rules/transparent-videos.md zum Rendern eines Videos mit Transparenz.
Trimmen
Siehe rules/trimming.md für Trimm-Muster – Abschneiden des Anfangs oder Endes von Animationen.
Fortgeschrittene Videos
Siehe rules/videos.md für fortgeschrittenes Wissen zum Einbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit, Schleife, Tonhöhe.
Parametrisierte Videos
Siehe rules/parameters.md zum Parametrisieren einer Komposition durch Hinzufügen eines Zod-Schemas.
Karten
Für einfache Karten mit kleinen Überflügen (Flyovers) erwäge die Verwendung statischer Kartenbilder. Für komplexe Karten mit animierten Routen oder Überflügen lade die Kartenregel: rules/maplibre.md
Voiceover
Siehe rules/voiceover.md zum Hinzufügen von KI-generiertem Voiceover zu Remotion-Kompositionen mit ElevenLabs TTS.