Wann verwenden
Verwende diesen Skill, wenn du mit Remotion-Code arbeitest, um domänenspezifisches Wissen zu erhalten.
Neues Projekt einrichten
Wenn du dich in einem leeren Ordner oder Workspace ohne bestehendes Remotion-Projekt befindest, erstelle eines mit:
npx create-video@latest --yes --blank --no-tailwind my-video
Ersetze my-video durch einen passenden Projektnamen.
Ein Video entwerfen
Bevor du visuelle Szenen, Layouts, Promos, Motion Graphics oder textlastige Videos gestaltest, lade rules/video-layout.md für videoorientierte Layout- und Textgrößen-Richtlinien.
Animiere Eigenschaften mit useCurrentFrame() und interpolate(). Bevorzuge interpolate() gegenüber spring(), es sei denn, eine physikbasierte Bewegung wird explizit benötigt. Verwende Easing.bezier(), um das Timing anzupassen, einschließlich ruckartiger oder überschwingender Bewegungen.
Für Animationen, die in Remotion Studio bearbeitet werden sollen, lasse den interpolate()-Aufruf inline im style-Prop und verwende einzelne CSS-Transform-Eigenschaften (scale, translate, rotate) anstatt einen transform-String zusammenzusetzen.
import { useCurrentFrame, Easing, interpolate, useVideoConfig } 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 }}>Hallo Welt!</div>;
};
Bevorzuge:
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
Statt:
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
CSS-Übergänge oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert. Tailwind-Animations-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.
Lege Assets im Ordner public/ im Projektstamm ab.
Verwende staticFile(), um auf Dateien aus dem public/-Ordner zu verweisen.
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 von @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 von @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> füllt standardmäßig den gesamten Bereich. 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 }}>Titel</div>;
};
export const Subtitle = () => {
return <div>Untertitel</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>
);
}
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 eine Vorschau eines Videos anzuzeigen:
npx remotion studio
Optional: Einzelbild-Renderprü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 ausreichend 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
Wenn es um Untertitel oder Beschriftungen geht, lade die Datei ./rules/subtitles.md für weitere Informationen.
FFmpeg verwenden
Für einige Videooperationen, wie das Trimmen von Videos oder das Erkennen von Stille, sollte FFmpeg verwendet werden. Lade die Datei ./rules/ffmpeg.md für weitere Informationen.
Stille erkennen
Wenn du stille Segmente in 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.
Visuelle und Pixeleffekte
Wenn du einen visuellen Effekt erstellst, bevorzuge: 1. normale Remotion/HTML/CSS/SVG/Filter/Blend/Mask-Animation, 2. einen aufgeführten Effekt über rules/effects.md, auch auf HTML, das durch <HtmlInCanvas> gerendert wird, 3. einen benutzerdefinierten createEffect() über rules/effects.md, wenn der Benutzer einen wiederverwendbaren/projektspezifischen Effekt wünscht, 4. benutzerdefiniertes <HtmlInCanvas onPaint> über rules/html-in-canvas.md nur, wenn kein Effekt passt.
Für Light-Leak-Overlays siehe rules/light-leaks.md. Dok.: https://www.remotion.dev/docs/effects
Verfügbare Effekte: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
3D-Inhalte
Siehe rules/3d.md für 3D-Inhalte in Remotion mit Three.js und React Three Fiber.
Erweitertes Audio
Siehe rules/audio.md für erweiterte Audiofunktionen wie Trimmen, Lautstärke, Geschwindigkeit, Tonhöhe.
Dynamische Dauer, Abmessungen und Daten
Siehe rules/calculate-metadata.md für das dynamische Setzen der Kompositionsdauer, -abmessungen und -props.
Erweiterte Kompositionen
Siehe rules/compositions.md für die Definition von Standbildern, Ordnern, Standard-Props und für das Verschachteln von Kompositionen.
Google Fonts
Ist die empfohlene Methode zum Laden von Schriftarten in Remotion. Siehe rules/google-fonts.md für das Laden von Google Fonts.
Lokale Schriftarten
Siehe rules/local-fonts.md für das Laden lokaler Schriftarten.
Audiodauer ermitteln
Siehe rules/get-audio-duration.md für das Ermitteln der Dauer einer Audiodatei in Sekunden mit Mediabunny.
Videoabmessungen ermitteln
Siehe rules/get-video-dimensions.md für das Ermitteln von Breite und Höhe einer Videodatei mit Mediabunny.
Videodauer ermitteln
Siehe rules/get-video-duration.md für das Ermitteln der Dauer einer Videodatei in Sekunden mit Mediabunny.
GIFs
Siehe rules/gifs.md für die Anzeige von GIFs, die mit der Zeitleiste von Remotion synchronisiert sind.
Erweiterte Bilder
Siehe rules/images.md für die Größenanpassung und Positionierung von Bildern, dynamische Bildpfade und das Ermitteln von Bildabmessungen.
Lottie-Animationen
Siehe rules/lottie.md zum Einbetten von Lottie-Animationen in Remotion.
Messen von DOM-Knoten
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 Behälter und Überprüfen auf Überlauf.
Erweiterte 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.
Erweitertes Timing
Siehe rules/timing.md für erweitertes Timing mit interpolate und Bézier-Easing sowie Federn.
Übergänge
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.
Erweiterte Videos
Siehe rules/videos.md für erweitertes Wissen zum Einbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit, Schleifen, Tonhöhe.
Parametrisierte Videos
Siehe rules/parameters.md zum Parametrisieren einer Komposition durch Hinzufügen eines Zod-Schemas.
Karten
Für einfache Karten mit wenigen Überflügen solltest du statische Kartenbilder in Betracht ziehen. 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.