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.tsou@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
-
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/clidanspackage.json. Noter la version majeure de Remotion — les API évoluent, et l'URL correcte de la documentation esthttps://www.remotion.dev/docs(dernière version) ou des pages liées à une version spécifique.
- Nouveau projet :
-
Localiser ou créer la composition. Les compositions sont enregistrées dans
src/Root.tsxvia<Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />. L'idest ce que la CLI utilise pour le rendu par nom. -
Construire le composant en utilisant
useCurrentFrame+useVideoConfigpour le temps et les métadonnées. Composer la mise en page avec<AbsoluteFill>, découper le temps avec<Sequence>. -
Prévisualiser dans le Studio :
npx remotion studio(rechargement automatique). N'essayez pas de « tester » les images isolément — ouvrez le Studio. -
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.
| Sujet | Fichier |
|---|---|
| Composition, hooks, Sequence, AbsoluteFill, mise en page | references/core-concepts.md |
interpolate, spring, Easing, décalage, motifs d'animation courants | references/animation.md |
Rendu : drapeaux CLI, @remotion/renderer, Lambda, codecs, props | references/rendering.md |
Audio/vidéo/images : <Audio>, <Video>, <Img>, <OffthreadVideo>, sous-titres | references/media.md |
Configuration du projet, conventions de fichiers, remotion.config.ts | references/project-setup.md |
| Motifs courants : animations de frappe, tiers inférieurs, piloté par données, parallaxe | references/patterns.md |
Règles strictes
- Animer via
useCurrentFrame(). JamaissetTimeout,requestAnimationFrame, outransitionCSS. Ils scintillent pendant le rendu car chaque image est rendue indépendamment dans un navigateur sans tête. durationInFramesest obligatoire et doit être un entier. Secondes totales =durationInFrames / fps.- 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. - 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. - 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). - Passez les données dynamiques via
--props(CLI) ouinputProps(Studio/programmatique), pas en modifiant des fichiers.
Erreurs courantes
| Erreur / symptôme | Cause | Correctif |
|---|---|---|
| Scintillement / mouvement non concordant dans le MP4 par rapport à l'aperçu Studio | Utilisation de transitions CSS ou d'animations non pilotées par les frames | Remplacer par interpolate(frame, ...) ou spring({ frame, fps }) |
| « Composition not found » | Erreur de frappe dans l'ID ou enregistrement <Composition> manquant | Vé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émoire | Passer à <OffthreadVideo> |
| Audio désynchronisé | Décalage de fps du fichier audio ou démarrage à la mauvaise frame | Envelopper <Audio> dans <Sequence from={...}> |
Vérification
Après avoir fait des modifications, toujours :
- Exécuter
npx remotion studioet 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 --noEmitsi 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.