인포그래픽 설명 영상은(는) 무엇을 하나요?
Kurzgesagt, The Infographics Show 채널의 정신을 살린 완성된 MP4 설명 영상을 제작합니다. 굵은 플랫 벡터 일러스트레이션, 광택 그라데이션, 빛나는 효과, 끊임없는 부드러운 움직임, 호기심을 자극하는 내레이션 스크립트가 특징입니다. 아트와 애니메이션은 코드(SVG + JS 타임라인)로 제작되며 Playwright와 ffmpeg로 프레임별로 렌더링되어 모든 프레임이 결정적이고 편집 가능합니다.
독창성 규칙: 장르(플랫 벡터, 설명 영상 페이싱)를 모방하되, 채널의 캐릭터(예: Kurzgesagt의 새), 로고, 인트로, 음악 또는 정확한 디자인을 절대 복사하지 마십시오. 모든 캐릭터와 장면은 새롭게 창작합니다.
사용자의 선호 언어로 대화하되, 코드는 영어로 유지하십시오.
번들 파일 (이 스킬 폴더 기준 상대 경로)
| 파일 | 용도 |
|---|---|
templates/master_template.html | 16:9 스타터 (1920x1080): 그라데이션, 헬퍼, 캐릭터, 두뇌, 구름, 별, 크로스페이드 장면 엔진, 내장 자막 포함. 복사하여 장면을 교체하세요. |
templates/vertical_template.html | 9:16 Shorts/Reels용 동일 엔진 (1080x1920), 세로 레이아웃, 하단에 자막 공간 확보. |
scripts/voiceover.py | Kokoro TTS(힌디어 + 영어 음성)를 사용한 오프라인 내레이션, 라인당 하나의 wav 파일 + dur.json + lines.json(자막용 텍스트) 생성. |
scripts/build.py | 음성 지속 시간(__DUR__)과 내레이션 텍스트(__LINES__)를 주입하고 timeline.json + captions.json 내보내기; 9:16 감지; JS 오류 보고. |
scripts/captions.py | captions.json에서 YouTube 자막용 .srt 파일 생성. |
scripts/peek.py | 장면당 한 프레임 → 접촉 시트(contact sheet), 전체 렌더링 전 확인용. |
scripts/render.py | 결정적 프레임 범위 렌더러 (JPEG q92 → x264 CRF 18, 안전한 임시 파일 이름 변경). |
scripts/mix_audio.py | 타임라인에 음성 라인 배치, 코드 합성(저작권 프리) 앰비언트 패드 + 후시음 추가, 또는 자체 --music 사용. |
scripts/make_video.sh | 전체 파이프라인: 빌드 → 병렬 렌더 → 연결 → 믹스 → 먹스 → QA 시트 → .srt. 9:16 자동 감지. |
두 개의 작업 예제가 저장소의 이 스킬 폴더보다 두 단계 위에 있습니다: examples/why-we-sleep/ (82초, 16:9, 힌디어, 11개 장면) 및 examples/promo-short/ (38초, 9:16, 영어, 실제 클립을 장면에 배치). 새 장면을 작성하기 전에 장면 아이디어를 위해 읽어보세요.
설정 (한 번만)
pip install playwright kokoro-onnx soundfile scipy pillow --break-system-packages
playwright install chromium # Chromium이 이미 있으면 건너뜁니다.
mkdir -p tts && cd tts
curl -LO https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.int8.onnx
curl -LO https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin
ffmpeg가 PATH에 있어야 합니다. 모델 폴더가 ./tts가 아닌 경우 KOKORO_DIR을 설정하세요.
1. 워크플로우 (순서대로 따르세요)
- 브리핑 – 주제, 길이 (기본 60–90초; Shorts=30–58초), 화면 비율 (16:9 1920x1080 또는 9:16 1080x1920), 내레이션 언어, 음성 출처. 누락된 항목이 있고 사용자가 있다면 한 번 질문하고, 그렇지 않으면 기본값을 사용하고 알립니다.
- 리서치 + 스크립트 – 현재 또는 숫자 관련 사실을 웹 검색하고 각 숫자의 출처를 기록합니다. 구조: 후크 → 질문 → 3-5비트로 설명 → 반전/규모 순간 → 핵심 메시지. 분당 약 150단어. 짧은 문장, 하나의 아이디어, 구체적인 숫자와 비교. 발견이 동물이나 단일 연구에서 나온 것이라면 내레이션에서 언급합니다.
- lines.txt – 행당 하나의 내레이션 라인; 한 라인 = 한 장면 (약 4–8초). 힌디어 TTS의 경우 영어 차용어를 데바나가리 문자(स्लीप प्रेशर)로 작성하여 자연스럽게 발음되도록 하고, 화면상 텍스트는 데바나가리 폰트가 설치되지 않은 경우 영어/로마자로 유지합니다.
- 음성 우선 –
python3 scripts/voiceover.py lines.txt vo --voice hm_omega --lang hi(영어:--voice am_michael --lang en-us). 지속 시간이 타임라인을 결정하며, 그 반대는 안 됩니다. 사용자 녹음 음성이 항상 더 좋습니다: 라인당 하나의 파일로vo/NN.wav로 분할하고vo/dur.json을 작성합니다. - 장면 빌드 –
templates/master_template.html(16:9) 또는templates/vertical_template.html(9:16)을 복사하고, 라인당 하나의scene(...)(선택적 아웃트로 추가)를 작성합니다. 모든 장면: 항상 켜져 있는 유휴 모션 + 하나의 중요 액션. 아래 스타일 가이드와 애니메이션 키트를 사용하세요. - 미리보기 –
python3 scripts/build.py video.html vo/dur.json _work/build.html && python3 scripts/peek.py _work/build.html 0.8; 시트를 보고 (0.3도 시도) 렌더링 전에 겹침, 클리핑, 빈 프레임을 수정합니다. - 렌더 + 믹스 –
bash scripts/make_video.sh video.html vo final.mp4(CPU 코어당 하나의 청크 실행; 1080p에서 비디오 초당 코어당 약 3초 벽시계 시간). - QA –
final_sheet.png를 열고; 팔레트 일관성, 안전 영역, 클리핑 없음, 썸네일 크기에서 텍스트 읽기 가능,ffprobe지속 시간 ≈ 타임라인 지속 시간을 확인합니다. 깨진 장면만 수정하고 다시 렌더링합니다. - 전달 – MP4, 해당
.srt(YouTube에 자막으로 업로드), 스크립트 텍스트, 제목/설명/태그 + 썸네일 제공.
2. 스타일 가이드
- 모양: 단순한 기본형(타원, 둥근 사각형, 부드러운 자유형 경로). 대부분의 모양에 외곽선 없음; 중요 객체에만 동일한 색조의 더 어두운 외곽선 사용.
- 레이어드 그라데이션: 거의 모든 모양은 한 색조의 2-스톱 선형 그라데이션(밝은 왼쪽 위 → 채도 높은 오른쪽 아래)과 광택 효과를 위한 25–40% 불투명도의 흰색 하이라이트를 얻습니다.
- 글로우: 광원 = 방사형 그라데이션 거의 흰색 → 투명, 반경 ±5% 맥동. 반짝임 = 불투명도 사인파를 통해 깜빡이는 4포인트 별.
- 깊이 via 레이어: 하늘 그라데이션 → 먼 언덕 → 중간 언덕 → 밝은 블롭이 있는 땅 띠 → 주제 → 전경 입자; 레이어를 다른 속도로 이동.
- 팔레트 (비디오당 하나, 최대 5-6색조 + 어두운 색):
- 우주/밤:
#211840 #423AA8 #7F79D1 #E565FF #33F5FF #1552FF - 낮/자연:
#00A7E2 #00D2EE #6EED65 #01CB79 #FFE4AF #FFFFFF - 따뜻한 이야기:
#290D1C #B15141 #FFE4AF #FFCE85 #FF5F2D #FFFF47 - 네온 팝:
#232453 #5759B9 #B6FF55 #FF0066 #A14BFF #00FFFF
- 우주/밤:
- 배경: 절대 순수 검정/흰색 사용 금지; 진한 색조의 어두운 색(
#12253A,#162B36) 또는 따뜻한 베이지(#E6DDC4). "위험" 비트에는 붉은 계열 어두운 색으로 전환. - 캐릭터: 둥근 블롭 몸체, 크고 단순한 눈(흰색 + 어두운 동공 + 반사광), 코 없음, 볼터치. 약 3초마다 깜빡임, 호흡(크기 1 → 1.025). 수면 = 닫힌 눈 호 + 떠다니는 "z".
- 텍스트: 굵고 둥근 산세리프(Poppins Bold / Nunito ExtraBold), 적은 단어, 큰 숫자, 필 배지 형태의 레이블, 90% 안전 영역 내.
- 인포그래픽 스타일: 올라가는 카운터, 커지고/줄어드는 막대, 게이지, 전후 비교, 반응하는 캐릭터.
3. 애니메이션 키트 (PowerPoint 효과 → 코드)
| PowerPoint 효과 | 코드 동등 (템플릿의 헬퍼) |
|---|---|
| 날아오기 / 위로 올라오기 | outBack 이지(easing)로 화면 밖에서 translate |
| 페이드 / 줌 / 확대 | pop(el,t,start,x,y) → 오버슈트가 있는 불투명도 + 크기 |
| 회전 강조 | 모양 자체 중심을 기준으로 rotate(${t*deg}) |
| 모션 경로 | along(pathEl,p) / getPointAtLength |
| 모프 전환 | 장면 간 공유 객체 유지; 엔진이 장면을 크로스페이드 (FADE) |
| 입자 궤적 / 반딧불 | 시드된 rng(seed) 입자, 위상 오프셋, 지연 및 크기 감쇠 |
| 와이프 / 그리기 | stroke-dasharray + stroke-dashoffset |
| 나가기 | in 이지로 입장의 역순 |
항상 켜져 있는 유휴 모션: 떠다니기, 반짝임, 글로우 맥동, 느린 시차 드리프트, 구름 드리프트, 엔진의 느린 카메라 줌인(scale 1 → 1.045). 큰 액션 전의 예상 흔들림, 착지 시 스쿼시 앤 스트레치. 입장 0.4–0.8초, 간격 60–120ms. 프레임을 완전히 정지 상태로 두지 마십시오.
4. 엔진 규칙 (템플릿)
- 각 장면:
scene(id, bgGradientId, build() => svgString, seek(localT, sceneDuration)). seek는 모든 속성을 순수하게t에서 설정합니다 — CSS 애니메이션, 타이머 또는Math.random사용 금지 (rng(seed)사용). 따라서 모든 프레임을 개별적으로 렌더링할 수 있고 청크가 매끄럽게 연결됩니다.- 요소 id는 전체 파일에서 고유해야 합니다 (장면 id 접두사 사용).
- 장면
i길이 =LEAD[i] + VO[i] + TAIL; 내레이션 라인을 넘는 장면은 3.2초 (아웃트로).MIN={2:16}은 장면 2를 최소 16초 동안 유지합니다 (예: 나중에 삽입할 클립용). 엔진은window.DURATION,window.TIMELINE,window.CAPTION_CUES,window.seek을 내보냅니다. scene(..., {cam:false})는 한 장면에 대해 느린 카메라 줌인을 끕니다 (비디오 클립이 오버레이될 때 필요).- 자막:
CAPTIONS=true는 단어 청크 자막(LINES에서, 각 라인 내 문자로 시간 조정)을 프레임에 굽습니다; Chromium이 데바나가리 문자를 올바르게 처리합니다. 중요한 아트에서 하단 약 120px (16:9) / 약 300px (9:16)을 비워 두십시오.CAPTIONS=false로 설정하여 자막을 끌 수 있습니다;.srt는 여전히 작성됩니다. - 9:16:
vertical_template.html에서 시작 (상단 1/3에 후크 텍스트, 중간에 주요 비주얼). 스크립트는 SVG viewBox에서 9:16을 감지합니다; 16:9 비디오를 자르지 마십시오.
5. 오디오
- 음성: 사용자 녹음 → Kokoro (
scripts/voiceover.py) → 세션이 제공하는 다른 TTS. Kokoro 힌디어 음성:hm_omega,hm_psi,hf_alpha,hf_beta. - 음악:
mix_audio.py의 기본 합성 패드는 독창적이고 저작권 프리입니다. 또는 사용자가 소유/라이선스한 트랙과 함께--music을 전달하십시오. 저작권 있는 음악은 절대 사용하지 마십시오. - 자막이 내장되어 있습니다 (엔진 규칙 위 참조).
make_video.sh는 또한final.srt를 작성합니다; YouTube에 업로드하여 시청자가 자막을 켜고 YouTube가 자동 번역할 수 있도록 하십시오.
6. 요청 시 추가 기능
- 썸네일: 1280x720 해상도로 주요 장면 한 프레임을 렌더링하고 2-4단어 레이블을 추가합니다.
- 시리즈 룩: 팔레트, 폰트 및 캐릭터 함수를 공유 파일에 유지하고 에피소드 간에 재사용합니다.
- 아웃트로 카드: 마지막 2-3초 동안 채널/필명 표시.