Communitygithub.com

Enricrypto/cypher-claude-skills

Bonnes pratiques pour Remotion - Création vidéo avec React

Qu'est-ce que cypher-claude-skills ?

Ce skill fournit un ensemble complet de bonnes pratiques et de connaissances spécifiques au domaine pour travailler avec Remotion, la bibliothèque de création vidéo basée sur React. Il guide l'utilisateur à travers la configuration d'un nouveau projet avec `create-video`, l'animation de propriétés à l'aide de `useCurrentFrame()`, `interpolate()` et des fonctions d'easing, ainsi que l'intégration d'actifs multimédias comme les images, les vidéos et l'audio via les composants React de Remotion. Le skill détaille également l'utilisation des séquences (`<Sequence>`), la configuration des compositions dans `src/Root.tsx`, les métadonnées dynamiques avec `calculateMetadata`, et les commandes essentielles du CLI pour le studio et les rendus. Il interdit explicitement les transitions CSS ou les animations Tailwind, qui ne se rendent pas correctement. En outre, il référence des règles spécialisées pour des sujets avancés tels que les sous-titres, l'utilisation de FFmpeg, la détection de silence, la visualisation audio, les effets sonores, le contenu 3D, les polices Google, les animations Lottie, le rendu vidéo transparent, le montage, les transitions, et bien plus encore. C'est un guide indispensable pour tout développeur utilisant Remotion afin d'éviter les pièges courants et de produire des vidéos de haute qualité avec React.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Enricrypto/cypher-claude-skills/tree/HEAD/skills/remotion-best-practices

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 lorsque vous travaillez avec du code Remotion afin d'obtenir des connaissances spécifiques au domaine.

Configuration d'un nouveau projet

Lorsque vous vous trouvez dans un dossier vide ou un espace de travail 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

Animez des propriétés en utilisant useCurrentFrame() et interpolate(). Utilisez Easing pour personnaliser le timing de l'animation.

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

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 actifs dans le dossier public/ à la racine de votre projet.

Utilisez staticFile() pour référencer des fichiers depuis le dossier public/.

Ajoutez des images avec 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 avec le composant <Video> depuis @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 avec le composant <Audio> depuis @remotion/media :

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

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

Les actifs peuvent également être référencés via des URLs 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 du 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

Lancez le studio Remotion pour prévisualiser une vidéo :

npx remotion studio

Optionnel : vérification de rendu d'une seule image

Vous pouvez rendre une seule image avec le CLI pour vérifier rapidement la mise en page, les couleurs ou le timing.
Ignorez cette étape pour les modifications triviales, les simples refactorisations, ou lorsque vous avez déjà suffisamment confiance grâce au studio ou aux rendus précédents.

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

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

Sous-titres

Pour les légendes ou sous-titres, chargez le fichier ./rules/subtitles.md pour plus d'informations.

Utilisation de FFmpeg

Pour certaines opérations vidéo, comme le découpage 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

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

Visualisation audio

Pour 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

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

Contenu 3D

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

Audio avancé

Voir rules/audio.md pour les fonctionnalités audio avancées comme le découpage, 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 propriétés d'une composition.

Compositions avancées

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

Polices Google

C'est la méthode recommandée pour charger les polices dans Remotion. Voir rules/google-fonts.md pour savoir comment charger les polices Google.

Polices locales

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

Obtenir la durée d'un fichier 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'image dynamiques et l'obtention des dimensions des images.

Light leaks

Voir rules/light-leaks.md pour les effets de superposition de light leaks avec @remotion/light-leaks.

Animations Lottie

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

HTML dans canvas

Voir rules/html-in-canvas.md si vous devez rendre du HTML dans un <canvas> pour appliquer des effets 2D ou WebGL via <HtmlInCanvas>.

Mesure des nœuds DOM

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

Mesure du texte

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

Séquençage avancé

Voir rules/sequencing.md pour plus de motifs de séquençage - retard, découpage, limitation de durée des éléments.

TailwindCSS

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

Animations de texte

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

Timing avancé

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

Transitions

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

Vidéos transparentes

Voir rules/transparent-videos.md pour rendre une vidéo avec transparence.

Découpage

Voir rules/trimming.md pour les motifs de découpage - 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 - découpage, volume, vitesse, bouclage, 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés