Communitygithub.com

비트 모션 그래픽

15초 또는 30초, 비트에 잠긴 모션 그래픽 단편을 코드로 만든다. 절차적 Canvas, 헤드리스 Chrome 프레임, 합성 사운드. 스톡 에셋은 쓰지 않는다.

비트 모션 그래픽란 무엇인가요?

홍보, 설명, 출시, 쇼케이스용으로 코드만 쓰는 파이프라인. 1080p60. 그림은 절차적 HTML5 Canvas, 프레임은 헤드리스 Chrome으로 잡고, 소리는 가져오지 않고 비트에 맞춰 합성한다. 스톡 라이브러리도 타임라인 편집기도 필요 없다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cccPhoenix/beat-motion-graphics/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

비트 기반 절차적 모션 그래픽

스튜디오 수준의 키네틱 타이포그래피와 절차적 모션 그래픽 비디오를 4단계 코드 파이프라인으로 제작합니다:

index.html (HTML5 Canvas 비트 기반 렌더러)
    ↓  프레임별 캡처 (10× 셔터 모션 블러)
scripts/render.py (Headless Chrome CDP → ffmpeg H.264)
    ↓
make_audio.py (동일한 비트 그리드 상의 절차적 파형 및 EDM 합성)
    ↓
ffmpeg 먹싱 → final.mp4 (1920×1080, 60 fps, AAC 스테레오)

시각 요소, 전환, 카메라 흔들림, 글리치 효과, 드럼, 코드, 리저까지 모두 하나의 공유 템포 그리드(기본 128 BPM) 상의 비트 번호에 의해 스케줄링됩니다. 수동 타임라인 정렬, 외부 스톡 푸티지, 타사 Python 패키지가 전혀 필요하지 않습니다.


워크플로우

Step 1 — 환경 점검

파일을 작성하기 전에 로컬 필수 조건을 확인하세요:

  1. ffmpeg / ffprobe (libx264 및 aac 인코더 포함).
  2. Headless Chrome / Chromium 바이너리 (macOS에서는 Google Chrome, Linux에서는 chromium / google-chrome).
  3. 대상 스크립트와 일치하는 시스템 폰트 (예: 라틴어용 굵은 기하학적 산세리프, CJK용 PingFang / Hiragino / Noto Sans, HUD/코드용 모노스페이스).

Step 2 — 비트 매핑 스토리보드

렌더링 코드를 작성하기 전에 사용자의 주제를 비트 시트로 변환하세요.

  • 지속 시간 선택: 15초 = 32비트 또는 30초 = 64비트 (128 BPM, SPB = 60 / 128 = 0.46875 초/비트).
  • storyboard-prompt-template.md의 내러티브 흐름을 따르세요: 훅 → 긴장/대비 → 개념 시각화 (그래프/터널/모프/3D) → 빠른 빌드업 + 카운트다운 → 0.1초 무음 블랙아웃 → 파티클 드롭 피날레.
  • 화면 상의 카피는 매우 간결하게 유지: 13개의 영어 핵심 단어(200400px)와 최대 한 줄의 짧은 자막(36~70px)을 짝지으세요. 문단을 작성하지 마십시오.

Step 3 — index.html 빌드 (비주얼 엔진)

다음을 노출하는 자체 포함 단일 파일 HTML5 Canvas 렌더러(1920×1080)를 생성하세요:

  • 폰트, 오프스크린 스프라이트, 모프 셰이프, 파티클 대상 초기화 완료 후 window.READY === true.
  • window.TOTAL (정수 총 프레임 수, 예: 900 또는 1800).
  • window.MB (설정 가능한 모션 블러 서브샘플 수, 최종 렌더링 시 기본 10, 빠른 미리보기 시 1).
  • 해당 정확한 프레임의 JPEG Data URL을 반환하는 window.frameData(frameIndex, quality).

visual-style-guide.md의 시각적 기본 요소 및 후처리 파이프라인을 따르세요.

Step 4 — 시각적 스틸 프레임 검사 (필수 게이트)

절대 900~1800 프레임 전체 렌더링을 맹목적으로 실행하지 마십시오. 항상 먼저 12~16개의 대표 키 프레임을 캡처하여 연락처 시트로 검사하세요:

python3 scripts/render.py --html ./index.html --stills 60,200,330,420,560,780,920,1110,1280,1450,1560,1650,1760
ffmpeg -y -loglevel error -pattern_type glob -i 'preview/f*.jpg' -vf "scale=640:360,tile=4x4" -frames:v 1 preview/sheet.jpg

preview/sheet.jpg를 검사하고 다음을 확인하세요:

  • 텍스트가 모서리 HUD와 충돌하지 않음 (주 콘텐츠를 y ∈ [100, 980], x ∈ [100, 1820] 내에 유지).
  • 모든 폰트가 올바르게 로드됨 (tofu/대체 세리프 글리치 없음).
  • 밝고 어두운 장면에서 대비가 읽기 쉬움; HUD difference 블렌드가 읽기 쉬운 상태 유지.
  • 모션 블러, 글로우, 파티클 수렴이 깔끔하고 중앙에 위치함.

전체 렌더링 전에 레이아웃 문제를 수정하고 재확인하세요.

Step 5 — 절차적 사운드트랙 생성 (make_audio.py)

make_audio_template.py를 index.html에서 사용된 정확한 BPM, BEATS, SCENE_TRANSITIONS, DROP_BEAT와 일치하도록 조정하세요. 합성 규칙은 audio-synthesis-guide.md를 참조하세요.

먹싱 전에 생성된 music.wav를 확인하세요:

  • 지속 시간이 BEATS * 60 / BPM과 정확히 일치해야 함.
  • 스펙트로그램(showspectrumpic) 또는 초당 RMS 검사를 렌더링하여 깔끔한 다이내믹, 명확한 비트 구조, 드롭 직전 약 0.1초 무음 갭을 확인하세요.

Step 6 — 전체 렌더링 및 먹싱

  1. MB=10 모션 블러로 60 fps의 모든 프레임 렌더링:
    python3 scripts/render.py --html ./index.html --out video.mp4 --mb 10
    
  2. 비디오 스트림을 복사하여 비디오와 오디오 먹싱:
    ffmpeg -y -loglevel error -i video.mp4 -i music.wav \
      -c:v copy -c:a aac -b:a 256k -shortest final.mp4
    
  3. final.mp4에 대해 최종 ffprobe + 6프레임 연락처 시트 검사를 실행하여 1920x1080, 60 fps, h264 + aac, 정확한 지속 시간, 깔끔한 출력을 확인하세요.

엄격한 제약 조건 및 엔지니어링 규칙

  1. 단일 비트 클록: index.html과 make_audio.py 모두 beat = t / (60 / BPM)에서 엄격하게 시간을 도출해야 합니다. 음악과 어긋날 수 있는 마법의 밀리초 오프셋을 하드코딩하지 마십시오.
  2. 결정적 렌더링: 프레임/요소 인덱스를 키로 하는 시드 기반 PRNG(예: mulberry32)를 사용하십시오. 렌더 루프 내에서 Math.random()을 절대 사용하지 마십시오. 그렇게 하면 10배 모션 블러 서브샘플이 혼란스러운 깜박임 없이 일관성을 유지합니다.
  3. 10× 셔터 모션 블러: 0.75-프레임 셔터 윈도우에 걸쳐 10개의 서브 프레임을 평균화합니다(alpha = 1 / (k + 1) 누적). 8개 미만의 샘플은 빠른 키네틱 타이포그래피에서 계단식 고스팅을 생성합니다.
  4. 제로 의존성 Python: render.py와 make_audio.py는 Python 표준 라이브러리만 사용해야 합니다(os, json, subprocess, base64, math, random, wave, array). 따라서 pip install 또는 numpy 없이 어디서나 실행할 수 있습니다.
  5. 비용이 많이 드는 글로우 사전 베이크: 복잡한 텍스트/카드에 대해 10개의 모션 블러 패스에 걸쳐 프레임당 ctx.shadowBlur를 호출하지 마십시오. init() 중에 오프스크린 캔버스에 글로우 히어로 스프라이트를 사전 렌더링하거나 누적된 저알파 스트로크(glowStroke)를 사용하세요.
  6. 드롭 전 무음: 클라이맥스 드롭 비트 직전에 약 0.10 초의 전체 시각적 블랙아웃과 전체 오디오 무음을 삽입하여 인지된 임팩트를 최대화하세요.
  7. 사실적 규율: 비디오가 실제 제품/기술적 주장을 제시하는 경우, 먼저 사실을 확인하고 확인되지 않은 숫자(예: 상충되는 가격 또는 확인되지 않은 벤치마크 백분율)는 생략하세요.

관련 스킬