Wann verwenden
Verwende diese 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 gestalten
Bevor du visuelle Szenen, Layouts, Promos, Bewegungsgrafiken oder textlastige Videos entwirfst, lade rules/video-layout.md für video-first Layout- und Textgrößen-Richtlinien.
Animierte Eigenschaften werden mit useCurrentFrame() und interpolate() erstellt. Bevorzuge interpolate() gegenüber spring(), es sei denn, ein physikbasierter Bewegungsablauf wird explizit benötigt. Verwende Easing.bezier(), um Timing-Abläufe anzupassen, einschließlich sprunghafter oder überschwingender Bewegungen.
Für Animationen, die im Remotion Studio bearbeitet werden sollen, behalte den interpolate()-Aufruf inline im style-Prop bei und verwende individuelle CSS-Transform-Eigenschaften (scale, translate, rotate) anstatt einen transform-String zu erstellen.
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 }}>Hello World!</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-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.
Lege Assets im public/-Ordner auf deiner Projektebene ab.
Verwende staticFile(), um auf Dateien im 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 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 Inhalt zu verzögern, umschließe ihn mit <Sequence> und verwende from.
Um die Dauer eines Elements zu begrenzen, verwende durationInFrames von <Sequence>.
<Sequence> hat 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>
);
}
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 des Videos zu sehen:
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 genügend Vertrauen aus dem Studio oder vorherigen Rendering 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 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 Stille-Erkennung, sollte FFmpeg verwendet werden. Lade die Datei ./rules/ffmpeg.md für weitere Informationen.
Stille-Erkennung
Wenn du stille Abschnitte 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 benötigst, 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 gelisteten Effekt über rules/effects.md, auch bei HTML, das über <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 Lichtlecks-Overlays siehe rules/light-leaks.md. Dokumentation: https://www.remotion.dev/docs/effects
Verfügbare Effekte: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), 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 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.
Erweiterte Kompositionen
Siehe rules/compositions.md für die Definition von Standbildern, Ordnern, Standard-Props und für die Verschachtelung von Kompositionen.
Google Fonts
Ist der empfohlene Weg, um Schriftarten in Remotion zu laden. Siehe rules/google-fonts.md für das 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 für die Anzeige von GIFs synchronisiert mit Remotions Zeitleiste.
Erweiterte Bilder
Siehe rules/images.md für Größenanpassung und Positionierung von Bildern, dynamische Bildpfade und Ermittlung von Bildabmessungen.
Lottie-Animationen
Siehe rules/lottie.md zum Einbetten von Lottie-Animationen in Remotion.
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 Behälter und Überprüfen von Überläufen.
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 fortgeschrittenes 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, ziehe statische Kartenbilder in Betracht. 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.