디오라마 프로모션 비디오은(는) 무엇을 하나요?
바이럴 영상 "5명의 클로드가 당신의 LinkedIn을 평가하다" 스타일의 세로형 비디오(1080×1920, 30fps, 약 30~50초)를 제작합니다. 블록 캐릭터가 등장하는 작은 무대에서 제품의 기능을 장면별로 연기하고, 자막이 단어별로 나타납니다. 모든 설정은 assets/template/에서 빌드한 Remotion 프로젝트의 단일 파일 src/video.json으로 제어합니다.
왜 이 형식이 효과적인지(속도감, 타이포그래피, 내러티브 구조)는 references/style-guide.md를, 모든 JSON 필드에 대한 설명은 references/scene-types.md를 참조하세요.
작업 흐름
1. 브리핑 받기 (누락된 정보만 질문)
- 홍보할 대상과 그것이 구체적으로 하는 일(출력물, 숫자, 단계).
- 사람들이 댓글에 남길 CTA 키워드(기본값
LINK)와 무료인지 여부. - 음성/자막 언어 — 사용자의 언어에 맞춥니다(인도네시아어 요청 → 인도네시아어 스크립트, 단, 사용자가 다른 의사를 밝히지 않은 경우). 배너는 사용자가 "IG 스타일"을 선호하는 경우 영어로 유지 가능.
- 음성 녹음: 사용자가 녹음 파일을 가지고 있는지? 없으면 자막만으로도 영상이 작동합니다. 사용자가 녹음할 수 있는 스크립트를 작성하고 나중에 동기화(5단계)할 것을 제안.
- 책상 위의 소품(프로필, 웹사이트, 이력서, 스토어…) — 합리적인 기본값이 존재.
- 색상 팔레트: 단색 회색조가 기본값(
"palette": "mono"). 사용자가 색상을 요청한 경우에만"warm"사용; 개별 토큰은theme에서 재정의 가능.
2. 먼저 스크립트를 표 형태로 작성
스타일 가이드의 흐름을 따르세요: 훅 → 메커니즘 → 문제점 → 결과 → 변화 → 보상 → 증거 → 무료 → 쉬움 → CTA. 912개 장면, 각 장면당 한 문장, 초당 약 2.7단어로 장면 길이는 2.54.5초. 각 문장을 보여주는 장면 유형을 선택하세요(예: "다섯 가지 의견"에 대한 문장 → 다섯 개의 표지판과 자동 카운터가 있는 lineup). 배너, 음성, 장면 유형이 포함된 표를 사용자에게 보여주고 조정합니다. 표를 변경하는 것은 저렴하지만, 다시 렌더링하는 것은 그렇지 않습니다.
3. 프로젝트 빌드
bash <skill-dir>/scripts/new_video.sh <project-dir> # 템플릿 복사 + npm install
그런 다음 승인된 스크립트를 기반으로 <project-dir>/src/video.json을 작성합니다. 해당 파일에 이미 있는 예제(참조 릴을 재현함)부터 시작하여 그 구조를 유지하세요.
레이아웃을 깔끔하게 유지하는 실용적인 제한: 배너 ≤ 30자, 표지판 1~2단어, card 줄 ≤ 약 25자 및 ≤ 7줄, list ≤ 4개 항목, hero ≤ 5자.
4. 전체 렌더링 전 시각적 확인
node <skill-dir>/scripts/preview_sheet.mjs <project-dir> # → out/sheet.jpg, 장면별 한 프레임
시트(이미지 읽기)를 확인합니다. 배너가 잘리지 않았는지, 자막이 주요 소품을 가리지 않는지, 카운터가 올바른 숫자를 표시하는지, 카드 내용이 넘치지 않는지 확인합니다. video.json을 수정하고 다시 실행합니다. 이 과정은 몇 초 걸리지만, 전체 렌더링은 몇 분이 걸립니다.
5. 음성 동기화 (오디오가 있을 때)
오디오를 <project-dir>/public/에 넣고 다음을 실행:
pip install faster-whisper # 한 번만, 없으면 설치
python3 <skill-dir>/scripts/word_timings.py <project-dir> voiceover.mp3 --lang id
이 명령은 video.json에 단어 타이밍(captions, voiceover)을 기록합니다. 그러면 장면 전환이 각 문장이 시작되는 지점에 정확히 맞춰집니다. 배경 음악: public/에 넣고 "music": "file.mp3"로 설정합니다(기본 볼륨 0.12). 오디오가 없으면 타이밍은 텍스트에서 추정됩니다.
6. 렌더링 및 전달
bash <skill-dir>/scripts/render.sh <project-dir> out/video.mp4
render.sh는 Remotion이 자체 브라우저를 다운로드할 수 없을 때(샌드박스 환경에서 자주 발생) 로컬 Chrome/Chromium으로 대체합니다. 45초 영상은 몇 분이 걸립니다. MP4를 전달하고, 참조 패턴에 따라 게시글 캡션도 함께 작성합니다:
댓글에 "LINK"를 남기시면 … 링크를 DM으로 보내드립니다. 댓글에 "LINK"를 남겨 링크를 받아보세요. #…
사용자가 실시간으로 조정하려면 프로젝트 내에서 npx remotion studio를 실행할 수 있습니다.
기존 영상 리스타일링
사용자가 영상을 제공하고 "이 스타일로" 변환을 요청하면, 기존 이야기와 음성은 유지하고 시각적 요소만 교체합니다:
bash <skill-dir>/scripts/caption_strips.sh <video> <work-dir>— 오디오(voiceover.m4a)를 추출하고 0.5초 간격으로 자막 밴드를 타임스탬프와 함께 타일 형식으로 만듭니다.overview.jpg도 생성합니다. whisper가 작동하면word_timings.py가 더 빠릅니다. 작동하지 않을 때(모델 다운로드 불가)는 스트립을 읽습니다. 각 스트립에서 강조 표시된 단어가 해당 타임스탬프에서 말하는 단어이므로 ±0.25초의 단어 타이밍을 얻을 수 있습니다. 먼저 프로브 프레임에서 밴드 위치를 확인합니다. 잘못된 크롭은 텍스트 조각만 보여줍니다.- 원본 영상에서 시각적 또는 주제가 바뀌는 지점(overview에서 확인 가능)을 기준으로 대본을 비트(beat)로 나눕니다. 한 비트 = 한 장면, 3~8초.
- 각 비트를 보여주는 장면 유형을 선택합니다. 설명 영상은
board(기호, "A → B", 오답 지우기),timeline(날짜, 인물),card(정의, 인용문, 강조된 용어),before-after(rewrite:false+stamp("MITOS", "FAKE")),spotlight(인물/공개), 그리고 마지막 클릭 유도 문구를 위한cta에 의존합니다. "voiceover"와{word,start,end}(절대 초 단위, 순서대로) 형식의"captions"배열이 포함된video.json을 작성합니다. 각 장면의text에는 해당 장면의 단어가 순서대로 정확히 포함되어야 합니다. 장면은 첫 단어가 시작되는 지점에서 시간이 계산됩니다. 장면별로시작 단어|시작 단어|…형식을 유지하고 둘 다 출력하는 작은 Python 스크립트가 가장 오류가 적습니다.assets/examples/restyle_asal_usul_x.py에 완전한 작업 예제(대수학에 x가 사용되는 이유에 대한 90초 인도네시아어 설명 영상, 16개 장면)가 있으니 그 구조를 복사하세요.- 미리보기 시트 → 수정 → 평소처럼 렌더링합니다. 배너는 영상의 언어로 설정할 수 있습니다.
JSON 외부 사용자 정의
- 색상/출연진:
video.json에서palette,theme및characters.mono에서는 모든 것이 회색조로 강제되므로, 사용자 정의theme색상은 명도에만 영향을 미칩니다. - 새로운 시각적 비트: 장면 유형 추가(단계는
references/scene-types.md끝부분 참조). useCurrentFrame()+interpolate/spring으로만 애니메이션; CSS 전환/애니메이션은 Remotion에서 렌더링되지 않습니다. 자막을 위해 y 1440–1620 영역을 비워두세요.
독창성
템플릿의 마스코트, 세트 및 소품은 일반적이고 독창적입니다. 이 상태를 유지하세요: 다른 제작자의 캐릭터, 로고 또는 영상을 영상에 복사하지 마십시오. 실제 브랜드 이름은 제품이 무엇과 작동하는지 설명할 때 텍스트(예: "LinkedIn")로 나타날 수 있습니다.