음성이 포함된 키네틱 Shorts 만들기
모든 렌더링은 이 파일과 같은 디렉토리에 있는 pipeline/ 번들 파이프라인을 통해 이루어집니다.
(스킬이 로드될 때 표시되는 "이 스킬의 기본 디렉토리")
0. 설정 (프로젝트당 한 번)
프로젝트에 video_gen/ 폴더와 kinetic_build.py 파일이 없으면 다음을 실행하여 생성하세요:
mkdir -p video_gen && cp <skill dir>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt # 드로잉 (Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt # Kokoro 음성
ffmpeg가 PATH에 있어야 합니다. voice.py는 같은 디렉토리의 .venv-tts에서 TTS 워커를 실행합니다.
모든 명령은 video_gen/ 디렉토리에서 실행하세요.
1. 규칙 읽기
DESIGN.md- 키네틱 비주얼 스타일. 엄격한 규칙: 박스는 한 줄 전체 너비로 쌓아야 하며, 절대 나란히 배치하지 않음; 박스 가장자리에 악센트 바 없음; 큰 텍스트; 각 요소는 해당 단어가 발화될 때 나타남; 제목은 한 줄(약 30자)에 맞출 것; 자막(버인드 인 서브타이틀) 없음.PARTS.md-part.md형식, 나레이션 규칙, 가이드를 분할하는 방법.
디버깅 목적이 아니라면 engine_short.py, templates.py, skin.py는 읽지 마세요.
2. 새 시리즈: 먼저 분할하고 승인 받기
- 소스 가이드를 분석하고 파트 목록을 제안하세요 (파트당 하나의 개념, 각 90~125초). 사용자 승인을 위해 멈추세요. 길이를 맞추기 위해 내용을 절대 자르지 말고, 대신 예시와 "이유"를 추가하세요.
- 각
<series>/pNN_<slug>/part.md와 시리즈 분석 및 파트 테이블이 포함된<series>/README.md를 작성하세요. - 시리즈 폴더를
build_part.py의SERIES에 추가하세요(킥커 + 푸터). 선택적으로kinetic.py의MARKS에 로고 마크를 추가할 수 있습니다. - 나레이션 린트:
.venv/bin/python build_part.py <part dir> --lint를 실행하고 모든 문제를 수정하세요. 나레이션: 요약 금지, 환영 인사 금지, 바로 주제로 진입; 기호나 코드 없음; 음성을 위해 약어 풀어쓰기; 비트당 최대 45단어.
3. 장면
각 파트는 SCENES를 정의하는 scenes.py 파일을 갖습니다. 두 가지 스타일이 있습니다 (examples/ 참조):
- 선언적 스테이지 블록 (권장, 빠름):
SCENES = K.part(word, tag, chips, [[blocks...], ...])Track, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Note사용- 큐는 단어 접두사(이전 블록의 큐 이후 검색),
(word, beat)또는 비트 번호입니다. - 예시:
examples/p03_*
- 직접 작성한
Scene클래스: 블록으로 표현할 수 없는 비유적 표현용. 예시:examples/p01_* - 큐 단어를 발화 순서로 나열하세요. 그렇지 않으면 큐가 MISSING으로 표시됩니다.
4. 확인 후 렌더링
.venv/bin/python kinetic_build.py <part dir> --stills /tmp/pNN.png # 콘택트 시트 + 큐 리포트
.venv/bin/python kinetic_build.py <part dir> --out <series>/output # 최종 <slug>_voiced.mp4
.venv/bin/python cue_scan.py <series>/p*_* # 텍스트 동기화 확인
최종 렌더링 전에 모든 MISSING 큐와 overflow를 수정하세요.
전체 시리즈의 경우 처음 두 파트를 렌더링하여 사용자에게 외관에 대한 확인을 받은 후, 나머지 파트를 한 번에 3개씩 백그라운드에서 실행하세요 (xargs -P 3).
5. 보고
표 형식: MP4 링크, 주제, 길이, 가장 긴 무음 구간 (목표 1초 미만). 시리즈 README에서 렌더링된 파트를 표시하세요. 확인되지 않은 사항(프레임 미확인, 오디오 미청취)을 명확히 말하세요.
절대 하지 말 것
- 박스를 나란히 배치하지 않음, 가장자리 악센트 바 없음, 작은 텍스트 없음, 자막(버인드 인 서브타이틀) 없음.
- 비디오별 음성 보정 제안 금지; 동기화는 단어 단위로 이루어지며 일반적임.
engine_short.py를 직접 수정하지 말 것;build_part.py가 메모리에서 패치함.