Communitygithub.com

remotion-to-capcut

Remotion 컴포지션을 편집 가능한 CapCut 데스크톱 드래프트(네이티브 텍스트 레이어, 키프레임이 있는 원본 클립, 오디오 트랙, 투명 그래픽 레이어)로 내보냅니다. 사용자가 CapCut에서 열거나, 편집하거나, 마무리할 수 있는 AI 기반 비디오가 필요할 때 사용합니다.

remotion-to-capcut란 무엇인가요?

이 스킬은 Remotion으로 제작된 비디오 컴포지션을 CapCut 데스크톱 앱에서 직접 열고 편집할 수 있는 드래프트 형식으로 변환합니다. 사용자가 코드로 만든 비디오를 수동으로 다듬고 싶을 때 유용하며, Windows 환경의 CapCut 데스크톱에서만 작동합니다. 변환 과정은 렌더링된 DOM을 프레임별로 분석하여 텍스트는 네이티브 텍스트 레이어로, `<OffthreadVideo>`나 `<Video>`는 원본 클립으로, `<Audio>`는 별도 오디오 트랙으로 변환하며, 그 외 요소들은 하나의 투명 그래픽 레이어로 합쳐집니다. 변환 품질을 높이기 위해 Remotion 코드 작성 시 텍스트는 실제 DOM 요소로 유지하고, 구글 폰트를 사용하며, `transform`과 `opacity`로 애니메이션을 적용하고, 모든 미디어 파일은 `public/` 폴더에 로컬로 위치해야 합니다. CapCut이 닫힌 상태에서만 드래프트를 쓸 수 있으며, 변환 시간은 6초당 약 1분 정도 소요됩니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Remotion → CapCut

remotion-to-capcut는 Remotion 컴포지션을 실제 CapCut 드래프트로 변환합니다. 코드로 만든 결과물을 사용자가 직접 편집할 수 있습니다. 현재 Windows + CapCut 데스크톱에서만 지원합니다.

내보내기

Remotion 프로젝트 폴더에서 다음 명령어를 실행하세요:

npx github:OybekWeb1/remotion-to-capcut doctor

먼저 표시된 ✗ 항목들을 모두 수정하세요 (CapCut이 설치되어 있고 한 번 이상 열려 있어야 하며, Python 3.8+가 PATH에 있어야 합니다).

npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<CapCut에 표시될 이름>"
  • 비디오 6초당 약 1분이 소요됩니다. 긴 비디오는 백그라운드에서 실행하세요.
  • CapCut이 반드시 닫혀 있어야 드래프트가 작성됩니다. 열려 있으면 도구가 대기합니다 (--wait <초>, 기본값 600). 사용자에게 CapCut을 닫으라고 요청하세요. 절대 직접 종료하지 마세요 (저장하지 않은 작업이 있을 수 있습니다). 시간이 초과되면 CapCut이 닫힌 후 --skip-capture와 함께 다시 실행하세요. 그러면 캡처를 재사용하며 몇 초 만에 완료됩니다.
  • 완료되면 out/capcut/<CompositionId>/summary.txt를 읽고 사용자에게 어떤 항목이 네이티브 텍스트와 클립으로 변환되었는지 알려준 후: CapCut을 열고 → 프로젝트 → 드래프트 이름으로 이동하세요.
  • 특정 구간만 반복 변환: --frames 0-299. 컴포지션 프롭스: --props props.json.

변환에 적합한 Remotion 코드 작성

변환기는 렌더링된 DOM을 프레임별로 검사합니다. 편집 가능한 CapCut 항목으로 변환할 수 있는 요소:

RemotionCapCut
일반 DOM 요소의 텍스트 (<div>, <span>, <h1>…)네이티브 텍스트 레이어: 글꼴, 크기, 색상, 그라데이션, 그림자, 테두리, 자간/줄 간격
텍스트 또는 푸티지의 transform (이동/크기/회전) 및 opacity위치/크기/회전/불투명도 키프레임
public/ 내 파일의 <OffthreadVideo> / <Video>Remotion에서 자른 대로 트리밍된 원본 클립 (속도 포함)
public/ 내 파일의 <Audio>볼륨 커브가 있는 별도 오디오 클립
그 외 모든 요소 (카드, 도형, 로고, 이미지, SVG, 광선 누출)푸티지 위의 하나의 투명 "그래픽(알파)" 비디오 레이어

요령:

  1. 텍스트는 실제 텍스트로 유지하세요. SVG, 캔버스 또는 이미지 내부에 텍스트를 넣지 마세요. 요소당 하나의 텍스트 블록; 내부에 다른 색상/두께의 <span> 스타일은 괜찮습니다.
  2. Google Fonts를 사용하세요 (@remotion/google-fonts). 일치하는 TTF가 자동으로 다운로드됩니다. 다른 글꼴은 CapCut 기본 글꼴로 대체됩니다.
  3. transform + opacity로 애니메이션을 적용하세요. 블러 인, 클립-패스 공개, 글자별 효과는 CapCut 키프레임으로 존재하지 않습니다. 텍스트는 단순히 이동/페이드 처리됩니다. 숫자 계산은 최종값을 표시합니다.
  4. 푸티지와 오디오는 public/ 폴더의 로컬 파일이어야 하며 staticFile()로 참조해야 합니다. 원격 URL은 지원되지 않습니다.
  5. 사용자가 교체할 수 있도록 하려면 푸티지에 CSS 블러를 적용하지 마세요. filter: blur()가 1.5px를 초과하는 클립은 그래픽 레이어에 굽혀집니다.
  6. 배경 푸티지는 하나의 간격 없는 시퀀스로 배치하세요 (CapCut의 메인 트랙은 자기식입니다). 추가 클립은 상위 트랙에 놓습니다.
  7. 일부 요소를 의도적으로 픽셀로 유지하려면 (예: 복잡한 애니메이션 제목) 다음과 같이 감싸세요: <div data-capcut="bake">…</div>.

사용자에게 한계 알리기

  • 그래픽은 하나의 평면 레이어입니다. 텍스트를 길게 해도 뒤의 카드는 커지지 않습니다.
  • 전환 프레임과 흐린 배경은 그래픽 레이어에 굽혀집니다.
  • 텍스트 측정값은 CapCut 9.7에서 보정되었습니다. 다른 버전에서는 몇 픽셀 차이가 있을 수 있습니다.
  • CapCut 드래프트 형식은 문서화되지 않았으며, CapCut 업데이트로 인해 이 기능이 작동하지 않을 수 있습니다.

관련 스킬