remotion-video은(는) 무엇을 하나요?
사용자의 아이디어를 입력받아 MP4 파일을 반환합니다. 이 파일 옆에 있는 키트가 실제 작업을 수행합니다: kit/new-video.sh가 프로젝트를 생성하고, narrate.py가 대본을 오디오와 타이밍으로 변환하며, Remotion 프로젝트가 이를 렌더링합니다.
이 파일 옆에 kit 폴더가 없다면, 스킬이 복사되면서 누락된 것입니다. https://github.com/anujkapoor-arch/video-skills 저장소를 클론하고 해당 kit 폴더를 사용하세요.
시작하기 전에
다음 항목들을 확인하고, 누락된 항목이 있으면 명확한 메시지와 함께 중단하세요:
node --version,python3 --version,ffmpeg -version. 이 키트는 Node 24, Python 3, ffmpeg 8에서 테스트되었습니다.- 환경 변수에
ELEVENLABS_API_KEY가 설정되어 있거나, 사용자가 프로젝트의.env파일에 직접 추가할 준비가 되어 있어야 합니다. 무음 또는 무료 모드는 없습니다. 키를 출력하거나 커밋하지 마세요. - Remotion 라이선스. 개인 및 최대 3명 직원의 기업은 무료입니다. 더 큰 기업은 유료 Company License(remotion.dev/docs/license)가 필요합니다. 사용자에게 한 번 알려주세요. Remotion이 적합하지 않다면 MIT 라이선스인
revideo-video스킬을 사용하세요.
단계
1. 아이디어를 대본으로 만들기
추론할 수 없는 내용만 물어보세요: 주제, 대상 시청자, 채널 이름. 그런 다음 대본은 직접 작성하세요.
- 4
7개의 장면, 총 2045초 분량. 사람은 초당 약 2.5단어를 말합니다. hook으로 시작하고cta로 끝냅니다. 중간에points,stat,bars를 사용하세요.- 각
say는 한두 개의 짧은 문장으로, 듣기 편하게 작성하세요. 숫자는 단어로 표기하세요. - 화면에 표시되는 모든 숫자는 사용자가 제공했거나 이름을 밝힐 수 있는 출처가 있어야 합니다. 출처가 없으면 물어보세요. 절대 통계를 지어내지 마세요.
- 각 항목에 큐 워드(
at)를 선택하여 시각 자료가 음성의 특정 단어에 맞춰지도록 하세요.
전체 필드 목록은 kit/common/SCRIPT.md에 있습니다. 대본을 작성하기 전에 이 파일을 읽으세요.
2. 프로젝트 생성하기
<이 스킬의 폴더>/kit/new-video.sh remotion <새-폴더>
cd <새-폴더>
npm install
npm install은 약 20초 정도 걸립니다. 첫 번째 렌더링 시 node_modules에 Chrome Headless Shell(약 470MB)도 다운로드합니다.
3. script.json 작성, 확인 후 음성 비용 지불
예제 script.json을 사용자의 대본으로 대체한 후:
python3 narrate.py --check # 유효성 검사 후 문자 수 출력, API 호출 없음
사용자에게 음성 대사와 문자 수를 보여주고, 다음 명령을 실행하기 전에 동의를 받으세요. ElevenLabs는 문자당 비용을 청구합니다.
python3 narrate.py # public/narration.wav 및 src/spec.json 생성
각 장면의 시작 시간과 길이를 출력합니다. 대사는 .tts-cache/에 캐시되므로, 편집 후 다시 실행해도 변경된 대사에 대해서만 비용이 청구됩니다.
4. 전체 렌더링 전에 스틸 이미지 확인하기
스틸 이미지 하나는 약 4초, 전체 렌더링은 동영상 길이만큼 걸립니다.
npx remotion still src/index.ts Video out/check.png --frame=150
프레임 = 초 x 30입니다. 각 장면 내에서 마지막 큐 이후 약 1초 지점에 스틸 이미지 하나를 렌더링하여 확인하세요. 텍스트가 카드에 잘 맞고, 캡션이나 마스코트와 겹치는 부분이 없으며, y=1620 아래(쇼츠/릴스 UI가 덮는 영역)에 중요한 내용이 없는지 확인하세요.
5. 렌더링
npm run render # -> out/video.mp4
npm run studio # 선택 사항: 타임라인과 핫 리로드로 미리보기
6. 결과 보고
파일에 대해 ffprobe를 실행하고 사용자에게 길이, 크기 및 위치를 알려주세요. 확인한 사항(스틸 이미지)과 확인하지 않은 사항(오디오 청취 또는 모션 확인 불가)을 말씀드리세요. 사용자에게 소리를 켜고 한 번 시청해 달라고 요청하세요.
변경하기
| 변경 사항 | 수정 위치 |
|---|---|
| 색상, 채널 이름, 푸터, 캡션 켜기/끄기, 마스코트 켜기/끄기 | script.json을 수정한 후 python3 narrate.py 실행(무료, 오디오는 캐시됨) |
| 음성 | script.json의 voice.id 또는 ELEVENLABS_VOICE_ID 환경 변수. 새 음성은 모든 대사에 대해 다시 비용이 청구됩니다. |
| 폰트 | .ttf 파일을 public/fonts/에 넣고, src/fonts.ts에 등록한 후 src/util.ts의 FONT를 변경 |
| 장면 유형 레이아웃 | src/scenes.tsx의 해당 컴포넌트 |
| 헤더, 카드, 캡션, 말풍선, 종이폭죽 | src/Video.tsx |
| 마스코트 | src/Mascot.tsx |
장면 종류 추가하기
{s: Scene}을 입력으로 받고 내용을<Layer s={s}>로 감싸는 컴포넌트를src/scenes.tsx에 작성합니다.- 동일 파일 하단의
KINDS와src/util.ts의kind유니온에 추가합니다. narrate.py의KINDS에 필수 필드와 함께 추가합니다.
마스코트 교체하기
캐릭터의 SVG를 src/Mascot.tsx로 JSX 형태로 포팅하세요. .svg 파일을 직접 로드하지 마세요. 프레임별로 구동되는 다섯 가지 요소를 유지하세요: open에 따른 입 높이, blink에 따른 눈 scaleY, 동공 오프셋, 눈썹 오프셋, 기울어지는 머리 그룹. 나중에 SVG가 변경되면 포팅을 다시 해야 합니다.
Remotion 렌더링을 올바르게 유지하는 규칙
- 화면의 모든 것은 현재 프레임의 함수여야 합니다.
useState, CSS 전환,setTimeout,Math.random()을 사용하지 마세요. Remotion은 프레임을 병렬로 그리고 순서에 상관없이 렌더링하므로, 메모리를 사용하는 모든 것은 오작동합니다.remotion의random(seed)를 사용하세요. - 모든 타이밍은
spec.json에서 가져옵니다. 시간을 초 단위로 하드코딩하지 마세요.s.start,item.t또는 단어의t를 읽어서 새로운 내레이션이 코드 변경 없이 비디오 타이밍을 다시 조정할 수 있게 하세요. - 폰트는
src/fonts.ts에서delayRender뒤에 로드됩니다. 그렇지 않으면 폰트가 준비되기 전에 프레임이 캡처될 수 있습니다. - 브라우저가 렌더링 시점에 로드하는 파일(오디오, 폰트, 이미지)은
public/에 있으며staticFile()로 참조됩니다. - HTML은 긴 텍스트를 줄 바꿈하지만 크기를 줄이지는 않습니다. 스타터는 문자 수에 따라 폰트 크기를 선택합니다. 텍스트를 추가하는 경우에도 동일하게 처리하지 않으면 카드를 넘칠 수 있습니다.
- 스프링은
spring({frame: frame - at * fps, fps, config})입니다.util.ts의pop()헬퍼가 이를 감쌉니다. - 립싱크는 단어 타이밍(
util.ts의mouthOpen)에서 비롯되며, 오디오 분석은 사용하지 않습니다. - 동영상 길이는 전체 프레임으로 반올림되므로, MP4는
spec.total보다 최대 1/30초 더 길 수 있습니다.
테스트 머신(Apple M2, 8GB RAM)의 수치
- 25초 동영상: 렌더링 26.5초, 파일 크기 4.9MB.
node_modules: 설치 후 240MB, 첫 렌더링 후 약 950MB(Chrome Headless Shell 및 webpack 캐시 포함).