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 항목으로 변환할 수 있는 요소:
| Remotion | CapCut |
|---|---|
일반 DOM 요소의 텍스트 (<div>, <span>, <h1>…) | 네이티브 텍스트 레이어: 글꼴, 크기, 색상, 그라데이션, 그림자, 테두리, 자간/줄 간격 |
텍스트 또는 푸티지의 transform (이동/크기/회전) 및 opacity | 위치/크기/회전/불투명도 키프레임 |
public/ 내 파일의 <OffthreadVideo> / <Video> | Remotion에서 자른 대로 트리밍된 원본 클립 (속도 포함) |
public/ 내 파일의 <Audio> | 볼륨 커브가 있는 별도 오디오 클립 |
| 그 외 모든 요소 (카드, 도형, 로고, 이미지, SVG, 광선 누출) | 푸티지 위의 하나의 투명 "그래픽(알파)" 비디오 레이어 |
요령:
- 텍스트는 실제 텍스트로 유지하세요. SVG, 캔버스 또는 이미지 내부에 텍스트를 넣지 마세요. 요소당 하나의 텍스트 블록; 내부에 다른 색상/두께의
<span>스타일은 괜찮습니다. - Google Fonts를 사용하세요 (
@remotion/google-fonts). 일치하는 TTF가 자동으로 다운로드됩니다. 다른 글꼴은 CapCut 기본 글꼴로 대체됩니다. - transform + opacity로 애니메이션을 적용하세요. 블러 인, 클립-패스 공개, 글자별 효과는 CapCut 키프레임으로 존재하지 않습니다. 텍스트는 단순히 이동/페이드 처리됩니다. 숫자 계산은 최종값을 표시합니다.
- 푸티지와 오디오는
public/폴더의 로컬 파일이어야 하며staticFile()로 참조해야 합니다. 원격 URL은 지원되지 않습니다. - 사용자가 교체할 수 있도록 하려면 푸티지에 CSS 블러를 적용하지 마세요.
filter: blur()가 1.5px를 초과하는 클립은 그래픽 레이어에 굽혀집니다. - 배경 푸티지는 하나의 간격 없는 시퀀스로 배치하세요 (CapCut의 메인 트랙은 자기식입니다). 추가 클립은 상위 트랙에 놓습니다.
- 일부 요소를 의도적으로 픽셀로 유지하려면 (예: 복잡한 애니메이션 제목) 다음과 같이 감싸세요:
<div data-capcut="bake">…</div>.
사용자에게 한계 알리기
- 그래픽은 하나의 평면 레이어입니다. 텍스트를 길게 해도 뒤의 카드는 커지지 않습니다.
- 전환 프레임과 흐린 배경은 그래픽 레이어에 굽혀집니다.
- 텍스트 측정값은 CapCut 9.7에서 보정되었습니다. 다른 버전에서는 몇 픽셀 차이가 있을 수 있습니다.
- CapCut 드래프트 형식은 문서화되지 않았으며, CapCut 업데이트로 인해 이 기능이 작동하지 않을 수 있습니다.