Communitygithub.com

remotion-to-capcut

Exportez une composition Remotion en tant que brouillon modifiable pour CapCut Desktop (calques de texte natifs, clips bruts avec images clés, pistes audio, calque graphique transparent). Utilisez-le lorsque l'utilisateur souhaite qu'une vidéo Remotion / générée par IA soit « ouvrable », « modifiable » ou « finalisable » dans CapCut, demande un projet/brouillon CapCut, ou lorsque vous créez une vidéo Remotion pour une personne qui édite dans CapCut.

Qu'est-ce que remotion-to-capcut ?

Ce skill permet de convertir une composition Remotion en un véritable brouillon CapCut modifiable, offrant aux utilisateurs la possibilité de retravailler manuellement ce qui a été généré par code. Il est actuellement limité à Windows et à CapCut Desktop. Le processus d'exportation inspecte le DOM rendu image par image et transforme les éléments Remotion en calques natifs CapCut : le texte dans des éléments DOM normaux devient des calques de texte natifs avec police, taille, couleur, dégradé, ombre, contour et espacement ; les transformations (translate, scale, rotate) et l'opacité deviennent des images clés ; les vidéos et audios locaux deviennent des clips bruts avec découpage et courbes de volume. Tout le reste (formes, logos, images, SVG) est fusionné en un calque vidéo graphique transparent au-dessus des séquences. L'outil offre des commandes simples (doctor, list, <CompositionId>) et gère les temps d'attente si CapCut est ouvert. Il est conçu pour les développeurs qui souhaitent offrir une expérience d'édition fluide entre le code Remotion et l'interface graphique de CapCut.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OybekWeb1/remotion-to-capcut/tree/HEAD/skills/remotion-to-capcut

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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-capture une fois CapCut fermé ; cela réutilise la capture et ne prend que quelques secondes.
  • À la fin, lisez out/capcut/<CompositionId>/summary.txt et 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 RemotionDans 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éoImages 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 :

  1. 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.
  2. 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.
  3. 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.
  4. Les séquences et l'audio doivent être des fichiers locaux dans public/ référencés avec staticFile(). Les URL distantes ne sont pas prises en charge.
  5. 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.
  6. 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.
  7. 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.

Skills associés