Acim24/motion-video-audio

오디오가 포함된 모션 비디오 (출시 영화 스타일)

간략한 설명을 완성되고 마스터링된 MP4로 변환합니다: 출시 영화 스타일의 비주얼(따뜻한 종이 질감, 큰 세리프 헤드라인, 하나의 테라코타 악센트, 스스로 타이핑되는 채팅 데모, 승자를 보여주는 막대, 조용한 로고 아웃트로)과 완전한 사운드트랙을 포함합니다.

• 음성 내레이션 — 각 장면당 선택적 vo 한 줄을 edge-tts로 합성합니다. 장면 크기는 내레이션에 맞춰 자동 조정됩니다.
• 음악 — 정확한 타임라인에 맞춰 합성된 독창적인 앰비언트 스코어(패드, 서브, 피아노 아르페지오, 부드러운 펄스, 라이저, 로고 프레임에서 해소되는 히트). 코드로 생성되므로 로열티 프리입니다. 또는 사용자 자신의 트랙을 사용할 수 있습니다.
• 음향 효과 — 컷에서의 후후 소리, 단어/막대에서의 틱 소리, 답변이 타이핑되는 동안의 타이핑 소리, 승리 막대에서의 차임, 카운터 틱, 로고에서의 임팩트+반짝임 효과. 장면 컴포넌트 내에 배치되어 자동으로 동기화가 유지됩니다.
• 믹스 — 음악은 내레이션 아래로 음량이 낮아집니다(duck). 최종 파일은 -14 LUFS / -1.5 dBTP(소셜/유튜브 대상)로 정규화됩니다.

모든 콘텐츠는 단일 파일 src/storyboard.ts에 저장됩니다.

워크플로우

1. 브리프 파악. 다음을 확보하세요: 브랜드/제품 이름, 기억해야 할 한 가지 메시지, 2~5개의 지원 포인트, 실제 숫자(있는 경우), 대상 길이, 플랫폼, 내레이션 언어 및 음성 성별. 사용자가 충분히 제공했다면 질문하지 말고 가정을 명시하세요. 발명된 벤치마크 숫자를 실제로 제시하지 마세요. 대신 눈에 띄게 라벨이 붙은 자리 표시자(footnote)를 사용하거나 벤치마크를 건너뛰세요.

2. 스캐폴드.

   bash <skill-dir>/scripts/new_project.sh <target-dir>
   

   Node 18+, ffmpeg, 그리고 내레이션을 위해 PATH에 edge-tts(pipx install edge-tts)와 인터넷이 필요합니다. 먼저 which edge-tts ffmpeg로 확인하세요. edge-tts가 없고 설치할 수 없다면 vo 없이 빌드하고 사용자에게 알리세요.

3. 스토리보드 작성. references/style-guide.md(시각적 페이싱, 카피라이팅, 레시피)와 references/audio.md(내레이션 작성법, 음성, 음악/SFX/믹스 설정)를 읽으세요. 장면 유형(src/types.ts의 필드):

   유형	용도
   headline	운동 타이포그래피: 오프너, 섹션 제목, 마무리 문장. *단어* = 강조 이탤릭
   chat	UI 데모: 프롬프트 → 생각하는 점들 → 타이핑된 답변 (타이핑 소리 포함)
   benchmark	수평 막대, 하나의 highlight: true 막대 (도착 시 차임)
   bigNumber	큰 숫자 카운트업 (카운터 틱 + 임팩트)
   features	2~4개의 번호가 매겨진 기능 카드 (카드당 팝 효과)
   logo	아웃트로: 그려진 마크 또는 logoSrc, 이름, 태그라인, CTA (음악 히트가 여기서 발생)

   각 장면: 선택적 vo, 선택적 durationInFrames(30fps; 내레이션 장면에서 생략하면 자동 맞춤), 선택적 tone: 'light' | 'dark'. logo 장면에는 vo를 두지 마세요. 음악 히트가 여운을 남기도록 하세요.

4. 오디오 빌드 — 이 단계는 최종 타임라인도 고정합니다:

   cd <target-dir> && npm run audio
   

   출력된 타임라인(장면별 시작, 길이, 내레이션 길이, "(stretched to fit vo)" 경고)을 읽으세요. 장면이 많이 늘어난 경우 대신 vo를 줄이세요. 긴 내레이션은 느리고 지루한 장면을 만듭니다.

5. 시각적 QA (스틸은 빠르고 렌더링은 느림):

   npx tsc --noEmit
   bash <skill-dir>/scripts/contact_sheet.sh <target-dir> Main-16x9 /path/sheet-wide.png
   bash <skill-dir>/scripts/contact_sheet.sh <target-dir> Main-9x16 /path/sheet-tall.png
   

   PNG를 읽고 오버플로, 너무 빽빽한 배치, 장면당 두 개 이상의 악센트 사용 등을 수정하세요.

6. 청각 QA (귀 없이) — 렌더링 후 음량을 확인하고 믹스를 살펴보세요:

   ffmpeg -i out/video-16x9.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "I:|Peak:"
   ffmpeg -y -i out/video-16x9.mp4 -filter_complex "showwavespic=s=1800x300" -frames:v 1 /path/wave.png
   

   I ≈ -14 LUFS, Peak ≤ -1 dBFS를 기대하세요. 내레이션 버스트가 음악 배경 위에 명확하게 드러나야 하며, 가장 큰 상승은 로고에서 발생해야 합니다.

7. 렌더링 (audio → 두 포맷 → 마스터링 실행):

   npm run render     # → out/video-16x9.mp4, out/video-9x16.mp4
   

   약 30초 비디오 ≈ 1~2분. 경로, 길이, 사용된 음성, 그리고 라이브 프리뷰(소리 포함)를 위한 npm run studio를 언급하며 보고하세요.

사용자 정의

• 브랜드 색상/글꼴: src/theme.ts 토큰만 변경.
• 로고: public/ 디렉토리 내 파일, logoSrc: 'logo.svg'.
• 자체 음악: public/ 디렉토리 내 파일, audio.music: 'track.mp3' (사용자가 권리를 가진 트랙만). 자체 녹음 내레이션: references/audio.md 참조.
• 새로운 장면 유형/포맷/코덱: references/extending.md 참조.

브랜드 및 정직성 가드레일

스타일을 모방하되 브랜드는 모방하지 마세요: Anthropic(또는 다른 회사)의 로고를 재현하거나 사용자가 대표하지 않는 회사의 공식 릴리스인 것처럼 비디오를 제시하지 마세요. 합성 음성은 실제 식별 가능한 사람을 모방해서는 안 됩니다. 벤치마크: 실제 사용자 데이터이거나 명확하게 표시된 예시용 데이터여야 합니다.