Communitygithub.com

remotion-to-capcut

Exporta una composición de Remotion como un borrador editable de CapCut Desktop (capas de texto nativas, clips con fotogramas clave, pistas de audio, capa gráfica transparente). Úsalo cuando el usuario quiera que un video hecho con Remotion/IA sea 'abrible', 'editable' o 'finalizable' en CapCut, pida un proyecto/borrador de CapCut, o estés creando un video de Remotion para alguien que edita en CapCut.

¿Qué es remotion-to-capcut?

Esta herramienta convierte composiciones de Remotion en borradores reales de CapCut, permitiendo a los usuarios editar manualmente lo que se generó con código. Funciona solo en Windows con CapCut Desktop. El proceso exporta la composición, analiza el DOM renderizado fotograma a fotograma, y traduce elementos como texto, transformaciones y clips a capas nativas de CapCut con fotogramas clave, pistas de audio y una capa gráfica transparente para el resto. Es ideal para desarrolladores que crean videos con Remotion y necesitan que un editor en CapCut pueda retocar el resultado final, manteniendo la fidelidad de textos, animaciones y clips. Limitaciones importantes: los gráficos se convierten en una capa plana, las transiciones y desenfoques se hornean, y las métricas de texto pueden variar ligeramente según la versión de CapCut. Además, el formato de borrador de CapCut no está documentado oficialmente, por lo que una actualización podría romper la compatibilidad.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Remotion → CapCut

remotion-to-capcut convierte una composición de Remotion en un borrador real de CapCut, para que el usuario pueda seguir editando a mano lo que construiste en código. Solo Windows + CapCut Desktop por ahora.

Exportar

Ejecutar desde la carpeta del proyecto de Remotion:

npx github:OybekWeb1/remotion-to-capcut doctor

Corregir primero todo lo marcado con ✗ (CapCut debe estar instalado y abierto al menos una vez; Python 3.8+ debe estar en PATH).

npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<nombre mostrado en CapCut>"
  • Tarda aproximadamente 1 minuto por cada 6 segundos de video. Ejecútalo en segundo plano para videos largos.
  • CapCut debe estar cerrado mientras se escribe el borrador. Si está abierto, la herramienta espera (--wait <segundos>, por defecto 600); pide al usuario que cierre CapCut — nunca lo cierres tú mismo (podría tener trabajo sin guardar). Si se agota el tiempo, vuelve a ejecutar con --skip-capture una vez que CapCut esté cerrado; eso reutiliza la captura y solo toma segundos.
  • Cuando termine, lee out/capcut/<CompositionId>/summary.txt e informa al usuario qué se convirtió en textos nativos y clips, luego: abre CapCut → Proyectos → el nombre del borrador.
  • Iterar sobre un segmento: --frames 0-299. Props de la composición: --props props.json.

Escribir código de Remotion que se convierta bien

El convertidor inspecciona el DOM renderizado fotograma a fotograma. Lo que puede convertir en elementos editables de CapCut:

En RemotionEn CapCut
Texto en elementos DOM normales (<div>, <span>, <h1>…)Capa de texto nativa: fuente, tamaño, color, degradado, sombra, trazo, espaciado entre letras/líneas
transform (translate / scale / rotate) y opacity en texto o metrajeFotogramas clave de posición / escala / rotación / opacidad
<OffthreadVideo> / <Video> con un archivo de public/El clip original, recortado donde Remotion lo recortó, con velocidad
<Audio> desde public/Pistas de audio separadas con curva de volumen
Todo lo demás (tarjetas, formas, logotipos, imágenes, SVG, fugas de luz)Una capa de video "gráficos (alfa)" transparente sobre el metraje

Reglas prácticas:

  1. Mantén el texto como texto real. Nada de texto dentro de SVG, canvas o imágenes. Un bloque de texto por elemento; los estilos internos (<span> con otro color/grosor) están bien.
  2. Usa Google Fonts (@remotion/google-fonts). El TTF coincidente se descarga automáticamente; otras fuentes se reemplazan por la fuente predeterminada de CapCut.
  3. Anima con transform + opacity. Las apariciones con desenfoque, revelaciones con clip-path y efectos por letra no existen como fotogramas clave en CapCut: el texto simplemente se moverá/desvanecerá. Los números en conteo muestran su valor final.
  4. El metraje y el audio deben ser archivos locales en public/ referenciados con staticFile(). No se admiten URL remotas.
  5. No difumines el metraje con CSS si el usuario debería poder reemplazarlo: los clips con filter: blur() por encima de 1.5px se hornean en la capa de gráficos.
  6. Coloca el metraje de fondo como una secuencia sin espacios (la pista principal de CapCut es magnética); los clips adicionales van en pistas superiores.
  7. Para mantener intencionadamente algo como píxeles (un título animado complejo, por ejemplo), envuélvelo: <div data-capcut="bake">…</div>.

Informa al usuario de los límites

  • Los gráficos son una capa plana: si alargan un texto, la tarjeta detrás no crece.
  • Los fotogramas de transición y los fondos desenfocados están horneados en la capa de gráficos.
  • Las métricas de texto se calibraron en CapCut 9.7; otras versiones pueden diferir unos píxeles.
  • El formato de borrador de CapCut no está documentado; una actualización de CapCut puede romper esto.

Skills relacionados