비디오 크리에이터은(는) 무엇을 하나요?
제품, 서비스, 이벤트, 브랜드를 위한 전문 시네마틱 비디오 제작. 모든 출력물은 1920×1080 MP4 포맷으로 음성 해설, 동기화된 자막, 풍부한 애니메이션, 다양한 장면 전환 효과를 포함합니다.
빠른 시작 (3개 명령어)
# 1. 프로젝트 스캐폴딩
npx --yes [email protected] init my-video
# 2. 음성 해설 생성
python3 -c "from kokoro_onnx import Kokoro; import soundfile as sf; k=Kokoro('models/kokoro-v1.0.onnx','models/voices-v1.0.bin'); s,r=k.create(open('script.txt').read(),voice='bm_george',speed=0.92,lang='en-gb'); sf.write('narration.wav',s,r)"
# 3. 자막을 위한 전사
npx --yes [email protected] transcribe narration.wav --model small.en
# 4. 렌더링
npx --yes [email protected] render
프로덕션 파이프라인
항상 다음 순서를 따르세요 — 단계를 건너뛰지 마세요:
1. 브리핑 → 대상, 플랫폼, 길이, 톤
2. 스크립트 → 내레이션 작성 (~2.5 wps), 첫 후크
3. design.md → 브랜드 색상, 폰트, 모션 에너지
4. 음성 해설 → npx hyperframes tts 또는 python kokoro_onnx 직접 사용
5. 전사 → npx hyperframes transcribe → transcript.json
6. 계획 → HTML 작성 전 장면 리듬 선언
7. 빌드 → 레이아웃 우선 → GSAP 애니메이션
8. 린트 → npx hyperframes lint (오류 0 필수)
9. 검증 → npx hyperframes validate --no-contrast
10. 렌더링 → npx hyperframes render
1단계 — 프로덕션 브리핑
질문하거나 (컨텍스트에서 추론):
- 주제: 제품 / 서비스 / 이벤트 / 브랜드?
- 대상: 기업, 개발자, 소비자, 투자자?
- 플랫폼: 소셜 (15초), 웹사이트 히어로 (30초), 제품 데모 (60초), 프레젠테이션?
- 톤: 권위적, 에너지 넘치는, 따뜻한, 드라마틱, 기술적?
- 에셋: 브랜드 색상, 로고, 스크린샷, 기존 카피?
대상별 시작점은 references/brief-templates.md를 참조하세요.
2단계 — 스크립트 작성
속도 공식: 자연스러운 속도에서 초당 2.5단어
- 15초 → 약 37단어
- 30초 → 약 75단어
- 60초 → 약 150단어
구조: 후크 → 문제/스토리 → 증명 → CTA
후크 패턴 (일반적인 시작 금지):
- 대담한 주장: "현대 공학을 움직이는 금융 인프라."
- 대비: "당신의 에이전트는 배포되었지만 아무도 모니터링하지 않습니다."
- 질문: "당신의 전체 팀(인간과 AI)이 하나처럼 움직인다면?"
- 숫자 충격: "기업 AI 프로젝트의 40%가 거버넌스에서 실패합니다."
대상별 음성 톤:
- 기업 → 선언적, 신중한,
bm_george목소리 - 개발자 → 직접적, 기술적,
am_adam목소리 - 소비자 → 따뜻한, 스토리 중심의,
af_heart목소리 - 스타트업/에너지 → 펀치감 있는, 빠른,
af_sky목소리
스크립트에서 숫자는 단어로 작성하세요 (TTS는 문자 그대로 읽음): 10x → ten times, $2.3T → nearly two point three trillion dollars.
비디오 유형별 전체 스크립트 예시는 references/script-patterns.md를 참조하세요.
3단계 — 디자인 시스템 (design.md)
HTML을 작성하기 전에 항상 design.md를 만드세요. 이는 브랜드 계약을 정의합니다.
필수 필드:
colors:
bg: "#0A0A0A" # 기본 배경 (어둡거나 밝음)
accent: "#E63946" # 주요 액션 색상
accent2: "#10b981" # 보조 액션 색상
text: "#FFFFFF"
muted: "#999999"
border: "#141111"
typography:
headline: { fontFamily: "Space Grotesk", fontWeight: 800 }
label: { fontFamily: "Space Mono", fontWeight: 700 }
motion:
energy: high | medium | low
transition: glitch | blur | push | cover
시각 스타일 선택기 (전체 YAML 토큰은 references/visual-styles.md 참조):
| 스타일 | 최적 대상 | 특징 |
|---|---|---|
| Deconstructed | 기술, SaaS, 보안 | 스캔 라인, 거친 테두리, Space Grotesk/Mono |
| Maximalist | 런칭, 발표 | 거대한 타입이 프레임을 채움, 강렬한 색상 |
| Velvet Standard | 기업, 럭셔리 | 넓은 자간, 여유로운 공간 |
| Data Drift | AI, ML, 핀테크 | 파티클 필드, 얇은 미래형 산세리프 |
| Shadow Cut | 드라마틱한 공개, 보안 | 거의 단색 + 피 악센트 |
| Folk Frequency | 소비자, 커뮤니티 | 대담한 색상, 바운스, 패턴 |
4단계 — 음성 해설 생성
npx 사용 (가능할 때 선호)
npx --yes [email protected] tts script.txt --voice bm_george --output narration.wav --speed 0.92
Python 직접 사용 (npx 실패 시 대체)
# 최초 실행: 모델 다운로드 (~340MB 전체, 캐시됨)
curl -L -o models/kokoro-v1.0.onnx \
https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx
curl -L -o models/voices-v1.0.bin \
https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin
# 생성
python3 << 'EOF'
from kokoro_onnx import Kokoro
import soundfile as sf
k = Kokoro("models/kokoro-v1.0.onnx", "models/voices-v1.0.bin")
text = open("script.txt").read().strip()
samples, rate = k.create(text, voice="bm_george", speed=0.92, lang="en-gb")
sf.write("narration.wav", samples, rate)
print(f"생성됨: {len(samples)/rate:.1f}초")
EOF
음성 가이드:
| 음성 | 특성 | 사용처 |
|---|---|---|
bm_george | 권위적인 영국 남성 | 기업, B2B, 기조연설 |
bf_emma | 또렷한 영국 여성 | 튜토리얼, 문서, 프리미엄 |
am_michael | 자신감 있는 미국 남성 | 마케팅, 프로모션, SaaS |
am_adam | 중립적인 미국 남성 | 개발자 도구, 설명 영상 |
af_heart | 따뜻한 미국 여성 | 소비자, 웰빙, 개인화 |
af_sky | 에너지 넘치는 미국 여성 | 소셜 광고, 런칭, 라이프스타일 |
의존성 설치 (한 번만):
pip install kokoro-onnx soundfile
5단계 — 전사 (단어 수준 자막)
npx --yes [email protected] transcribe narration.wav --model small.en
# → 단어별 타임스탬프가 포함된 transcript.json 생성
출력 형식:
[
{ "text": "Enterprise", "start": 0.03, "end": 0.82 },
{ "text": "teams", "start": 0.82, "end": 1.18 }
]
타임스탬프 사용처:
- 장면 전환을 음성 문장 경계에 맞춤
- 단어별 자막 애니메이션 구동 (단어당 팝인)
- 시각적 강조(버스트 라인, 하이라이트)를 주요 명사에 동기화
6단계 — 장면 리듬 계획
HTML을 작성하기 전에 리듬을 선언하세요. 패턴 이름을 지정하세요:
SLAM → breathe → CASCADE → PUNCH → CTA (제품 런칭)
PAIN → GLIMPSE → PROOF → CONVICTION (문제/해결)
HOOK → STORY → PROOF → SCALE → CTA (기업 피치)
TEASE → REVEAL → DETAIL → DETAIL → CTA (기능 쇼케이스)
장면 타이밍 템플릿 (30초 기업):
장면 1: 문제/후크 0–7초 (내레이션 문장 1-2)
장면 2: 플랫폼 소개 7–10초 (문장 3)
장면 3: 기능 데모 10–17초 (문장 4-5)
장면 4: 증명/통계 17–21초 (문장 6)
장면 5: 규모 21–28초 (문장 7-8)
장면 6: CTA 28–32초 (문장 9)
길이별 타이밍 템플릿은 references/scene-timing.md를 참조하세요.
7단계 — 컴포지션 빌드
HTML 구조 (필수)
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<style>
body { margin:0; width:1920px; height:1080px; overflow:hidden; background:#0A0A0A; }
.scene { position:absolute; top:0; left:0; width:1920px; height:1080px; overflow:hidden; }
#s1 { z-index:1; background:#0A0A0A; } /* 장면 1 — 기본 표시 */
#s2 { z-index:2; background:#0A0A0A; opacity:0; } /* 나머지는 숨김 */
</style>
</head>
<body>
<div id="root" data-composition-id="main" data-width="1920" data-height="1080"
data-start="0" data-duration="32">
<!-- 오디오 (항상 비디오와 분리) -->
<audio id="vo" data-start="0" data-duration="31.1" data-track-index="10"
data-volume="1" src="narration.wav"></audio>
<!-- 전환 오버레이 (항상 모든 장면 위에) -->
<div id="ov-r" style="position:absolute;top:0;left:0;width:1920px;height:1080px;z-index:80;background:#E63946;opacity:0;pointer-events:none"></div>
<!-- 장면들 -->
<div id="s1" class="scene"><!-- 콘텐츠 --></div>
<div id="s2" class="scene"><!-- 콘텐츠 --></div>
</div>
<script>
window.__timelines = window.__timelines || {};
var tl = gsap.timeline({ paused: true });
// ... 애니메이션 ...
window.__timelines["main"] = tl;
</script>
</body>
</html>
애니메이션 전 레이아웃 (변경 불가)
- 먼저 순수 CSS로 각 장면의 최종 상태를 구축하세요.
- 콘텐츠 컨테이너:
display:flex; flex-direction:column; padding:120px 160px; width:100%; height:100%; - 콘텐츠에는 절대
position:absolute; top:Npx를 사용하지 마세요 — 장식 요소에만 사용하세요. - 레이아웃이 확인된 후
gsap.fromTo()를 추가하세요. npx hyperframes inspect를 실행하여 오버플로우가 없는지 확인하세요.
GSAP 규칙
// 장면 내에서 결정론적 탐색을 위해 항상 fromTo(from 대신) 사용
// tl.fromTo("#el", { opacity:0, y:40 }, { opacity:1, y:0, duration:0.5, ease:"back.out(2)" }, 1.2);
// 주변 모션을 위해 절대 gsap.to()를 직접 사용하지 마세요 — 반드시 tl에 사용
// tl.to("#glow", { scale:1.08, yoyo:true, repeat:4, duration:2, ease:"sine.inOut" }, 0);
// repeat:-1 금지 (캡처 엔진 중단) — 유한 반복 계산
// 4초 비트의 경우: Math.ceil(4 / 2) = 2 사이클
// tl.to("#pulse", { scale:1.1, yoyo:true, repeat:3, duration:2, ease:"sine.inOut" }, 0);
// 장면 종료 하드 킬
// tl.set("#s1", { opacity:0, visibility:"hidden" }, exitTime);
// 항상 등록
window.__timelines["main"] = tl;
장면 밀도 요구 사항
모든 장면에는 반드시 다음이 있어야 합니다:
- 배경 레이어: 방사형 글로우 + 그리드/패턴 + 고스트 텍스트 + 스캔라인 (2–5개 요소)
- 콘텐츠 레이어: 헤드라인 + 부제목 + 지원 요소 (3–5개 요소)
- 전경 악센트: 코너 마크 + 구분선 + 레이블/배지 (3개 이상 요소)
- 총합: 최소 8–10개 시각 요소
장면별 요소 체크리스트는 references/scene-density.md를 참조하세요.
전환 라이브러리
전체 코드는 references/transitions.md를 참조하세요. 빠른 선택:
| 에너지 | 전환 | 코드 패턴 |
|---|---|---|
| 혼돈 → 명확 | 블러 크로스페이드 | tl.to(old, {filter:"blur(14px)",scale:1.04,opacity:0,duration:0.5}) |
| 레벨 업 | 세로 푸시 | tl.to(old,{y:-1080,duration:0.45,ease:"power3.inOut"}, T) |
| 다음 항목 | 슬라이드 왼쪽 푸시 | tl.to(old,{x:-1920,duration:0.45,ease:"power3.inOut"}, T) |
| 하드 컷 | 검은색 딥 | tl.to("#ov-k",{opacity:1,duration:0.25}) 다음 tl.set(new,{opacity:1}) |
| 큰 순간 | 계단식 컬러 블록 | 빨간색과 초록색 블록이 슬라이드하며 아래 장면 교체 |
| 산업적 | 글리치 | RGB 오버레이 지터, ±40px로 6프레임, 0.35초 |
마지막 장면의 페이드 투 블랙을 제외하고는 전환 전에 종료 애니메이션을 사용하지 마세요.
애니메이션 기법 라이브러리
1. Canvas 2D 파티클 필드 (배경 주변 분위기)
<canvas id="bg-canvas" width="1920" height="1080" style="position:absolute;top:0;left:0;z-index:1"></canvas>
<script>
var c=document.getElementById("bg-canvas"),ctx=c.getContext("2d");
function h(x,y){var n=x*374761393+y*668265263;n=(n^(n>>13))*1274126177;return((n^(n>>16))&0x7fffffff)/0x7fffffff}
var N=120, pts=[];
for(var i=0;i<N;i++) pts.push({bx:h(i,0)*1920,by:h(i,1)*1080,vx:(h(i,3)-0.5)*0.3,vy:(h(i,4)-0.5)*0.2,r:1+h(i,2)*2.5});
var px={t:0};
tl.to(px,{t:DURATION,duration:DURATION,ease:"none",onUpdate:function(){
var ti=px.t;
ctx.clearRect(0,0,1920,1080);
// 그리드
ctx.strokeStyle="rgba(230,57,70,0.04)"; ctx.lineWidth=1;
for(var gx=0;gx<1920;gx+=160){ctx.beginPath();ctx.moveTo(gx,0);ctx.lineTo(gx,1080);ctx.stroke()}
for(var gy=0;gy<1080;gy+=120){ctx.beginPath();ctx.moveTo(0,gy);ctx.lineTo(1920,gy);ctx.stroke()}
// 파티클
for(var i=0;i<N;i++){
var p=pts[i],x=(p.bx+p.vx*ti*60)%1920,y=(p.by+p.vy*ti*60)%1080;
if(x<0)x+=1920;if(y<0)y+=1080;
ctx.fillStyle="rgba(230,57,70,"+(0.15+0.1*h(i,Math.floor(ti*6)))+")";
ctx.fillRect(x-p.r/2,y-p.r/2,p.r,p.r);
}
}},0);
</script>
2. SVG 스크리블 밑줄
<span style="position:relative;display:inline-block">
핵심 문구
<svg style="position:absolute;left:0;bottom:-8px;width:100%;height:20px" viewBox="0 0 500 20" preserveAspectRatio="none">
<path id="scr" fill="none" stroke="#E63946" stroke-width="3" stroke-linecap="round"
stroke-dasharray="800" stroke-dashoffset="800"
d="M0,10 Q62,0 125,10 Q187,20 250,10 Q312,0 375,10 Q437,20 500,10"/>
</svg>
</span>
<script>
// DOM에 경로 요소가 존재한 후:
var p=document.getElementById("scr"), l=p.getTotalLength();
gsap.set(p,{strokeDasharray:l,strokeDashoffset:l});
tl.to("#scr",{strokeDashoffset:0,duration:0.7,ease:"power1.inOut"}, START);
</script>
3. 음성 동기화 단어별 키네틱 헤드라인
<div id="headline">
<span class="w" id="w0">Ship</span>
<span class="w" id="w1">faster.</span>
<span class="w" id="w2">CyberAgent.</span>
</div>
<script>
// transcript.json의 단어 시작 시간
var times = [0.0, 0.3, 0.7];
var eases = ["back.out(2.5)", "expo.out", "back.out(3)"];
var dirs = [{y:60,rotation:4}, {y:80,scale:0.7}, {scale:0.5,rotation:-5}];
times.forEach(function(t,i){
tl.fromTo("#w"+i,
Object.assign({opacity:0},dirs[i]),
Object.assign({opacity:1,y:0,scale:1,rotation:0,duration:0.45,ease:eases[i]},{}),
t);
});
</script>
4. 버스트 라인 (통계 공개)
<div style="position:relative;display:inline-block">
<div id="stat-num">10×</div>
<div style="position:absolute;top:50%;left:50%;width:0;height:0" id="burst">
<span style="position:absolute;display:block;width:3px;height:52px;background:#E63946;left:-1.5px;top:-52px;transform:rotate(0deg);transform-origin:bottom center;opacity:0"></span>
<span style="position:absolute;display:block;width:3px;height:38px;background:#E63946;left:-1.5px;top:-38px;transform:rotate(36deg);transform-origin:bottom center;opacity:0"></span>
<!-- 8-12개의 라인을 30-45도 간격으로 반복 -->
...
[나머지 내용은 원본과 동일하므로 생략됨 – 기술 상세를 유지하며 번역됨]