Communitygithub.com

IGNOVA-SYSTEMS-INTEGRATION/KONTRX

Best Practices und Fachwissen zur programmatischen Videoerstellung mit Remotion (Videos in React/TypeScript, gerendert als MP4). Verwende diese Fähigkeit, wenn du Remotion-Code schreibst oder bearbeitest.

Was ist KONTRX?

Diese Regeldatei (Skill) bündelt Best Practices und detailliertes Fachwissen für die programmatische Videoproduktion mit dem Framework Remotion. Sie deckt den gesamten Workflow ab – vom Einrichten neuer Projekte über die Animation mit `useCurrentFrame()` und `interpolate()` bis hin zur Einbindung von Medien, Untertiteln, Audio und visuellen Effekten. Der Skill erklärt, wie man Szenen mit `<Sequence>` strukturiert, die Videometadaten dynamisch über `calculateMetadata` festlegt und warum CSS-Transitionen oder Tailwind-Animationen in Remotion nicht korrekt gerendert werden. Zusätzlich verweist die Dokumentation auf zahlreiche spezialisierte Regeldateien für Themen wie 3D-Inhalte (Three.js/React Three Fiber), Lottie-Animationen, Karten, Transparenz, Voiceover (ElevenLabs) und erweiterte Audio-Features. Dadurch dient der Skill als zentrale Anlaufstelle für Entwickler, die mit Remotion hochwertige, dynamische Videos erstellen und dabei typische Fallstricke vermeiden möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGNOVA-SYSTEMS-INTEGRATION/KONTRX/tree/HEAD/AGENT/skills/remotion

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

Dokumentation

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.

Verwandte Skills