Quand l'utiliser
Utilisez cette compétence lorsque :
- Vous créez des vidéos programmatiques à partir de code (pas de vidéo générée par IA)
- Vous construisez du contenu vidéo basé sur des données (graphiques, statistiques, vidéos personnalisées)
- Vous produisez des vidéos en lots à partir de modèles et de données
- Vous créez du contenu animé pour les réseaux sociaux (TikTok, Reels, Shorts)
- Vous réalisez des vidéos produits ou explicatives avec un contrôle précis
Démarrage rapide
1. Créer un nouveau projet
python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video
2. Écrire votre composition
Modifiez src/Composition.tsx - c'est votre vidéo définie comme composants React.
3. Prévisualiser dans le studio
python3 Skills/remotion/scripts/remotion_cli.py studio my-video
4. Rendre en MP4
python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4
Concepts fondamentaux
Compositions
Une composition définit les dimensions, la durée et le FPS de votre vidéo :
<Composition
id="MyVideo"
component={MyComponent}
durationInFrames={300} // 10 secondes à 30fps
fps={30}
width={1920}
height={1080}
/>
Animation basée sur les images
Toutes les animations DOIVENT utiliser useCurrentFrame(). Les animations CSS sont INTERDITES.
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
Séquences
Utilisez <Sequence> pour chronométrer l'apparition des éléments :
<Sequence from={30} durationInFrames={60}>
<Title />
</Sequence>
Références de règles
Lisez ces fichiers pour des modèles détaillés (chargés depuis les compétences Remotion officielles) :
| Règle | Description |
|---|---|
references/animations.md | Fondamentaux de l'animation basée sur les images |
references/timing.md | Ressorts, easing, courbes d'interpolation |
references/compositions.md | Définition des compositions, images fixes, dossiers |
references/sequencing.md | Chronométrage et ordre des éléments |
references/videos.md | Intégration de vidéos - rogner, volume, vitesse |
references/audio.md | Gestion du son - importer, rogner, volume |
references/assets.md | Images, polices, fichiers statiques |
references/transitions.md | Transitions de scènes |
references/text-animations.md | Modèles d'animation typographique |
references/charts.md | Modèles de visualisation de données |
references/display-captions.md | Légendes style TikTok |
Commandes CLI
# Gestion de projet
python3 Skills/remotion/scripts/remotion_cli.py new <nom> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <nom>
python3 Skills/remotion/scripts/remotion_cli.py render <nom> [--composition ID] [--output chemin]
python3 Skills/remotion/scripts/remotion_cli.py list
# Options de rendu
--composition ID # Composition spécifique à rendre (par défaut : première)
--output CHEMIN # Chemin du fichier de sortie (par défaut : out/video.mp4)
--fps N # Remplace le FPS
--width N # Remplace la largeur
--height N # Remplace la hauteur
--codec CODEC # h264, h265, vp8, vp9, prores (par défaut : h264)
Modèles courants
Fondu entrant/sortant
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;
Animation à ressort (mouvement naturel)
const scale = spring({
frame,
fps,
config: { damping: 200 }, // Fluide, sans rebond
});
Éléments décalés
{items.map((item, i) => (
<Sequence key={i} from={i * 10}>
<Item data={item} />
</Sequence>
))}
Vidéo basée sur les données
type VideoProps = { title: string; stats: number[] };
export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
// Animation basée sur les props
};
// Dans Root.tsx :
<Composition
id="DataVideo"
component={DataVideo}
defaultProps={{ title: "Résultats T4", stats: [10, 20, 30] }}
// ...
/>
Intégration avec Zo
Rendu par lots
Utilisez /zo/ask pour rendre plusieurs vidéos en parallèle :
for row in data:
# Chaque appel rend avec des props différentes
await render_video(row)
Emplacement de sortie
Les projets se trouvent dans Sites/<nom>/ pour la cohérence avec le système de sites de Zo.
Les vidéos rendues sortent dans Sites/<nom>/out/.
Contraintes
- Pas d'animations CSS - Elles ne s'afficheront pas correctement
- Pas de classes d'animation Tailwind - Même problème
- Uniquement basé sur les images - Tout mouvement via
useCurrentFrame() - Intensif en CPU - Le rendu prend du temps ; les vidéos complexes = rendu plus long
- Node.js requis - Remotion nécessite un environnement Node (déjà disponible dans Zo)