Communitygithub.com

Remotion - Création de vidéos programmatiques

Construisez, déboguez et rendez des vidéos par programmation avec Remotion (framework vidéo basé sur React). À utiliser lorsque l'utilisateur souhaite créer une vidéo avec du code, mentionne Remotion spécifiquement, parle de vidéo React, de vidéo programmatique, de MP4 depuis React, d'explications animées avec du code, de vidéo avec tête parlante et sous-titres, de vidéo basée sur des données, ou colle une erreur Remotion. Couvre la configuration de composition, les motifs d'animation useCurrentFrame (interpolate, spring), la mise en page Sequence/AbsoluteFill, les composants audio/vidéo/image, le Studio, et le rendu via CLI / @remotion/renderer / Lambda. NE PAS UTILISER pour les tâches vidéo non-Remotion — utiliser la compétence 'video' pour la génération vidéo IA (Veo, Sora, Runway, HeyGen).

Qu'est-ce que Remotion - Création de vidéos programmatiques ?

Cette compétence vous guide dans la création de vidéos par programmation à l'aide de Remotion, un framework open-source qui transforme des composants React en vidéos MP4 et autres formats. Elle est idéale pour les développeurs souhaitant générer des vidéos animées, des explications codées, des vidéos avec tête parlante et sous-titres, ou des vidéos pilotées par des données. La compétence couvre l'ensemble du flux de travail : détection ou création d'un projet, configuration des compositions via `<Composition>`, création d'animations avec `useCurrentFrame()` et `interpolate`/`spring`, utilisation des composants de mise en page (`<AbsoluteFill>`, `<Sequence>`), intégration de médias (`<Audio>`, `<Video>`, `<Img>`, `<OffthreadVideo>`), et rendu local ou via Lambda. Elle fonctionne avec les outils CLI de Remotion, le Studio pour la prévisualisation interactive, et l'API `@remotion/renderer`. Elle insiste sur les bonnes pratiques : animations uniquement basées sur la frame courante (pas de CSS transitions ou setTimeout), pureté des composants, et utilisation d'`<OffthreadVideo>` pour un rendu plus rapide. Elle aide également à diagnostiquer les erreurs courantes comme le scintillement, les compositions non trouvées, ou les problèmes de mémoire.

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

Demander à votre IA préférée

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

Documentation

Remotion

Remotion transforme des composants React en vidéos. Vous écrivez du JSX, Remotion appelle votre composant une fois par image à une fps fixe, et les images résultantes sont assemblées en un MP4 (ou autre format).

Modèle mental fondamental

Remotion vous donne un numéro d'image et une toile vierge. Votre composant React décide quoi afficher à cette image.

Il n'y a pas de timeline d'animation au sens impératif. Le temps est un nombre (frame), et votre composant est une fonction pure de ce nombre et des props. C'est pourquoi les animations doivent être pilotées par useCurrentFrame() — les transitions CSS et setTimeout sont non déterministes pendant le rendu et produiront du scintillement ou une désynchronisation.

Quand utiliser cette compétence

  • L'utilisateur a un projet Remotion (remotion.config.ts ou @remotion/* dans package.json) et souhaite construire, modifier ou déboguer une composition
  • L'utilisateur dit « créons une vidéo avec Remotion / avec du code / par programmation »
  • L'utilisateur colle une erreur Remotion ou pose des questions sur interpolate, spring, Sequence, useCurrentFrame, Composition, etc.
  • L'utilisateur souhaite rendre un projet Remotion existant ou configurer un rendu Lambda

Quand NE PAS utiliser

  • Génération de vidéo avec des modèles IA (Veo, Sora, Runway, Kling, HeyGen) → utiliser la compétence video
  • Édition de fichiers vidéo existants (couper/rogner/concaténer) → ffmpeg, pas Remotion
  • Diffusion en direct → Remotion est un rendu hors ligne uniquement

Flux de travail

  1. Détecter ou créer le projet.

    • Nouveau projet : npx create-video@latest (interactif — choisit un modèle comme Hello World, Blank, JavaScript, TikTok, etc.)
    • Existant : vérifier la présence de remotion.config.ts, src/Root.tsx, et @remotion/cli dans package.json. Noter la version majeure de Remotion — les API évoluent, et l'URL correcte de la documentation est https://www.remotion.dev/docs (dernière version) ou des pages liées à une version spécifique.
  2. Localiser ou créer la composition. Les compositions sont enregistrées dans src/Root.tsx via <Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />. L'id est ce que la CLI utilise pour le rendu par nom.

  3. Construire le composant en utilisant useCurrentFrame + useVideoConfig pour le temps et les métadonnées. Composer la mise en page avec <AbsoluteFill>, découper le temps avec <Sequence>.

  4. Prévisualiser dans le Studio : npx remotion studio (rechargement automatique). N'essayez pas de « tester » les images isolément — ouvrez le Studio.

  5. Rendre : npx remotion render <CompositionId> [output.mp4]. Le codec par défaut est H.264 / MP4. Voir references/rendering.md pour les drapeaux et l'API programmatique.

Référence rapide des API

Consultez les fichiers liés pour plus de profondeur — chargez-les uniquement lorsqu'une tâche en a besoin.

SujetFichier
Composition, hooks, Sequence, AbsoluteFill, mise en pagereferences/core-concepts.md
interpolate, spring, Easing, décalage, motifs d'animation courantsreferences/animation.md
Rendu : drapeaux CLI, @remotion/renderer, Lambda, codecs, propsreferences/rendering.md
Audio/vidéo/images : <Audio>, <Video>, <Img>, <OffthreadVideo>, sous-titresreferences/media.md
Configuration du projet, conventions de fichiers, remotion.config.tsreferences/project-setup.md
Motifs courants : animations de frappe, tiers inférieurs, piloté par données, parallaxereferences/patterns.md

Règles strictes

  1. Animer via useCurrentFrame(). Jamais setTimeout, requestAnimationFrame, ou transition CSS. Ils scintillent pendant le rendu car chaque image est rendue indépendamment dans un navigateur sans tête.
  2. durationInFrames est obligatoire et doit être un entier. Secondes totales = durationInFrames / fps.
  3. Gardez les composants purs. Pas d'effets de bord de haut niveau, pas de Math.random() sans graine déterministe — la même image doit toujours produire les mêmes pixels.
  4. Ne faites pas de requêtes pendant le rendu. Utilisez delayRender() / continueRender() pour bloquer la disponibilité de l'image pendant le chargement des données, ou préchargez et passez via les props.
  5. Utilisez <OffthreadVideo> au lieu de <Video> lorsque c'est possible pour des lectures vidéo non bloquantes pendant le rendu (plus rapide, moins de mémoire).
  6. Passez les données dynamiques via --props (CLI) ou inputProps (Studio/programmatique), pas en modifiant des fichiers.

Erreurs courantes

Erreur / symptômeCauseCorrectif
Scintillement / mouvement non concordant dans le MP4 par rapport à l'aperçu StudioUtilisation de transitions CSS ou d'animations non pilotées par les framesRemplacer par interpolate(frame, ...) ou spring({ frame, fps })
« Composition not found »Erreur de frappe dans l'ID ou enregistrement <Composition> manquantVérifier src/Root.tsx
Rendu bloquédelayRender() en attente sans continueRender() appeléTrouver la promesse non résolue ; ajouter try/finally
Mémoire insuffisante pour les vidéos longues<Video> gardant les frames en mémoirePasser à <OffthreadVideo>
Audio désynchroniséDécalage de fps du fichier audio ou démarrage à la mauvaise frameEnvelopper <Audio> dans <Sequence from={...}>

Vérification

Après avoir fait des modifications, toujours :

  • Exécuter npx remotion studio et parcourir la timeline pour confirmer que le changement est correct à plusieurs frames (début, milieu, fin)
  • Pour les modifications programmatiques, rendre un court segment de test : npx remotion render <id> out.mp4 --frames=0-60
  • Vérification de type : npx tsc --noEmit si le projet est en TypeScript

Ne revendiquez pas le succès sans l'une de ces vérifications. Du code qui compile n'est pas la même chose qu'une vidéo qui a l'air correcte.

Skills associés