참고: 이 파일은 한국어로 번역되었습니다. 원본은 UgurKeskekci/claude-video-kit에서 확인하세요.
코드로 만드는 잉크 애니메이션
사용자가 어떤 상태나 이야기를 말하면 (예: "일주일째 소셜 미디어만 하다가 미칠 것 같아"), 당신은 그것을 짧고 하나의 아이디어에 집중된 애니메이션으로 변환합니다. 이미지 생성 모델은 사용하지 않습니다: 모든 선은 코드로, 모든 소리는 합성됩니다. 저작권 걱정이 없고, 결과는 결정적이며 프레임 단위로 수정 가능합니다.
작동하는 예제 (템플릿으로 참조): ornekler/animasyon-bir-hafta/ — 7일 타임랩스, 4:5 비율, 17.7초, 프로그래밍된 음악과 효과음.
먼저 읽어보세요: references/ilkeler.md (왜 효과적인지, 플랫폼 표, 주제 찾기, 정직성)와 references/tarifler.md (엔진 선택, 구성, 캐릭터, 사운드, 검증 — 모두 계측을 통해 발견된 함정들).
명령어는 Python으로 .venv/bin/python을 사용하세요 (Windows: .venv\Scripts\python).
의존성: numpy, Pillow, ffmpeg.
워크플로
1. 짧은 논의
아이디어가 불분명하거나 사용자가 "먼저 얘기하자"고 하면: 3-4가지 개념을 제안하세요 (각각 한 문장의 재치 + 효과적인 이유), 그중 하나를 추천하세요. 한 번의 질문 라운드에서 다음을 물어보세요: 아이디어, 비율 (X: 4:5 / 16:9, Reels: 9:16), 길이. 사용자가 "만들지 말고 먼저 얘기하자"고 하면 코드를 작성하지 마세요.
2. 비트 시트 — 코드 작성 전에
초 단위 계획: 각 비트 = 하나의 시각적 아이디어 + 최대 한 문장.
- 길이: X: 15-30초, Reels: 20-40초, YouTube 인트로: 3-8초. 사용자가 짧게 원하면 하한선 적용.
- 구조: 앵커 (모서리에 고정 카운터: 일/년) + 반복되는 캐릭터 + 장면당 하나의 객체 + 고조 + 회상하는 결말. 결말이 시작으로 연결되면 영상이 반복됩니다.
- 사운드의 주요 지점 (비트, 컷, 침묵)은 계획 단계에서 그 순간에 기록하며, 나중에 추가하지 않습니다.
3. 엔진
- 그리기, 캐릭터, 파티클, 스택 → 이 스킬:
kit/murekkep.py+kit/sentez.py. - 숫자, 텍스트, 그래픽 위주의 모션 그래픽 (카운터, 막대 그래프, 비교) →
x-animasyon스킬 (Remotion).
import sys; sys.path.insert(0, ".claude/skills/animasyon/kit")
import murekkep as M, sentez as Z
프로젝트 폴더 calisma/<ad>/: anim.py (이미지 + program()), ses.py (같은 프로그램을 읽음).
예제를 복사하여 시작하세요; 경로는 KOK와 CIKTI 상수에서 변경합니다.
| 구성 요소 | 기능 |
|---|---|
M.Tuval(w, h) | 종이 질감 배경 (2배로 그려진 후 bitir()로 축소: 부드러운 가장자리) |
M.Kalem(d, kare, s, sc, ox, oy) | 번지는 잉크 선, 원, 다각형, 텍스트; 장면 변환 |
M.Iskelet, M.yuru, M.poz_karistir | 관절형 캐릭터, 절차적 걷기, 포즈 전환 |
M.yaz_mp4(kare_fn, sure, yol, w, h, ses=wav) | 프레임을 ffmpeg으로 파이프, 오디오 추가 |
Z.harp/yayli/bas/flut/taiko | 악기들 (음정은 계측으로 보정됨) |
Z.whoosh/tus/yazma/ding/tik/hisirti/swell | 효과음 (whoosh 부드러움, 키보드는 인간 리듬) |
Z.yanki, Z.kes, Z.yaz_wav(buf, yol, lufs) | 에코, 코미디 컷, 타겟 LUFS의 WAV 저장 |
4. 미리보기 → 수정 → 렌더링
전체 렌더링 전에 4-6개의 키 프레임을 PNG로 출력하고 (예제에서는 --kare 2,7.5,15.5) 직접 확인하세요.
첫 번째 시도에서는 항상 무언가 잘못됩니다: 답답한 구성, 텍스트를 가리는 객체, 반복되는 텍스트, 보이지 말아야 할 것이 간격으로 보이는 현상 등. 수정한 후 전체 렌더링을 하세요. 미리보기를 전체 렌더링과 같은 명령어에 연결하세요: 프레임을 보지 않고 긴 렌더링을 시작하지 마십시오.
5. 계측 — 눈과 귀로는 확인할 수 없습니다
.venv/bin/python .claude/skills/animasyon/kit/denetim.py calisma/<ad>/<ad>.mp4
연결된 프레임 수 + LUFS/실제 피크 + 0.5초 음성 프로필 + 시각적 전환. 합성된 음정이 변경되었다면 --perde 플래그 사용. 계획된 침묵, 비트, 컷이 제자리에 있는지 확인하세요. 계측할 수 없는 것 (음색이 좋은지, 농담이 재미있는지)은 사용자에게 명확히 맡깁니다.
6. 전달 및 게시글
파일 경로, 길이, 크기, 계측 요약을 제공하세요. 게시글은 2-3줄: 이야기의 핵심 문장. 정직성: "단일 프롬프트 / 원샷" 주장은 진짜로 한 번에 생성된 경우에만 사용하세요; 여러 번 수정했다면 "한 번에"라고 말하지 마십시오. 어떤 모델이 생성했는지 정확히 밝히세요.
규칙
- 텍스트는 번지지 않으며, 크기가 조정되지 않습니다; 장면당 한 줄. 이모지는 폰트에 없습니다.
- 움직이는 객체는 제목/카운터 밴드 영역을 침범하지 않습니다 (들어가기 전에 사라짐).
- 단일 강조 색상만 사용 (잉크 작업에서는 알림 빨간색); 나머지는 종이 + 잉크.
- 세로 작업에서 아래 ~520px와 오른쪽 x > 900 영역은 플랫폼 UI 영역입니다: 거기에 텍스트를 넣지 마세요.
- 오디오: 단독 비디오는 -15 LUFS; 그 아래에 대화가 있을 경우 음악은 대화보다 확실히 작게. 음악은 오직 합성 또는 사용자가 라이선스를 확인한 소스만 사용.
- 화면에 계측되지 않은 숫자는 없습니다; 예시 숫자라면 그 사실을 명시하세요.
- 새로운 함정을 발견했다면
references/tarifler.md에 기록하세요; 새로운 영구 구성 요소 (전환, 리깅 추가)가 나왔다면kit/디렉토리에 추가하세요.