원고 한 편을 움직이는 영상으로

처음 한 번만 npm install 을 해 둔다. 그 뒤로는 아래 다섯 개만 쓴다. ep01 자리에 편 번호를 넣는다.

그림 목록(art.json)에 적어 둔 묘사에 화풍 문장과 배경색 지시를 자동으로 붙여, 그대로 붙여넣을 수 있는 문서로 만든다.

npm run prompts

사람이 하는 유일한 반복 작업이다. 문서의 블록을 위에서부터 하나씩 처리한다.

1. 블록의 프롬프트를 통째로 복사해 Gemini에 붙여넣는다.
2. 블록의 첨부 이미지를 같이 올린다. ①은 화풍 앵커(art/anchor/style-cutin.png), ②는 같은 사람을 유지하기 위한 기준 그림이다. 순서를 지킨다.
3. 결과를 블록의 저장 경로와 이름 그대로 넣는다. 배경 제거나 크기 조절은 하지 않는다.
4. 한 사람은 한 대화창에서 끝내고, 다음 사람이나 배경은 새 대화창에서 시작한다. 대화가 길어지면 화풍이 흐려진다.

저장 위치

다시 뽑을 때 이어서 보내는 문장

원본은 건드리지 않고, 영상이 읽을 사본을 만든다. 새로 넣었거나 바뀐 그림만 처리한다.

npm run art -- ep01

• 인물 · 컷인 · 소품: 초록 배경을 지우고, 여백을 자르고, 크기를 맞춘다.
• 배경 · 장면: 16:9로 맞춰 자른다.
• 끝에 아직 없는 그림 목록을 보여준다. 없는 자리는 영상에서 점선 임시 그림으로 나오므로, 한 장씩 넣어 가며 확인해도 된다.

경고가 나오면

처음에는 Windows 내장 음성으로 자동 생성된다. 흐름을 확인하는 용도이고, 올릴 때는 직접 녹음한 목소리로 바꾸는 것을 권한다. 부모가 1인칭으로 들려주는 이야기라서 실제 목소리가 가장 잘 맞는다.

직접 녹음해서 바꿔 끼우기

1. 녹음 대본을 만든다. 파일 이름 · 화자 · 대사가 한 줄씩 정리된 video/out/ep01/voice-script.md 가 생긴다.

   npm run voice -- ep01 sheet

2. 한 줄을 한 파일로 녹음해 video/public/ep01/voice/ 에 같은 이름의 WAV로 덮어쓴다 (예: c01-0.wav). 길게 한 번에 녹음한 뒤 Audacity(무료)에서 줄마다 잘라 내보내도 된다.
3. 타이밍을 다시 잡는다. 각 파일의 길이를 재서 컷 길이와 자막 시각을 맞춘다.

   npm run voice -- ep01

4. video/src/ep01/script.json 맨 위 "title" 줄 아래에 한 줄을 추가한다. 임시 음성은 한 목소리를 아빠는 낮게, 아이는 높게 변조해서 쓰는데, 이 줄이 그 변조를 끈다. 빼먹으면 실제 목소리가 일그러진다.

   "rawVoice": true,

5. 렌더한다 (다음 장).

녹음 요령

• 스마트폰 기본 녹음 앱이면 충분하다. 입에서 한 뼘 거리, 옷장 앞이나 이불 속처럼 울림이 없는 곳에서.
• 파일 앞뒤의 무음은 0.1초 안쪽으로 자른다. 무음이 길면 컷이 늘어진다.
• WAV만 읽는다. m4a나 mp3로 녹음했으면 Audacity에서 WAV로 내보낸다.
• 아이 대사는 실제 아이가 녹음하면 가장 좋다. 어렵다면 그 줄만 AI 음성으로 섞어도 된다.

AI 음성을 쓸 때

대사를 고쳤을 때 (임시 음성 그대로 쓰는 경우)

npm run make -- ep01 --tts

프롬프트 문서 갱신 → 그림 처리 → (음성이 없을 때만) 임시 음성 → 영상 → 자막 순서로 한 번에 돈다. 4분짜리 영상에 6~7분쯤 걸린다.

npm run make -- ep01

렌더 전에 미리 보기

npm run studio

움직임은 video/src/ep01/script.json 에 글로 적혀 있다. 컷마다 무대(scene)를 정하고, 대사마다 그 순간의 연출을 붙인다.

가만히 둬도 되는 것

• 말하는 인물이 까딱거린다 (대사의 who 와 인물의 id 가 같을 때).
• 표정이 바뀌면 젤리처럼 눌렸다 튄다.
• 컷 내내 카메라가 천천히 밀고 들어간다.
• 인물 발밑에 그림자가 생기고, 가만히 있어도 숨을 쉰다.

컷의 무대 — scene

"scene": {
  "bg": "common/bg/living-room",
  "actors": [
    {"id":"kid","art":"common/kid/normal","x":0.3,"enter":"left"},
    {"id":"dad","art":"common/dad/normal","x":0.68}
  ]
}

대사에 붙이는 연출

{"who":"dad","text":"어... 그게...","pose":{"dad":"common/dad/panic"},"focus":"dad","cutin":"common/cutin/dad-panic"}

공통 그림(가족 · 집)은 이미 있으니, 편마다 새로 필요한 것은 그 편의 그림 열 장 안팎과 파일 두 개다. 파일 두 개는 원고를 Claude에게 주고 "1편처럼 만들어 줘"라고 하면 된다.

• 원고가 있다 (episodes/NN-…/….md, 스킬 eight-year-olds-question 으로 작성)
• video/src/epNN/script.json — 컷 · 대사 · 연출
• video/src/epNN/art.json — 이 편에만 쓰는 그림 목록과 묘사
• video/src/Root.tsx 에 그 편을 등록 (1편 블록을 복사해 번호만 바꾼다)
• npm run prompts → Gemini에서 그림 뽑기 → npm run art -- epNN 에서 빠진 그림이 없다
• npm run studio 로 인물 위치 · 표정 · 컷인 타이밍 확인
• 목소리 녹음 → npm run voice -- epNN → "rawVoice": true
• npm run make -- epNN → 영상을 처음부터 끝까지 한 번 본다