yt-film: 정지 이미지로 만드는 내레이션 영화
세로형 Reels, Shorts 또는 시리즈 소셜 비디오의 경우 보완 yt-film-reels 스킬을 사용하세요.
기본 세트는 바닥일 뿐, 영화 자체가 아닙니다. 모든 영화(가로든 세로든)에서 쇼트 리스트를 작성하기 전에 Claude가 주도하는 창의적 패스를 먼저 진행하세요. 이 스토리에 기본 세트에 없는 요소(자체 효과, 전환, 사운드, 드로잉 장치)가 무엇인지 결정하고, 이를 만들거나 찾아보고, 적합한 경우에만 기본 효과를 재사용하세요. 엔진은 세로형도 렌더링합니다: 세로 모드.
스토리 영화 제작 파이프라인: 사용자가 Claude가 작성한 가이드를 기반으로 약 150장의 정지 이미지를 만들고, Claude가 그 이미지들로 대본을 작성하며, 음성이 이를 읽고, Python 엔진이 모든 사진을 단어에 맞춰 생동감 있게 만듭니다. 참조 영화는 Chadwick 예제입니다 (examples/chadwick/, 카네기의 딸: 앤드류 카네기의 비밀 딸로 수백만 달러를 빌린 여성). 이 예제의 이미지, 대본, 음성, 점수, 쇼트 리스트 및 70초 효과 테스트 비디오(examples/chadwick/video/chadwick_effects_test.mp4)는 모든 기술을 보여줍니다.
**REPO**는 이 스킬의 폴더(이 파일이 있는 곳)입니다. **PY**는 이곳의 Python입니다: macOS/Linux에서는 REPO/.venv/bin/python, Windows에서는 REPO\.venv\Scripts\python.exe입니다. 항상 프로젝트의 tools/ 폴더에서 PY로 엔진 명령을 실행하세요. .venv가 없으면 먼저 설정하세요: references/install.md에 있는 설치 런북(Claude용) 을 단계별로 따르세요(시스템 전체 설치 전에 물어보세요. 사용자가 자신의 API 키를 붙여넣습니다).
기본 규칙
- 사용자의 승인 없이 절대 렌더링하지 마세요.
stills.py(약 30초 내 연락처 시트)로 확인하세요. 배치 렌더링, 미리보기, 엔딩 및 최종 결합은 몇 분에서 몇 시간이 걸릴 수 있습니다. 렌더링할 내용과 예상 시간을 말하고, 승인을 기다리세요. 변경되지 않았거나 사용자가 원하지 않는 한 이미 렌더링된 것은 다시 렌더링하지 마세요. - 프로젝트당 한 번 사용자 경로를 물어보세요: 어떤 이미지 도구(
references/image-generation.md), 음성(Gemini TTS 또는 자체 음성:references/voice.md), 음악(Lyria 또는 자체 음악:references/music.md), 사용자의 니치 및 채널 이름, 그리고 채널을 그들의 것으로 만드는 세 가지 선택: 이미지 스타일(오프너: 구아슈, 플랫 편집, 느와르, 초크, 코믹, 스토리북, 블루프린트 또는 자체 스타일; 캐릭터 유무), 엔진 룩(YTF_LOOK: 구아슈, 클린, 느와르, 초크, 코믹, 스토리북, 블루프린트; 단일 값의 경우look.json) 및 포맷(story,explainer,countdown,rise-fall,storytime,kids,summary,case-study,news):references/art-styles.md,references/formats.md. 예제의 파스텔 실제 이야기 스타일을 기본값으로 사용하지 마세요. 사용자가 선호하는 것이 없으면 하나의 짧은 표로 옵션을 보여주고 니치에 맞는 하나를 추천하세요. - 사용자의 니치는 그들의 것입니다. 역사나 예제 주제로 유도하지 마세요. 예제는 기술에 대한 참조일 뿐, 주제에 대한 템플릿이 아닙니다.
- Windows: 슬래시(
/)가 있는 경로도 작동합니다. 긴 작업은 백그라운드에서 실행됩니다. 속도 설정은references/performance.md를 참조하세요. macOS 전용 도구를 가정하지 마세요. .env외부의 파일에는 API 키를 저장하지 마세요. 실제 사진이나 사운드 파일은 사용자의 확인 후에만 다운로드하세요(파일, 출처, 크기 및 라이선스 명시).
스택
| 작업 | 도구 | 위치 |
|---|---|---|
| 리서치 | 웹 검색, 출처가 포함된 검증된 사실 목록; 확인 불가능한 항목 표시 | OUTLINE.md |
| 이미지 | Claude의 가이드에서 사용자의 이미지 도구 | IMAGE_GUIDE.md (+ API용 IMAGE_PROMPTS.jsonl), incoming/ |
| 대본 | Claude, 이미지 가이드를 기반으로 작성, 비트당 ## 단락, [SHOTS: …] 노트 | SCRIPT.md |
| 음성 | Gemini TTS(음성 Orus, 천천히 읽기 → 1.25배, 일시 정지 제한) 또는 import_voice.py를 통한 사용자 오디오 | tools/voice.py, tools/import_voice.py |
| 단어 타이밍 | Whisper: mlx-whisper(Apple Silicon) 또는 faster-whisper(Windows/Intel/Linux) | voice/<batch>_words.json |
| 음악 | Lyria(Gemini API), 섹션당 하나의 큐, 또는 사용자의 라이선스 트랙 | tools/music.py → audio/music/ |
| 영화 엔진 | Python(OpenCV, Pillow, NumPy, SciPy), After Effects 불필요 | tools/film.py, fx2.py, seq.py, signature.py, wr.py, kit.py |
| 쇼트 리스트 | seq.py의 배치당 하나의 파일, 해당 배치의 단어 시간에 큐됨 | tools/<story>.py + tools/shots_bN.py |
| 렌더링 | 병렬, 머신에 맞게 크기 조정, 낮은 우선순위 | tools/render_all.py |
| 엔딩 | 사용자 자체 애니메이션 사인오프(예: cta.py) | renders/cta.mp4 |
| 최종 결합 | 배치 + 엔딩, 연속 점수 하나, −14 LUFS / −2 dBTP | tools/final.py |
| 더빙 | 기본적으로 스페인어 및 프랑스어: Gemini 번역 + TTS를 약 3분 청크로, 영어 슬롯에 맞춤 | tools/dub.py |
| 썸네일 | 가이드에서 사용자의 이미지 도구 | references/thumbnails.md |
프로젝트는 YTF_WORKSPACE(기본값 ~/yt-film-projects/<story>/)에 저장되며, PY REPO/scripts/new_project.py <story>로 생성됩니다. 이 명령은 엔진을 tools/에 복사하고 모든 폴더를 만듭니다. 설정은 .env에 있습니다(프로젝트 우선, 그다음 REPO): GEMINI_API_KEY, YTF_CHANNEL, 음성/모델 이름, 속도 조절(.env.example에 전체 목록). engine/ytf.py는 모든 OS에서 글꼴, 키, Whisper 및 공유 아트를 찾습니다.
작업 순서
- 스토리 선택(주어지지 않은 경우): 갭 확인과 함께 3~5개의 후보(
references/story-finding.md). 포맷과 룩을 사용하여 프로젝트 시작:PY REPO/scripts/new_project.py <name> --format <format> --look <look>(포맷의 스파인 템플릿을 OUTLINE.md에 쓰고,YTF_FORMAT및YTF_LOOK을.env에 씁니다). 전체 가이드를 작성하기 전에stills.py로 두 이미지에서 새 스타일을 테스트하세요(references/art-styles.md, 마지막 섹션). - 스토리 및 사실: 리서치; 출처가 포함된
OUTLINE.md. 확인되지 않은 것은 표시하고 나중에 우회하여 표현(