Communitygithub.com

HTML Motion Pipeline (9:16 설명, VO + SFX → MP4)

릴스/틱톡용 9:16 가로세로비 2D 플랫모션 스타일의 설명 동영상을 제작하는 파이프라인입니다. 사용자 VO(음성 파일)와 SFX를 동기화하여 최종 MP4를 출력하며, 'Function Calling이란?' 영상(44.6초, 1080×1920, VO+31개 SFX)으로 검증되었습니다.

HTML Motion Pipeline (9:16 설명, VO + SFX → MP4)란 무엇인가요?

이 스킬은 사용자가 직접 제공한 음성 파일(VO, TTS 아님)과 절차적 SFX를 기반으로 9:16 세로형 MP4 설명 동영상을 제작하는 완전한 파이프라인입니다. 주 사용처는 릴스/틱톡 같은 숏폼 플랫폼의 에듀테크 계정에서 흔히 보는 2D 플랫모션 스타일입니다. 파이프라인은 사용자 VO 수집 및 분할, ffmpeg를 이용한 템포 조절, faster-whisper로 단어 단위 전사, GSAP 기반 HTML 애니메이션 타임라인 구축, DOM 오버플로우/충돌 감사, Playwright로 프레임별 렌더링, ffmpeg로 최종 MP4 인코딩 순서로 진행됩니다. 핵심 원칙은 '시각 요소는 대본과 VO를 따라야 한다'는 것으로, 모든 화면 요소는 대본에 등장하고 VO에서 언급되어야 하며, 각 중요한 구절은 고유한 시각적 장면을 가져야 합니다. 자동 감사 도구(audit2.mjs, audit_overlap.mjs, audit_center.mjs)를 통해 레이아웃 오류(텍스트 잘림, 겹침, 상단 쏠림)를 사전에 발견하여 렌더링 시간을 절약합니다. 대표적인 주의사항으로는 연결선이 로고나 텍스트를 관통하지 않도록 z-index 관리, 자막이 하단 UI 영역(360px)을 침범하지 않도록 bottom≥390px 배치, 렌더링 시 메모리 부족을 방지하기 위해 400프레임마다 브라우저 재시작 등이 문서화되어 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hasbiridwan57-creator/hermes-video-motion-skills/tree/main/html-motion-pipeline

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

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

문서

HTML Motion Pipeline (9:16 설명, VO + SFX → MP4)은(는) 무엇을 하나요?

검증된 워크플로우입니다. 각 단계마다 assets/pipeline/에 바로 사용할 수 있는 명령어가 준비되어 있습니다. 전체 구현 참조: assets/pipeline/index.fc-reference.html (Function Calling 프로젝트 — 복사한 후 콘텐츠를 교체하고, 처음부터 작성하지 마세요).

이 파이프라인이 필요한 이유

  • 결정론적: GSAP 타임라인이 paused 상태로 프레임 단위로 탐색되며 → MP4는 미리보기와 동일합니다.
  • 사용자 직접 VO (ElevenLabs/마이크 파일), TTS 아님; 템포는 수동 제어합니다.
  • 자동 레이아웃 감사가 텍스트 캔버스 이탈 및 요소 충돌을 감지하여 — 전체 렌더링 전에 반드시 통과해야 합니다(1338프레임 렌더링 절약).
  • 깔끔한 연결선: 노드 가장자리에 앵커를 배치하고 뒷 레이어에 배치합니다 (Pitfall #1 참조).

핵심 원칙 (이것이 핵심입니다)

시각 요소는 대본 & VO를 따라야 하며, 그 반대가 되어서는 안 됩니다.

  1. 화면에 표시되는 모든 것은 대본에 있어야 하며 VO에서 말해져야 합니다. 아무리 예뻐도 내레이션이 없는 요소는 제거하세요.
  2. 반대로, 대본의 모든 중요한 아이디어/문장에는 해당 구절이 말해질 때 나타나는 고유한 그림이 있어야 합니다. 단순히 텍스트로만 존재하는 문장은 '조용한' 장면입니다 → 시각 자료를 추가하세요.
  3. 장면이 많아도 괜찮습니다 — 중요한 것은 각 장면이 VO와 대본을 따른다는 것입니다.
  4. 그림과 애니메이션이 많을수록 좋습니다 (더 생동감 있습니다). 시각 자료를 아끼지 마세요; 풍부한 시각 자료는 약점이 아닌 강점입니다.
  5. 시각 자료의 순서와 타이밍 = VO에서 언급되는 순서와 타이밍 (타임스탬프 기준)이며, 임의로 정하지 마세요.
  6. 시각적 디테일의 품질도 유지되어야 합니다: 아이콘이 무엇을 의미하는지 명확하게 읽혀야 하고, 요소가 균형을 이루며 허공에 떠 있지 않아야 합니다.

워크플로우 (순서대로 따르세요)

#단계출력
1사용자 VO 수집 및 세그먼트 분할 (숨 쉬는 간격 기준)meta.json
2ffmpeg atempo로 VO 템포 조절 + 간격 삽입; 변형 선택vo.wav
3단어 단위 전사 (faster-whisper, pip install faster-whisper)assets/words.json
4index.html 빌드 (VO 타이밍에 맞춘 8개 장면) + sfx_score.pyHTML + SFX WAV
5VO + SFX 믹스 → public/full_mix.mp3최종 오디오
6레이아웃 감사 (audit2.mjs + audit_s2.mjs) — 반드시 오버플로우 0보고서
7프레임 렌더링 (render_frames.mjs) → 1338 PNGframes/
8인코딩 (encode.sh) → MP4public/*.mp4
9최종 MP4 시각 확인 — MP4에서 프레임 추출, vision 분석깨끗함 확인

초기 설정 한 번

cd <프로젝트>
npm init -y && npm install playwright-core gsap
pip install faster-whisper   # 단어 단위 전사용
# 필요: Google Chrome (/Applications/Google Chrome.app), ffmpeg

파이프라인 스크립트

assets/pipeline/:

  • render_frames.mjs — 타임라인을 프레임별로 탐색, 1080×1920 @30fps 스크린샷을 찍습니다.
  • snap.mjs — 특정 초의 스냅샷 (node snap.mjs 1.0 6.5 17.5)을 찍어 시각적 확인을 합니다.
  • audit2.mjs — 모든 장면을 검사합니다: 텍스트 캔버스 이탈 / 하단 UI 영역(>1560px) 침범 / 충돌.
  • audit_s2.mjs — 여러 초에 걸쳐 단일 장면(sc2)을 감사합니다 (너무 이른 공개, 가장자리 근접 감지).
  • audit_overlap.mjs — 실제로 겹치는 텍스트를 감지합니다 (텍스트×텍스트, 텍스트×이미지, 텍스트×버튼). 설계상 허용되는 충돌(예: SVG 컨테이너 내부 레이블, 취소선/관통선, 나란히 배치된 자막 플렉스)을 지능적으로 구분하여 보고하지 않습니다. node assets/pipeline/audit_overlap.mjs 실행 → TOTAL 겹침: 0이 목표입니다.
  • audit_center.mjs — '위로 떠 있는' 콘텐츠를 감지합니다 (하단 2/3가 비어 있음). 각 장면의 콘텐츠 바운딩을 측정하고 이상적인 중앙(y≈960, 1920px 기준)으로부터의 편차를 계산합니다. 편차 > 250px = ⚠ 떠 있음. node assets/pipeline/audit_center.mjs로 실행하세요.
  • typing-prompt.js — '타이핑 프롬프트' 애니메이션 레시피 (코딩/AI 테마의 핵심): 프롬프트가 한 글자씩 타이핑되고 커서가 깜빡이며, 앱이 응답합니다(색상 변경 → 오류 → 수정 → 반복). 전체 예제: 리포지토리 09-vibe-coding/index.html SK4 장면.
  • encode.sh — ffmpeg → H.264 yuv420p CRF18 + AAC 192k + +faststart.
  • sfx_score.py — 단어 타이밍에 동기화된 절차적 SFX 스코어.
  • index.fc-reference.html — 전체 구현 (복사 후 콘텐츠 교체).

HTML 규칙 (index.fc-reference.html 기준)

  • #stage 1080×1920, 점 그리드 배경; #world (카메라 리그, 장면별 미세 스케일); 장면 = .scene (visibility hidden, 타임라인으로 show/hide).
  • 단어 단위 자막: assets/words.json → 최대 4단어 덩어리로 그룹화, 각 덩어리 = 하나의 .line (position:absolute, 상자를 확장하지 않도록 쌓음), 활성 단어 .on, 키워드 .key (호박색). 아래쪽에서 390px 위치 (릴스/틱톡 하단 ~360px을 가리는 UI 영역으로부터 안전함).
  • 연결선: link(svg, idA, idB) 함수가 노드 가장자리(edge/edgeT)에 앵커를 계산합니다 — 선이 로고 중앙에서 나오지 않습니다. SVG .wires는 .scene의 첫 번째 자식으로 배치됩니다(z-index:0) (카드 뒤에, z-index:2). 부드러운 곡선(bow ≤26px), 회색 #7A8188 8px; 활성 선 .hot은 호박색 15px.
  • 에이전트 로고: OPENCLAW_SVG 인라인 (붉은 랍스터), 🤖가 포함된 모든 .node.dark에 자동으로 적용됩니다. 다른 아이덴티티로 변경하려면 교체하세요.
  • GSAP 결정론적: 타임라인 paused, window.__tl & window.__updateSub 노출. 정적 스냅샷(헤드리스)은 ?t=<초>, 수동 스크러빙은 ?debug 모드.

트리거

사용자가 **

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

motion-format

Bikin video motion graphic lewat chat dengan alur kerja Motion Format — Reels/TikTok/Shorts 9:16, YouTube 16:9, atau feed 1:1 — dari brief sampai MP4 bersuara (voiceover + efek suara ElevenLabs, subtitle per kata). Punya resep gaya siap pakai dari seri konten Motion Format: Isometrik Dibongkar (cara kerja mesin, 3D), Sejarah 3D Sinematik (bangunan & peristiwa bersejarah), Tubuh Manusia Anime (organ tubuh), Dunia 2D Bertekstur (noir, cat air, ukiran, lanskap anime), Kartun Cel Cerah (tokoh menjelaskan), Peta Relief Sinematik (geografi, jalur, wilayah), dan Promo Produk & Iklan (UMKM, aplikasi, flash sale) — plus cara meracik gaya sendiri. Gunakan setiap kali user meminta "video", "konten Reels/TikTok/Shorts", "explainer", "video edukasi", "video penjelasan", "promo", "iklan", "intro", "animasi", "motion graphic", menyebut salah satu gaya di atas atau "Resep Gaya", ingin menambah voiceover/efek suara/subtitle, ingin merevisi video yang sudah ada, atau ingin merender jadi MP4 — walau tida

video-motion

SOP induk untuk bikin video motion/explainer bersuara via chat (9:16 Reels/TikTok, 16:9 YouTube, 1:1 feed) — menggabungkan alur kerja Motion Format (brief→gaya→naskah→ suara→adegan→render), hukum sinematik Bang Motion (video bukan slide, deterministik, gaya dari tema), dan pipeline HTML→MP4 teruji (html-motion-pipeline: faster-whisper, SFX prosedural, CDP render, audit layout, subtitle aman Reels). Gunakan bila user minta video motion/explainer/animasi/promo, atau "kayak video sebelumnya" — walau tidak menyebut "motion graphic".

관련 스킬