Remotion → CapCut
remotion-to-capcut converte uma composição Remotion em um rascunho real do CapCut, para que o usuário possa continuar editando manualmente o que você construiu em código. Apenas Windows + CapCut desktop por enquanto.
Exportar
Execute a partir da pasta do projeto Remotion:
npx github:OybekWeb1/remotion-to-capcut doctor
Corrija qualquer item marcado com ✗ primeiro (CapCut deve estar instalado e aberto ao menos uma vez; Python 3.8+ deve estar no PATH).
npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<nome mostrado no CapCut>"
- Leva aproximadamente 1 minuto para cada 6 segundos de vídeo. Execute em segundo plano para vídeos longos.
- CapCut deve estar fechado enquanto o rascunho é escrito. Se estiver aberto, a ferramenta aguarda (
--wait <segundos>, padrão 600); peça ao usuário para fechar o CapCut — nunca o mate você mesmo (ele pode ter trabalho não salvo). Se atingir o tempo limite, execute novamente com--skip-captureapós o CapCut estar fechado; isso reutiliza a captura e leva apenas segundos. - Quando terminar, leia
out/capcut/<CompositionId>/summary.txte informe ao usuário o que se tornou textos e clipes nativos, depois: abra CapCut → Projetos → o nome do rascunho. - Iterando sobre uma parte:
--frames 0-299. Props da composição:--props props.json.
Escreva código Remotion que converta bem
O conversor inspeciona o DOM renderizado quadro a quadro. O que ele pode transformar em itens editáveis do CapCut:
| No Remotion | No CapCut |
|---|---|
Texto em elementos DOM normais (<div>, <span>, <h1>…) | Camada de texto nativa: fonte, tamanho, cor, gradiente, sombra, traçado, espaçamento entre letras/linhas |
transform (translate / scale / rotate) e opacity em texto ou filmagem | Quadros-chave de posição / escala / rotação / opacidade |
<OffthreadVideo> / <Video> com um arquivo de public/ | O clipe bruto, cortado onde o Remotion o cortou, com velocidade |
<Audio> de public/ | Clipes de áudio separados com curva de volume |
| Todo o resto (cartões, formas, logotipos, imagens, SVG, vazamentos de luz) | Uma camada de vídeo "gráficos (alfa)" transparente acima da filmagem |
Regras práticas:
- Mantenha o texto como texto real. Nada de texto dentro de SVG, canvas ou imagens. Um bloco de texto por elemento; variações de estilo dentro dele (
<span>com outra cor/peso) são aceitáveis. - Use Google Fonts (
@remotion/google-fonts). O TTF correspondente é baixado automaticamente; outras fontes usam a fonte padrão do CapCut como fallback. - Anime com transform + opacity. Efeitos de desfoque, revelação por clip-path e efeitos por letra não existem como quadros-chave do CapCut: o texto apenas se moverá/desaparecerá. Números animados mostram seu valor final.
- Filmagem e áudio devem ser arquivos locais em
public/referenciados comstaticFile(). URLs remotas não são suportadas. - Não desfoque filmagem com CSS se o usuário puder substituí-la: clipes com
filter: blur()acima de 1.5px permanecem fixos na camada de gráficos. - Coloque a filmagem de fundo como uma sequência sem intervalos (a trilha principal do CapCut é magnética); clipes extras vão em trilhas superiores.
- Para manter deliberadamente algo como pixels (um título animado complexo, por exemplo), envolva-o:
<div data-capcut="bake">…</div>.
Informe os limites ao usuário
- Os gráficos são uma camada plana: se eles alongarem um texto, o cartão atrás dele não cresce.
- Quadros de transição e fundos desfocados ficam incorporados na camada de gráficos.
- As métricas de texto foram calibradas no CapCut 9.7; outras versões podem estar alguns pixels desalinhadas.
- O formato de rascunho do CapCut não é documentado; uma atualização do CapCut pode quebrar isso.