Quand l'utiliser
Chargez ce skill chaque fois que vous lisez ou écrivez du code Remotion, de la création d'un projet au rendu de la vidéo finale.
Erreurs courantes des IA à éviter
Vérifiez chaque modification de code Remotion par rapport à ces modes de défaillance récurrents avant de valider :
- Aléatoire non déterministe — utilisez
random(seed)deremotion, jamaisMath.random(),Date.now()ounew Date(). Sinon, des rendus parallèles produisent un bruit de scintillement. inputPropsnon mémoïsés pour<Player>— passez toujours des props mémoïsés ; des props non mémoïsés provoquent des tempêtes de re-rendu dans toute l'arborescence.delayRender()/continueRender()manquants autour de travaux asynchrones (fetch, chargement de polices, mesure). Sans eux, le rendu se bloque à 30 000 ms.inputRangenon monotone pour les sous-titres — leinputRangedeinterpolatedoit strictement augmenter. Pour les clips courts, utilisezMath.min(10, Math.floor(duration / 3))pour la fenêtre de fondu.- Easing linéaire partout — préférez
spring()pour un mouvement naturel ; utilisez le linéaire uniquement pour des besoins techniques explicites. - Imports
@remotion/google-fontsoubliés — chaque police nécessite un appel expliciteloadFont({ weights, subsets }). - Sortie monolithique à composition unique — découpez les scènes en petites compositions ciblées et composez avec
<Sequence>ou<TransitionSeries>. startFrom/endAtobsolètes — utiliseztrimBefore/trimAfterà la place.
Configuration d'un nouveau projet
Lorsque vous êtes dans un dossier ou un espace de travail vide sans projet Remotion existant, créez-en un avec :
npx create-video@latest --yes --blank --no-tailwind my-video
Remplacez my-video par un nom de projet approprié.
Lancement de la prévisualisation
Lancez le studio Remotion pour prévisualiser une vidéo :
npx remotion studio
Optionnel : vérification par rendu d'une seule image
Vous pouvez rendre une seule image avec la CLI pour vérifier la mise en page, les couleurs ou le timing. Sautez cette étape pour des modifications triviales, des refontes pures, ou lorsque vous avez déjà assez de 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).
Index des règles
Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code.
Core
- core/compositions.md - Définir des compositions, des images fixes, des dossiers, des props par défaut et des métadonnées dynamiques
- core/sequencing.md - Modèles de séquencement - délai, rognage, limitation de la durée des éléments
- core/timing.md - Timing avec interpolate, easing Bezier et ressorts
- core/animations.md - Compétences fondamentales en animation
- core/trimming.md - Rogner le début ou la fin des animations
- core/parameters.md - Rendre une vidéo paramétrable avec un schéma Zod
- core/calculate-metadata.md - Définir dynamiquement la durée, les dimensions et les props d'une composition
- core/primitives.md - Primitives de mise en page et de timing : Loop, Freeze, Series, Null, IFrame, AnimatedImage, premount
Média
- media/images.md - Intégrer des images avec le composant Img
- media/videos.md - Intégrer des vidéos - rognage, volume, vitesse, boucle
- media/gifs.md - Afficher des GIFs synchronisés avec la timeline de Remotion
- media/lottie.md - Intégrer des animations Lottie
- media/transparent-videos.md - Rendre une vidéo avec transparence
- media/assets.md - Importer des images, vidéos, fichiers audio et polices
- media/light-leaks.md - Effets de superposition de fuites de lumière
- media/3d.md - Contenu 3D avec Three.js et React Three Fiber
Audio
- audio/audio.md - Utiliser l'audio et le son - importation, rognage, volume, vitesse, hauteur
- audio/voiceover.md - Voix off générée par IA avec ElevenLabs TTS
- audio/audio-visualization.md - Visualiser l'audio (barres de spectre, formes d'onde, réactif aux basses)
- audio/silence-detection.md - Détection adaptative du silence avec FFmpeg
- audio/sfx.md - Utiliser les effets sonores
- audio/subtitles.md - Vue d'ensemble des sous-titres et légendes
- audio/get-audio-duration.md - Obtenir la durée d'un fichier audio avec Mediabunny
- audio/ai-captions.md - Transcription IA : @remotion/openai-whisper, whisper-web, install-whisper-cpp
Texte
- text/text-animations.md - Typographie et modèles d'animation de texte
- text/measuring-text.md - Mesurer les dimensions du texte, adapter le texte aux conteneurs
- text/fonts.md - Charger les polices Google et les polices locales
- text/google-fonts.md - Paquets par police @remotion/google-fonts avec les poids/sous-ensembles requis
- text/display-captions.md - Afficher les légendes à l'écran
- text/import-srt-captions.md - Importer des fichiers de sous-titres SRT
Avancé
- advanced/maps.md - Ajouter une carte avec Mapbox et l'animer
- advanced/charts.md - Graphiques et visualisation de données (barres, secteurs, lignes, actions)
- advanced/transitions.md - Modèles de transition de scène (bases)
- advanced/transitions-package.md - Référence complète @remotion/transitions - présentations, timing, personnalisation
- advanced/tailwind.md - Utiliser TailwindCSS avec Remotion
- advanced/measuring-dom-nodes.md - Mesurer les dimensions des éléments DOM
- advanced/hdr.md - Espace colorimétrique et sortie HDR : bt709, displayp3, rec2020, ProRes
Utilitaires
- utilities/ffmpeg.md - Utiliser FFmpeg pour les opérations vidéo
- utilities/can-decode.md - Vérifier si une vidéo peut être décodée avec Mediabunny
- utilities/extract-frames.md - Extraire des images à des horodatages spécifiques
- utilities/get-video-dimensions.md - Obtenir la largeur et la hauteur d'un fichier vidéo
- utilities/get-video-duration.md - Obtenir la durée d'un fichier vidéo en secondes
- utilities/transcribe-captions.md - Transcrire des légendes
Production
- production/delay-render.md - Suspendre le rendu pendant un travail asynchrone : delayRender, continueRender, cancelRender
- production/determinism.md - Rendu déterministe avec random(seed) ; jamais Math.random / Date.now
- production/rendering.md - @remotion/renderer Node SSR : bundle, selectComposition, renderMedia
- production/cli.md - Sous-commandes et indicateurs npx remotion (render, still, bundle, studio, benchmark)
- production/config.md - Setters de configuration remotion.config.ts (codec, CRF, simultanéité, Webpack)
- production/lambda.md - AWS Lambda : deployFunction, deploySite, renderMediaOnLambda, réglage des coûts
- production/player.md - Intégration @remotion/player, PlayerRef, inputProps mémoïsés, événements de tampon
- production/video-tag-decision.md - Choisir entre Video / OffthreadVideo / Html5Video / @remotion/media
- production/input-props.md - Ordre de résolution des props, validation Zod, indicateurs --props CLI, sécurité des limites de rendu
- production/caption-timing-safety.md - inputRange monotone et fenêtre de fondu adaptative pour les légendes
- production/performance.md - Accélération matérielle, simultanéité, format d'image, précalcul GPU, benchmarking
- production/env-vars.md - Préfixe REMOTION_, chargement .env, secrets via inputProps / envVariables
Intégration
- integration/nextjs.md - Routeur App Next.js : garde SSR du Player, transpilePackages, route API pour Lambda
- integration/docker.md - Docker : image de base, --shm-size, polices, indicateurs Chromium, exemple CI
- integration/mediabunny-migration.md - Migrer de media-parser/webcodecs obsolètes vers Mediabunny Video/Audio
- integration/v5-prep.md - Préparer le code v4 pour les changements cassants de la v5
Paquets
- packages/paths.md - Utilitaires de chemins SVG @remotion/paths (interpolatePath, warpPath, getLength)
- packages/shapes.md - Primitives SVG préfabriquées @remotion/shapes (Triangle, Circle, Star, Pie, Heart)
- packages/noise.md - Bruit de Perlin ensemencé @remotion/noise (noise2D, noise3D, noise4D)
- packages/motion-blur.md - Trail et CameraMotionBlur @remotion/motion-blur (à utiliser avec parcimonie)
- packages/skia.md - Canvas haute performance @remotion/skia (React Native Skia)
- packages/rive.md - Animations @remotion/rive avec machines d'état (alternative à Lottie)