Remotion → CapCut
remotion-to-capcut convertit une composition Remotion en un véritable brouillon CapCut, afin que l'utilisateur puisse continuer à éditer manuellement ce que vous avez construit en code. Windows + CapCut Desktop uniquement pour l'instant.
Exportation
Exécutez depuis le dossier du projet Remotion :
npx github:OybekWeb1/remotion-to-capcut doctor
Corrigez d'abord tout ce qui est marqué ✗ (CapCut doit être installé et ouvert une fois ; Python 3.8+ doit être dans le PATH).
npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<nom affiché dans CapCut>"
- Prend environ 1 minute pour 6 secondes de vidéo. Exécutez-le en arrière-plan pour les longues vidéos.
- CapCut doit être fermé pendant l'écriture du brouillon. S'il est ouvert, l'outil attend (
--wait <secondes>, valeur par défaut 600) ; demandez à l'utilisateur de fermer CapCut — ne le tuez jamais vous-même (il peut avoir un travail non sauvegardé). En cas de dépassement du délai, relancez avec--skip-captureune fois CapCut fermé ; cela réutilise la capture et ne prend que quelques secondes. - À la fin, lisez
out/capcut/<CompositionId>/summary.txtet dites à l'utilisateur ce qui est devenu textes et clips natifs, puis : ouvrez CapCut → Projets → le nom du brouillon. - Pour itérer sur une tranche :
--frames 0-299. Propriétés de la composition :--props props.json.
Écrire du code Remotion qui se convertit bien
Le convertisseur inspecte le DOM rendu image par image. Ce qu'il peut transformer en éléments modifiables CapCut :
| Dans Remotion | Dans CapCut |
|---|---|
Texte dans des éléments DOM normaux (<div>, <span>, <h1>…) | Calque de texte natif : police, taille, couleur, dégradé, ombre, contour, espacement des lettres/lignes |
transform (translate / scale / rotate) et opacity sur du texte ou de la vidéo | Images clés de position / échelle / rotation / opacité |
<OffthreadVideo> / <Video> avec un fichier depuis public/ | Le clip brut, rogné là où Remotion l'a rogné, avec la vitesse |
<Audio> depuis public/ | Pistes audio séparées avec courbe de volume |
| Tout le reste (cartes, formes, logos, images, SVG, fuites de lumière) | Un calque vidéo « graphiques (alpha) » transparent au-dessus de la séquence |
Règles de base :
- Conservez le texte en tant que texte réel. Pas de texte dans SVG, canvas ou images. Un bloc de texte par élément ; les variations de style à l'intérieur (
<span>avec une autre couleur/poids) sont acceptables. - Utilisez Google Fonts (
@remotion/google-fonts). Le TTF correspondant est téléchargé automatiquement ; les autres polices reviennent à la police par défaut de CapCut. - Animez avec transform + opacity. Les effets de flou d'entrée, de révélations par clip-path et par lettre n'existent pas en tant qu'images clés CapCut : le texte se déplacera simplement ou s'estompera. Les nombres en comptage affichent leur valeur finale.
- Les séquences et l'audio doivent être des fichiers locaux dans
public/référencés avecstaticFile(). Les URL distantes ne sont pas prises en charge. - Ne floutez pas les séquences avec CSS si l'utilisateur doit pouvoir les remplacer : les clips avec
filter: blur()supérieur à 1,5 px restent intégrés dans le calque graphique. - Placez la séquence d'arrière-plan comme une séquence sans espace (la piste principale de CapCut est magnétique) ; les clips supplémentaires vont sur les pistes supérieures.
- Pour conserver délibérément quelque chose sous forme de pixels (un titre animé complexe, par exemple), enveloppez-le :
<div data-capcut="bake">…</div>.
Informer l'utilisateur des limites
- Les graphiques forment un seul calque plat : si l'utilisateur allonge un texte, la carte derrière ne grandit pas.
- Les images de transition et les arrière-plans flous sont intégrés dans le calque graphique.
- Les métriques de texte ont été calibrées sur CapCut 9.7 ; d'autres versions peuvent être décalées de quelques pixels.
- Le format de brouillon CapCut n'est pas documenté ; une mise à jour de CapCut peut casser cette conversion.