Remotion CLI
L'outil est remotion, du paquet @remotion/cli. Chaque commande s'exécute via npx remotion <commande>, et chacune d'elles regroupe d'abord le projet, de sorte qu'une erreur de type ou une mauvaise importation se manifeste comme un échec de regroupement plutôt qu'un échec de rendu.
npx remotion --help et npx remotion <commande> --help font autorité pour les drapeaux. Les drapeaux changent entre les versions ; lisez la sortie d'aide plutôt que de vous fier à une liste, y compris celle-ci. Ce qui suit décrit la boucle et les modes d'échec, pas une référence des drapeaux.
La boucle
| Étape | Commande | Pourquoi |
|---|---|---|
| Scaffold | npx create-video@latest --blank | écrit un package.json, remotion.config.ts, tsconfig adaptés |
| Vérification de type | npx tsc --noEmit | le contrôle le moins coûteux ; détecte les dérives de schéma/prop avant tout rendu |
| Liste | npx remotion compositions | confirme que l'id que vous allez rendre existe réellement |
| Sonde d'une image | npx remotion still <id> out/probe.png --frame=<n> | secondes, pas minutes ; le cheval de bataille de l'itération |
| Révision | npx remotion studio | confiez-la à l'utilisateur ; il parcourt et édite les props lui-même |
| Rendu | npx remotion render <id> out/video.mp4 | seulement après l'approbation de l'utilisateur |
| Envoi à distance | npx remotion bundle → npx remotion lambda render <url> <id> | rendu distribué ; nécessite une infrastructure AWS déployée |
Sondez les stills avant de rendre
Un rendu complet d'une composition 1080p de 45 secondes prend des minutes. Un still prend des secondes et répond à la plupart des questions : le texte est-il dans le cadre, la ressource s'est-elle chargée, la couleur est-elle correcte. Sondez le milieu de chaque scène, regardez chaque image, et ensuite seulement rendez.
npx remotion still launch out/s1.png --frame=45
npx remotion still launch out/s2.png --frame=180
Ne signalez jamais qu'une composition fonctionne sur la foi d'un bundle réussi. Regardez les pixels.
Studio est la surface de révision, pas votre débogueur
npx remotion studio sert le projet avec une timeline, un éditeur de props piloté par le schéma Zod, et un parcours image par image précis. Confiez-le à l'utilisateur pour approbation. Pour votre propre vérification, préférez les sondes still : elles sont scriptables et vous pouvez examiner la sortie sans demander à l'utilisateur de décrire ce qu'il voit.
Passage de props
--props prend une chaîne JSON ou un chemin vers un fichier JSON et remplace defaultProps :
npx remotion render launch out/video.mp4 --props='{"productName":"Acme"}'
Une prop qui échoue au schéma Zod de la composition fait échouer le rendu de manière explicite. C'est l'intérêt de déclarer le schéma, alors gardez-le précis.
Rendu par lots
Il n'y a pas de sous-commande de lot. Bouclez dans le shell sur les ids ou les charges utiles de props :
for id in $(npx remotion compositions --quiet); do
npx remotion render "$id" "out/$id.mp4"
done
Pour de nombreux rendus d'une seule composition sur un ensemble de données, préférez renderMedia() depuis @remotion/renderer dans un script Node : il regroupe une fois au lieu d'une fois par rendu, ce qui domine le temps réel.
Performance de rendu
--concurrency=<n>définit le nombre de workers parallèles. La valeur par défaut est la moitié des cœurs CPU plafonnée à 8 ; le maximum est le nombre de cœurs, et en demander plus est une erreur, pas un plafonnement. Sur une machine à mémoire limitée, la réduire corrige les crashs qui ressemblent à des bugs du moteur de rendu.--jpeg(au lieu du format PNG par défaut) constitue une accélération importante lorsque la composition n'a pas de transparence à préserver.npx remotion benchmarkmesure un rendu réel, alors utilisez-le pour justifier un changement de concurrence ou de codec plutôt que de deviner.npx remotion gpurapporte ce que le navigateur va réellement accélérer. Cela vaut la peine de vérifier avant d'attribuer un rendu lent à un shader ou un filtre lourd.
Diagnostic des échecs
| Symptôme | Cause probable |
|---|---|
| Le bundling échoue | Une erreur de type ou une mauvaise importation. Exécutez npx tsc --noEmit pour la version lisible de la même erreur. |
| « Aucune composition avec l'id … » | L'id dans Root.tsx diffère de celui que vous avez passé. npx remotion compositions le résout. |
| Le rendu se bloque, puis expire | Un delayRender() sans continueRender() correspondant. Chaque handle de délai doit être libéré. |
| Chaque image ressemble à l'image 0 | Une animation/transition CSS, ou requestAnimationFrame. Le moteur de rendu n'avance pas l'horloge du navigateur. |
| L'animation stroboscopique ou scintille image par image | Math.random() non ensemencé. Utilisez random(seed). |
| Le mouvement fonctionne en avançant, se brise sur un saut | Animation pilotée par l'état. Dérivez de useCurrentFrame() à la place. |
| Ressource 404 uniquement dans un rendu Lambda ou bundle | Un chemin codé en dur au lieu de staticFile(). |
| Erreur de versions incompréhensible | Paquets Remotion incompatibles. npx remotion versions signale le désaccord. |
| Mémoire insuffisante en milieu de rendu | Concurrence trop élevée pour la machine. Réduisez --concurrency. |
Remontez la sortie d'erreur réelle lorsque vous signalez un échec. Ne paraphrasez pas une trace de pile.
Où sont passées les capacités de l'ancienne CLI HyperFrames
L'ancienne CLI hyperframes regroupait des commandes d'édition, de média et d'assurance qualité que la CLI de Remotion ne possède pas. Rien de ce qui suit n'est une commande Remotion, alors n'essayez pas de les exécuter :
| Commande retirée | Où se trouve la capacité maintenant |
|---|---|
init | npx create-video@latest --blank, puis /hyperframes-core → references/project-structure.md |
lint, check, layout, validate | npx tsc --noEmit plus les sondes still. Le contrat data-* que ces contrôles appliquaient a disparu. |
snapshot, compare, grade-compare | npx remotion still aux images choisies ; comparez les PNG avec vos propres outils. |
preview, play, present | npx remotion studio |
add, catalog | /hyperframes-registry |
capture | /product-launch-video (capture de site) et /media-use |
tts, transcribe, remove-background | /media-use |
beats, keyframes | /hyperframes-creative (planification des beats), /hyperframes-keyframes |
cloud, publish | npx remotion bundle + remotion lambda / remotion cloudrun, ou votre propre hébergement |
skills, docs, upgrade, doctor | ces compétences sont vendues dans ce dépôt ; npx remotion upgrade et npx remotion versions |
Si un fichier de workflow ou de référence vous demande encore d'exécuter npx hyperframes <quelquechose>, cette instruction est obsolète. Faites l'équivalent Remotion à partir du tableau ci-dessus et dites dans votre résumé que vous avez rencontré un pointeur obsolète, afin qu'il puisse être corrigé.