비주얼 디렉터
훌륭한 토킹헤드 릴은 말하는 사람이 말하는 내용을 한 비트씩 보여줍니다. 목록은 각 항목이 언급될 때마다 칩이 튀어나오고, 숫자는 카운트업되며, "프롬프트를 입력했어"라는 말은 채팅창이 입력하는 모습으로 표시됩니다. 각 조각은 작고, 머리 주변(얼굴 위는 안 됨)에 배치되며, 해당 단어가 발화되는 순간 정확히 나타납니다.
이 작업은 build.json → "visuals": [...]에서 계획합니다. 엔진이 배치, 키트의 룩, 애니메이션, 팝업당 사운드를 처리합니다.
1. 릴을 비트 단위로 읽기
잠긴 라인(edl.json)을 단어 인덱스와 함께 살펴보세요:
python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"
보여줄 수 있는 내용이 있는 모든 비트를 표시하세요:
- 사물의 목록
- 숫자
- 도구 또는 앱
- 동작(타이핑, 전송, 예약)
- 전/후 또는 이것 대 저것
- 프로세스 또는 단계
- 시스템
- 사람 또는 스토리
- 시간 범위
- 거절된 아이디어
- 강조할 가치가 있는 키워드
채움, 전환, 객체 없이 감정만 있는 것은 아무것도 표시하지 않습니다.
2. 각 비트에 맞는 조각 선택하기
| 말하는 내용 | 조각 | 예시 |
|---|---|---|
| 목록 ("마케팅, 인보이스, 이메일") | chips, 각 단어가 발화될 때 항목 하나씩 | 각각 word가 있는 항목들 |
| 버리거나 닫히는 것 ("내 머릿속의 그 모든 탭들") | "close": true인 chips | |
| 숫자 ("100+ 클라이언트", "오후 3시", "2명 팀") | number | "value": "100+", "label": "clients" |
| 한 줄의 키워드 또는 강조점 | word (생각이나 질문은 "style": "type") | "text": "진정한 *지원*" |
| 거절하는 것 ("50단계는 아니야", "또 다른 앱이 아니라") | strike | "pre": "No", "text": "50 steps", "strike_word": i |
| 프롬프트 입력, AI에게 질문, DM 보내기 | chat | "prompt": "...", "reply": "..." (선택 사항) |
| 판매, 메시지, 예약, 알림 | notify | "app": "Stripe", "title": "New payment: €497" |
| 완료된 단계, 할 일 목록, 성과 | checklist | 각각 word가 있는 항목들 |
| "단계 1 / 첫 번째 것 / 파트 2" | step | "n": 1, "text": "*train* it" |
| 변화 또는 프로세스 (A → B → C) | flow | 아이콘과 텍스트가 있는 항목들 |
| 시스템, 연결된 도구들, "모든 것이 한 곳에" | hub | 아이콘이 있는 center와 nodes |
| 시간 범위 ("한 달 안에… 3년 안에") | scale | marks, from, to, move_word |
| 클라이언트, 사람, 누군가에 대한 이야기 | person | "name": "Abby", "note": "coach", "meter": 3 |
| 이것 대 저것, 예전 방식 대 새 방식 | versus | left (✗) / right (✓), right_word |
| 사용자가 요청할 때만 넣는 밈 또는 GIF | gif | "file": "projects/<name>/memes/3.mp4", "caption": "me reading my old *captions*" |
| 프로필, 스크린샷, 앱 | phone | "image": "assets/profile.png" (사용자가 준 이미지만) |
조각 위의 텍스트:
- 칩, 노드 또는 레이블당 1–3단어
- 사용자의 단어를 사용
- 제목 형식도 괜찮지만,
chat과notify를 제외하고는 완전한 문장 금지
아이콘: uv run tools/icons.py calendar money email로 실제 이름을 찾고, 절대 추측하지 마세요. 알 수 없는 아이콘이 있으면 빌드가 중단됩니다.
시그니처 조각 (사용자 자신의 자료가 필요)
- 그들의 릴이 주위를 공전:
events(visuals 아님)에서{"type": "orbit", "word": i, "until_word": j}.- 자신의 콘텐츠나 작업물에 관한 라인("나는 이런 걸 300개나 만들었어")에 사용하세요.
brand/reels/가 필요합니다.uv run tools/reels.py add <their reel files or a folder>로 채우세요: 사용자가 내보낸 자신의 릴, 또는 연결된 경우 Apify로 자신의 프로필에서 다운로드한 것.- 그들의 릴은 뒤와 앞을 지나갑니다. 릴당 최대 한 번.
- Instagram 프로필 팔로우 콜 투 액션용("팔로우 해줘", "BRAIN 댓글 남겨줘"):
{"kind": "profile", "word": i, "until_word": j, "keyword": "BRAIN"};keyword는 선택 사항이며 댓글 시트에 입력됩니다.- 숫자는
brand/instagram.json에서만 가져옵니다(name, handle, posts, followers, following, bio, avatar). 없으면 실제 숫자를 물어보세요(또는 Apify로 자신의 프로필에서 가져오세요). 절대 추정하거나 만들지 마세요. - 그리드는
brand/reels/를 사용합니다. Follow(및 Post)에서 탭 사운드가 재생됩니다.
- 카드 형태의 다른 크리에이터 릴:
"handle": "creatorname"이 있는gif. @handle이 아래에 표시됩니다.- 항상 출처를 표시하고, 사용자가 지시한 클립만 사용하세요.
- 커스텀 인서트 (어떤 조각도 맞지 않을 때, 예: 사용하는 앱의 재현, 파일 스크롤 등): 하위 에이전트로 빌드하세요. 아래 "커스텀 인서트"를 참고하세요.
움직임(motion)
키트의 visuals.motion: gentle / snappy / bouncy / blur (블러 팝업으로 나타나 선명해짐) / rise (차분한 에디토리얼).
word팝에"style": "rise"를 사용하면 각 글자가 줄에서 하나씩 순서대로 올라옵니다. 세리프 강조 단어에 좋습니다. 키트에서visuals.word_style: "rise"로 기본값으로 설정할 수 있습니다.- 캡션은
captions.pop: "blur"로 블러 팝업이 가능합니다.
커스텀 인서트 (병렬 하위 에이전트)
- 먼저 타이밍을 고정: 맞춰야 할 단어 시간을 인서트 자체의 시계로 변환합니다(t = 0은 인서트가 나타나는 시점).
- 인서트당 하나의 하위 에이전트를 백그라운드에서 병렬로 생성(Agent 도구)하고, 계속 빌드합니다. 다음 정보를 브리핑하세요:
- 무엇을 보여주는지, 그리고 어떤 라인 아래에서 재생되는지. 사용자의 실제 데이터만 사용; 그 외는 일반적인 플레이스홀더. 실제 인물 금지, 복사된 로고 금지.
- 작업 위치:
projects/<name>/inserts/<insert-name>/index.html. 다른 것은 건드리지 마세요. - 크기 및 지속 시간: 예: 900×700 px, 2.6초. 카드나 창 바깥의 배경은 투명하게 유지.
- 계약:
window.renderAt(t)는 t초 시점의 정확한 상태를 그립니다. 타이머, CSS 전환 또는 애니메이션 사용 금지, 프레임이 하나씩 캡처되기 때문입니다.- 로컬 폰트만 사용 (
fonts/free/에서 복사). - 텍스트는 최소 24px, 사용자의 키트 색상 사용.
- 타이핑된 텍스트: t 단계당 한 문자씩.
- 로컬 폰트만 사용 (
- 비트, 음성에 고정된 시간.
- 렌더링
uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h>→insert.mov, 알파 채널 포함. 보고하기 전에 몇 프레임 확인. - 보고: 경로, 정확한 지속 시간, 비트 시간(사운드용). 이상한 점이 있으면 표시.
- 배치
{"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}. 인서트의 비트에sfx_extra클릭을 추가하세요.
밈과 GIF (요청 시에만)
-
요청 없이 밈을 절대 추가하지 마세요. 밈은 취향 문제입니다. 보고서에서 제안("데이비드 로즈의 'ew'가 5번째 라인에 잘 어울릴 것 같아요")할 수는 있으며, 사용자가 동의할 때만 추가하세요.
-
검색:
uv run tools/memes.py search "<show> <character> <emotion or words>" --project projects/<name>. 예: "schitts creek david ew" 또는 "the office michael no god please no".- 최대 6개의 클립을 다운로드하고
SHEET=…/memes/sheet.png를 출력합니다. 시트를 읽고 사용자가 설명한 것과 일치하는 타일(올바른 캐릭터, 올바른 표정)을 선택하세요. 첫 번째 것이 아니라. - 타일은 1부터 6까지 번호가 매겨져 있으며, 왼쪽에서 오른쪽, 위에서 아래로 정렬됩니다.
- 최대 6개의 클립을 다운로드하고
-
사용자 자신의 파일 ("이 GIF를 써줘"):
uv run tools/memes.py add "<file>" --project projects/<name>은memes/own-1.mp4를 생성합니다. 이미지도 작동합니다. -
배치:
{"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<their text>"}- 캡션은 선택 사항, 사용자의 단어로, 하나의
*emphasis*포함. 기본 길이는 약 2.6초, 또는"until_word"설정. - 가로가 긴 클립은 머리 위에, 세로가 긴 클립은 턱 아래에 배치.
"at": "full"은 캡션이 위에 있는 1.6초 전체 화면 컷어웨이를 만듭니다.
-
보고서에: 어떤 것을 사용했는지 말하고, 시트를 여세요(
open …/sheet.png). 사용자가 "밈 3번"이라고 말할 수 있습니다. 다른 클립은 이미 다운로드되어 있으므로,file만 변경하고 다시 빌드하면 됩니다. -
키 없음 (
MEMES=no-key): 3분 무료 설정을 제안하세요:- developers.giphy.com에 가서 가입하고 API 앱(SDK 아님)을 만든 후 키를 복사하세요.
- 채팅에 키를 붙여넣으세요.
brand/keys.json에{"giphy": "<key>"}로 저장하세요.
사용자에게 직접 파일을 편집하도록 요청하지 마세요. 그때까지는 사용자 자신의 GIF 파일이 계속 작동합니다.
-
한 번만 언급, TV나 영화 밈을 처음 사용할 때: 해당 클립은 스튜디오 소유입니다. 짧은 무음 반응 GIF는 Instagram에서 널리 사용되지만 약간의 위험이 있습니다. 사용자 자신의 클립에는 위험이 없습니다.
3. 타이밍 (대본의 단어 인덱스)
"word": i는 단어 i가 발화될 때 조각이 나타나게 합니다. 라인의 시작이 아닌 비트의 첫 번째 단어를 사용하세요.- 항목은 각각 고유한
"word"를 가지므로 각 칩, 체크 또는 노드가 발화될 때 정확히 나타납니다. 이것이 편집된 느낌을 주는 핵심입니다. - 조각 종료:
"until_word": j는 단어 j 이후에 종료- 그렇지 않으면 약 2–3초, 또는 마지막 항목 이후 1.4초까지 유지
"dur": 2.5로 길이 직접 설정
- 다른 순간들도 단어에 맞춰 타이밍 가능:
strike_word,reply_word(chat),right_word(versus),move_word/move_end_word(scale),meter_word(person),close_word(칩 닫기).
4. 키트의 밀도 (kit.json → visuals.density)
| 밀도 | 빈도 | 느낌 |
|---|---|---|
calm | 8–10초마다 하나 | 깔끔한 전문가 설명 |
steady | 4–6초마다 하나 | 대부분의 릴 |
busy | 2–4초마다 하나, 거의 연속 | 빠른 "설명" 스타일 |
모든 밀도의 규칙:
- 한 번에 하나의 조각만. 두 개가 겹칠 수 있는 경우는 다른 영역에 있고 같은 비트에 속할 때뿐.
- 후크(처음 ~3초)나 스테이트먼트 중에는 절대 안 됨. 조각이 스테이트먼트를 대체할 수 있음:
busy에서는 최대 1개의 스테이트먼트 사용. - 같은 종류를 연속으로 사용하지 마세요. 같은 목록이 계속되는 경우는 예외.
word팝은 요약하거나 재구성해야 하며, 캡션을 그대로 반영하지 마세요. 같은 단어를 표시하면 엔진이 캡션을 숨깁니다. 작동은 하지만, "비즈니스의 포괄적인 개요" 대신 "비즈니스 전체" 같은 팝이 "non-negotiables"를 반복하는 것보다 더 가치를 더합니다.highlight_words가 있는 단어에 팝업을 넣지 마세요.chat은 자체적으로 작은 이야기를 연출: 프롬프트 입력(키 클릭 소리), 전송(스와이프 소리), AI "생각" 표시, 그다음reply(제공된 경우). 타이핑이 끝난 후 약 1.5초를 주어 전송 시간을 확보. 사용자가 설명한 결과를 짧은reply로 작성하면 더 효과적입니다.- 조각 사이에 짧은 숨 쉴 간격(≥0.4초)을 두세요.
"at"은 기본 위치와 충돌할 때만 영역을 재정의합니다(top,left,right,chest).
5. 빌드 및 확인
uv run tools/build.py projects/<name>. 빌드는 CHECK=…/check.png를 출력합니다: 각 순간과 팝업당 하나의 프레임. 읽고 다음 문제를 수정하세요:
- 읽을 수 없음
- 화면 밖
- 얼굴 가림
- 캡션과 충돌
- 잘못된 단어 설명
SAFE ZONE:라인에 나열됨 (Instagram의 사용자 이름, 캡션 또는 좋아요/댓글/공유 버튼 아래에 위치). 모든 것을 수정: 조각 이동("at"), 텍스트 단축, 더 일찍 종료. 모두 없어질 때까지 다시 빌드.
화면에 표시되는 내용:
- 팝업, 후크 또는 스테이트먼트 텍스트에 em 대시 사용 금지. 쉼표, 마침표 또는 줄바꿈 사용.
- 실제 숫자는 사용자 자신의 숫자이고 그가 말한 경우에만 사용. 채팅창, 댓글, DM은 일반 플레이스홀더 사용, 실제 인물 이름이나 증명용으로 만들어진 결과는 절대 사용 금지.
- 다른 크리에이터의 게시물이나 릴이 화면에 나오면 @handle을 표시.
그런 다음 새 릴 스킬에서처럼 인계하며, 한 줄을 추가합니다(예: "팝업 12개: 4가지 작업에 대한 칩, '프롬프트'에 채팅창, AI 시스템 허브…").
사용자가 요청할 때
-
"어떤 그래픽을 추가할 수 있어?" / "옵션 보여줘": 키트에 대한 카탈로그 비디오가 있으면 열기(
projects/*/catalog-<kit>.mp4). 없으면 최신 릴에서 렌더링:uv run tools/build.py projects/<name> --catalog. 각 조각을 한 번씩, 해당 룩으로, 레이블과 함께 보여줍니다. 절대 길게 설명하지 마세요. -
"팝업 더/덜 보여줘": 이 릴의 밀도 변경; 사용자가 "항상"이라고 말하면 키트의
visuals.density에 저장. -
"여기 체크리스트 넣어줘" / "팔로우 하라고 말할 때 내 프로필 보여줘": 해당 단어에 정확히 그 조각을 추가하세요.
-
스타일 ("테두리 카드", "더 차분한 애니메이션", "더 굵은 아이콘"): 키트의
"visuals"블록:card:solid/outline/glassmotion:gentle/snappy/bouncyicon_stroke: 1.5–2.5radius- 색상:
accent,strong,alert,word,card_color; 키트의 색상 이름 또는 hex 값
키트를 변경하고, 프리셋은 사용하지 마세요.