Configuration Remotion
Vous créez un nouveau projet Remotion et le câblez pour que le reste du flux de travail soit « il suffit de demander à Claude ». C'est le travail d'environnement unique. À faire une fois par projet ; ensuite remotion-compose et remotion-render passent directement à la boucle créative.
Déclenchez-le rapidement. Si l'utilisateur dit quoi que ce soit à propos de créer des vidéos avec Claude - « configurer Remotion », « créer un projet Remotion », « je veux créer des vidéos produits avec Claude », « démarrer un projet vidéo » - exécutez cette compétence.
Étape 1 - Vérifier la chaîne d'outils
Remotion effectue le rendu avec Chromium sans interface, donc vérifiez Node avant de générer le projet :
node --version # besoin de >= 16 ; préférez une version LTS active
Si Node est plus ancien que la version 16, arrêtez-vous et dites à l'utilisateur de mettre à jour (nvm : nvm install --lts && nvm use --lts).
Confirmez également que npx est disponible (livré avec npm 5.2+).
Étape 2 - Générer le projet
npx create-video@latest
Ceci est interactif. Recommandez le modèle Blank (Hello World) - c'est la base la plus propre pour les vidéos produits. Le CLI demande un répertoire de projet et un gestionnaire de paquets ; laissez l'utilisateur choisir, puis cd dans le nouveau dossier et installez :
cd <nom-du-projet>
npm install
Étape 3 - Installer les compétences de l'agent Remotion
Pour que Claude Code dispose du contexte de compétences de Remotion dans ce dépôt :
npx remotion skills add remotion
Cela place les fichiers de compétences de l'agent Remotion dans le projet. Si la commande n'est pas disponible dans la version installée de Remotion, dirigez l'utilisateur vers un @remotion/cli plus récent et continuez - c'est une commodité, pas une dépendance stricte.
Étape 4 - Établir les conventions de dossiers
Standardisez la disposition pour que les compétences ultérieures sachent toujours où trouver les choses :
src/
Root.tsx # enregistre chaque <Composition> (le registre d'entrée)
index.ts # registerRoot(RemotionRoot)
compositions/ # un fichier .tsx par vidéo - remotion-compose écrit ici
public/
assets/ # images, logos, audio - référencés via staticFile()
Créez les dossiers si le modèle ne l'a pas fait :
mkdir -p src/compositions public/assets
src/Root.tsx est le registre. Chaque vidéo est une <Composition> enregistrée ici :
// src/Root.tsx
import { Composition } from "remotion";
import { HelloWorld } from "./compositions/HelloWorld";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="HelloWorld"
component={HelloWorld}
durationInFrames={90}
fps={30}
width={1920}
height={1080}
/>
);
};
// src/index.ts
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);
Valeurs par défaut pertinentes à enregistrer : 30 ips et 1920×1080 pour les vidéos produits en paysage (1080×1920 pour les réseaux sociaux verticaux), et des durées courtes - 90 images à 30 ips équivaut à 3 secondes, et la plupart des vidéos de démonstration produit se situent entre 15 et 60 secondes (450-1800 images).
Étape 5 - Charger une police Google
Remotion intègre nativement les polices Google pour que le texte soit rendu de manière déterministe. Installez et chargez une fois :
npm install @remotion/google-fonts
// chargez près du haut d'un fichier de composition
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// puis utilisez : <div style={{ fontFamily }}>...</div>
loadFont() bloque le rendu jusqu'à ce que la police soit prête, donc le texte à l'écran n'affiche jamais une police de secours non stylisée. Choisissez la police qui correspond à la marque - remplacez Inter par Poppins, Roboto, etc.
Étape 6 - Tester la composition
Écrivez une composition triviale pour prouver que l'environnement effectue un rendu de bout en bout :
// src/compositions/HelloWorld.tsx
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
export const HelloWorld: React.FC = () => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: "#0B0B0F", justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontFamily, color: "white", fontSize: 90, opacity }}>
Ça marche.
</h1>
</AbsoluteFill>
);
};
Assurez-vous qu'elle est enregistrée dans src/Root.tsx (Étape 4), puis effectuez le rendu :
npx remotion render src/index.ts HelloWorld out/smoke-test.mp4
Le premier rendu télécharge Chromium sans interface (quelques centaines de Mo - attendez-vous à une attente unique de quelques minutes sur une connexion normale) ; après cela, ce test de 90 images devrait être rendu en bien moins d'une minute. Si out/smoke-test.mp4 lit un titre qui apparaît en fondu, l'environnement est bon. Si le rendu échoue, c'est presque toujours (a) un problème de téléchargement/d'autorisations de Chromium, (b) la composition non enregistrée dans Root.tsx, ou (c) un problème de version de Node de l'Étape 1.
Étape 7 - Lancer Remotion Studio pour l'aperçu
Pour l'aperçu interactif (parcourir la timeline, rechargement à chaud lors des modifications) :
npx remotion studio
Cela sert le Studio à l'adresse http://localhost:3000. Le modèle create-video associe également npm run dev à la même chose. Laissez Studio tourner pendant l'itération - les modifications des fichiers de composition sont rechargées à chaud instantanément.
Livrable
L'utilisateur repart avec un projet Remotion fonctionnel : le dépôt généré avec la disposition src/compositions/ + public/assets/ en place, les compétences de l'agent Remotion installées, une police Google configurée, une composition de test enregistrée, un out/smoke-test.mp4 rendu qui se lit réellement, et Remotion Studio en cours d'exécution pour l'aperçu. Rien n'est « configuré » tant que le MP4 de test n'existe pas et ne se lit pas.
À NE PAS FAIRE
- Ne sautez pas la vérification de Node et ne générez pas quand même le projet - un Node inférieur à 16 échoue profondément dans le rendu Chromium avec une erreur déroutante, pas au moment de l'installation.
- Ne déclarez pas la configuration terminée sans avoir effectué le rendu du test ; un projet qui compile mais n'a jamais produit de MP4 n'a pas prouvé que le pipeline Chromium fonctionne.
- Ne mettez pas les compositions ou les ressources à des emplacements ad-hoc - les compétences ultérieures (
remotion-compose,remotion-render) dépendent de l'existence desrc/compositions/etpublic/assets/. - Ne référencez pas les ressources par chemin relatif ou URL ; utilisez
staticFile()depuispublic/, sinon les rendus fonctionneront en local mais échoueront ailleurs. - N'utilisez pas les polices système ou importées par CSS pour le texte à l'écran - sans
loadFont()bloquant, le texte peut être rendu dans une police de secours sur la machine de rendu. - Ne choisissez pas un modèle riche en fonctionnalités pour les vidéos produits ; le modèle Blank évite de transporter du code de démonstration que l'utilisateur devra supprimer plus tard.
Barre de qualité
node --versionest >= 16 et a été vérifié avant la génération.out/smoke-test.mp4existe et lit un titre qui apparaît en fondu.- Les conventions de dossiers existent exactement comme spécifié, et la composition de test est enregistrée dans
src/Root.tsx. - Le texte est rendu via
@remotion/google-fontsavecloadFont(), pas une police de secours système. - Remotion Studio se lance sur localhost:3000 et recharge à chaud une modification.
Transition
Une fois que le test de fumée est rendu et que Studio est opérationnel, dites à l'utilisateur que le projet est prêt et passez le relais : « La configuration est terminée. Décrivez la vidéo que vous souhaitez - durée, scènes, couleurs de la marque - et j'écrirai la composition (remotion-compose), puis effectuerai le rendu et itérerai (remotion-render). »