Communitygithub.com

IGNOVA-SYSTEMS-INTEGRATION/KONTRX

Bonnes pratiques et connaissances du domaine pour créer des vidéos par programmation avec Remotion (vidéos en React/TypeScript, rendues en MP4). À utiliser lors de l'écriture ou de l'édition de code Remotion.

Qu'est-ce que KONTRX ?

Ce skill fournit les connaissances essentielles du domaine pour travailler efficacement avec Remotion, une bibliothèque permettant de créer des vidéos programmatiquement avec React et TypeScript, rendues au format MP4. Il couvre un large éventail d'opérations, allant du scaffolding d'un nouveau projet avec `create-video` à la conception de scènes complexes, en passant par les animations (interpolate, spring, Easing.bezier), la gestion des séquences et des transitions, l'intégration de sous-titres, d'audio, de GIFs, d'animations Lottie, de contenu 3D (Three.js), de graphiques, d'effets visuels et bien plus encore. Il inclut également la gestion de la durée dynamique via `calculateMetadata` et le rendu. Conçu pour être consulté avant chaque utilisation d'une API Remotion, ce skill garantit l'utilisation des composants et des props les plus récents (ex : `@remotion/media`) et promeut des pratiques de codage optimales (interpolation inline, pas de transitions CSS, pas de classes Tailwind animées). Il référence de nombreuses ressources supplémentaires (fichiers de règles) pour des sujets avancés comme les transitions, la détection de silence, la visualisation audio, les polices Google, les GIFs synchronisés, le trimming, et bien d'autres, ce qui en fait un guide complet pour tout développeur Remotion.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

Documentation

Quand l'utiliser

Utilisez ce skill chaque fois que vous travaillez avec du code Remotion pour obtenir les connaissances spécifiques au domaine.

Configuration d'un nouveau projet

Lorsque vous vous trouvez dans un dossier ou un espace de travail vide sans projet Remotion existant, créez-en un en utilisant :

npx create-video@latest --yes --blank --no-tailwind my-video

Remplacez my-video par un nom de projet approprié.

Concevoir une vidéo

Avant de concevoir des scènes visuelles, des mises en page, des promos, des graphismes animés ou des vidéos avec beaucoup de texte, chargez rules/video-layout.md pour obtenir des conseils sur la mise en page et le dimensionnement du texte adaptés à la vidéo.

Animez les propriétés en utilisant useCurrentFrame() et interpolate(). Préférez interpolate() à spring() sauf si un mouvement basé sur la physique est explicitement nécessaire. Utilisez Easing.bezier() pour personnaliser le timing, y compris les mouvements saccadés ou avec dépassement.

Pour les animations qui doivent pouvoir être modifiées dans Remotion Studio, conservez l'appel interpolate() en ligne dans la prop style et utilisez des propriétés de transformation CSS individuelles (scale, translate, rotate) au lieu de composer une chaîne transform.

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>;
};

Préférez :

style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

À :

const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

Les transitions ou animations CSS sont INTERDITES - elles ne seront pas rendues correctement. Les noms de classes d'animation Tailwind sont INTERDITS - ils ne seront pas rendus correctement.

Placez les ressources dans le dossier public/ à la racine de votre projet.

Utilisez staticFile() pour référencer les fichiers du dossier public/.

Ajoutez des images en utilisant le composant <Img> :

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

Ajoutez des vidéos en utilisant le composant <Video> de @remotion/media :

import { Video } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

Ajoutez de l'audio en utilisant le composant <Audio> de @remotion/media :

import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

Les ressources peuvent également être référencées en tant qu'URL distantes :

import { Video } from "@remotion/media";

export const MyComposition = () => {
  return <Video src="https://remotion.media/video.mp4" />
};

Pour retarder du contenu, enveloppez-le dans <Sequence> et utilisez from. Pour limiter la durée d'un élément, utilisez durationInFrames de <Sequence>. Par défaut, <Sequence> occupe tout l'espace disponible. Pour un contenu en ligne, utilisez 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 }}>Titre</div>;
};

export const Subtitle = () => {
  return <div>Sous-titre</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>
  );
}

La largeur, la hauteur, le fps et la durée d'une vidéo sont définis dans src/Root.tsx :

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}
    />
  );
};

Les métadonnées peuvent également être calculées dynamiquement :

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}
    />
  );
};

Démarrer l'aperçu

Démarrez Remotion Studio pour prévisualiser une vidéo :

npx remotion studio

Optionnel : vérification d'un seul rendu d'image

Vous pouvez afficher une seule image avec l'interface en ligne de commande pour vérifier rapidement la mise en page, les couleurs ou le timing. Ignorez cette étape pour les modifications triviales, les refontes pures ou lorsque vous avez déjà suffisamment confiance grâce à Studio ou aux rendus précédents.

npx remotion still [id-composition] --scale=0.25 --frame=30

À 30 fps, --frame=30 correspond à la marque d'une seconde (--frame est basé sur zéro).

Sous-titres

Lorsque vous traitez des sous-titres ou des légendes, chargez le fichier ./rules/subtitles.md pour plus d'informations.

Utilisation de FFmpeg

Pour certaines opérations vidéo, telles que le rognage de vidéos ou la détection de silence, FFmpeg doit être utilisé. Chargez le fichier ./rules/ffmpeg.md pour plus d'informations.

Détection de silence

Lorsque vous devez détecter et rogner les segments silencieux de fichiers vidéo ou audio, chargez le fichier ./rules/silence-detection.md.

Visualisation audio

Lorsque vous devez visualiser l'audio (barres de spectre, formes d'onde, effets réactifs aux basses), chargez le fichier ./rules/audio-visualization.md pour plus d'informations.

Effets sonores

Lorsque vous devez utiliser des effets sonores, chargez le fichier ./rules/sfx.md pour plus d'informations.

Effets visuels et pixel

Lors de la création d'un effet visuel, préférez : 1. une animation normale Remotion/HTML/CSS/SVG/filtre/mélange/masque, 2. un effet listé via rules/effects.md, y compris sur du HTML rendu via <HtmlInCanvas>, 3. un createEffect() personnalisé via rules/effects.md lorsque l'utilisateur demande un effet réutilisable/propre au projet, 4. un <HtmlInCanvas onPaint> personnalisé via rules/html-in-canvas.md uniquement si aucun effet ne convient.

Pour les superpositions de fuite de lumière, voir rules/light-leaks.md. Documentation : https://www.remotion.dev/docs/effects

Effets disponibles : 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().

Contenu 3D

Voir rules/3d.md pour le contenu 3D dans Remotion utilisant Three.js et React Three Fiber.

Audio avancé

Voir rules/audio.md pour les fonctionnalités audio avancées comme le rognage, le volume, la vitesse, la hauteur.

Durée, dimensions et données dynamiques

Voir rules/calculate-metadata.md pour définir dynamiquement la durée, les dimensions et les props de la composition.

Compositions avancées

Voir rules/compositions.md pour savoir comment définir des images fixes, des dossiers, des props par défaut et comment imbriquer des compositions.

Google Fonts

C'est la manière recommandée de charger des polices dans Remotion. Voir rules/google-fonts.md pour savoir comment charger Google Fonts.

Polices locales

Voir rules/local-fonts.md pour savoir comment charger des polices locales.

Obtenir la durée d'un audio

Voir rules/get-audio-duration.md pour obtenir la durée d'un fichier audio en secondes avec Mediabunny.

Obtenir les dimensions d'une vidéo

Voir rules/get-video-dimensions.md pour obtenir la largeur et la hauteur d'un fichier vidéo avec Mediabunny.

Obtenir la durée d'une vidéo

Voir rules/get-video-duration.md pour obtenir la durée d'un fichier vidéo en secondes avec Mediabunny.

GIFs

Voir rules/gifs.md pour savoir comment afficher des GIFs synchronisés avec la timeline de Remotion.

Images avancées

Voir rules/images.md pour le dimensionnement et le positionnement des images, les chemins d'images dynamiques et l'obtention des dimensions des images.

Animations Lottie

Voir rules/lottie.md pour intégrer des animations Lottie dans Remotion.

Mesurer les nœuds DOM

Voir rules/measuring-dom-nodes.md pour mesurer les dimensions des éléments du DOM dans Remotion.

Mesurer le texte

Voir rules/measuring-text.md pour mesurer les dimensions du texte, adapter le texte aux conteneurs et vérifier les débordements.

Séquençage avancé

Voir rules/sequencing.md pour plus de motifs de séquencement - retarder, rogner, limiter la durée des éléments.

TailwindCSS

Voir rules/tailwind.md pour utiliser TailwindCSS dans Remotion.

Animations de texte

Voir rules/text-animations.md pour les motifs de typographie et d'animation de texte.

Timing avancé

Voir rules/timing.md pour le timing avancé avec interpolate et l'assouplissement Bézier, et les ressorts.

Transitions

Voir rules/transitions.md pour les motifs de transition de scène.

Vidéos transparentes

Voir rules/transparent-videos.md pour le rendu d'une vidéo avec transparence.

Rognage

Voir rules/trimming.md pour les motifs de rognage - couper le début ou la fin des animations.

Vidéos avancées

Voir rules/videos.md pour des connaissances avancées sur l'intégration de vidéos - rognage, volume, vitesse, boucle, hauteur.

Vidéos paramétrées

Voir rules/parameters.md pour rendre une composition paramétrable en ajoutant un schéma Zod.

Cartes

Pour les cartes simples avec peu de survols, envisagez d'utiliser des images de carte statiques. Pour les cartes complexes avec des itinéraires animés ou des survols, chargez la règle des cartes : rules/maplibre.md

Voix off

Voir rules/voiceover.md pour ajouter une voix off générée par IA aux compositions Remotion en utilisant ElevenLabs TTS.

Skills associés