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-captureuna vez que CapCut esté cerrado; eso reutiliza la captura y solo toma segundos. - Cuando termine, lee
out/capcut/<CompositionId>/summary.txte 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 Remotion | En 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 metraje | Fotogramas 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:
- 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. - Usa Google Fonts (
@remotion/google-fonts). El TTF coincidente se descarga automáticamente; otras fuentes se reemplazan por la fuente predeterminada de CapCut. - 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.
- El metraje y el audio deben ser archivos locales en
public/referenciados constaticFile(). No se admiten URL remotas. - 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. - 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.
- 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.