Communitygithub.com

remotion-to-capcut

Exporta uma composição Remotion como um rascunho editável do CapCut Desktop (camadas de texto nativas, clipes brutos com quadros-chave, faixas de áudio, camada gráfica transparente). Use quando o usuário quiser que um vídeo feito com Remotion ou IA seja 'aberto', 'editável' ou 'finalizável' no CapCut, pedir um projeto/rascunho do CapCut ou estiver criando um vídeo Remotion para alguém que edita no CapCut.

O que é remotion-to-capcut?

Este skill converte uma composição Remotion em um rascunho real do CapCut, permitindo que o usuário continue editando manualmente o que você construiu em código. Atualmente funciona apenas no Windows com o CapCut desktop. A ferramenta inspeciona o DOM renderizado quadro a quadro e traduz elementos como textos nativos, clipes de vídeo/áudio e animações por transform e opacidade em itens editáveis do CapCut. É útil para desenvolvedores que criam vídeos com Remotion para usuários que preferem finalizar a edição no CapCut, oferecendo uma ponte entre o código e a edição visual.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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-capture após o CapCut estar fechado; isso reutiliza a captura e leva apenas segundos.
  • Quando terminar, leia out/capcut/<CompositionId>/summary.txt e 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 RemotionNo 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 filmagemQuadros-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:

  1. 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.
  2. Use Google Fonts (@remotion/google-fonts). O TTF correspondente é baixado automaticamente; outras fontes usam a fonte padrão do CapCut como fallback.
  3. 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.
  4. Filmagem e áudio devem ser arquivos locais em public/ referenciados com staticFile(). URLs remotas não são suportadas.
  5. 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.
  6. 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.
  7. 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.

Habilidades Relacionadas