Remotion Physics Explainer (remotion-physics-explainer)
개요
어떤 물리학 개념, 법칙 또는 문제를 단일 패널 Log2Base2 스튜디오 형식의 프레임 동기화된 1920×1080 30fps MP4 Remotion 설명 동영상으로 변환합니다.
화면을 경쟁하는 나란히 있는 창이나 쌓인 텍스트 카드 벽으로 분할하지 않습니다. 모든 동영상은 하나의 통합된 시각적 스테이지(<SinglePaneStage>)를 사용합니다:
- 최소 상단 바 (
SinglePaneStage에 내장된44px):- 왼쪽: 주제 제목 + 활성 섹션 파일; 오른쪽: 미묘한 단계 카운터 + 얇은 진행률 표시줄.
- 하나의 통합된 Log2Base2 스테이지 (
SinglePaneStage— 100% 너비):- 집중된 한 줄 스포트라이트 헤더: 활성 구절 물리 기호(
F,m,a,E,B,λ,Ψ,ΔS)를 활성 방정식 줄에borderBottom: "2px solid #FACC15"로 강조 표시합니다(가로 패딩 절대 추가 금지). 또한triggerFrame에 하나의 간결한 활성 설명 파일(기호→물리적 의미 + SI 단위)을 추가합니다. - 전체 너비 몰입형 SVG 캔버스 (
viewBox="0 0 1600 680"): 넓은 실시간 물리 시뮬레이션 — 진자, 발사체 궤적, $\vec{B}$-장에서 휘는 대전 입자, 간섭하는 파면, 에너지 막대 전달, 실시간 벡터 오버레이 — 동일한 열린 캔버스에서 직접 애니메이션됩니다.
- 집중된 한 줄 스포트라이트 헤더: 활성 구절 물리 기호(
- 최소 하단 자막 표시줄 (
VoiceoverCaptionBar—68px):- 정확한 TTS
WordBoundary타임스탬프로 구동되는 깔끔한 중앙 정렬 단어별 강조 자막.
- 정확한 TTS
종속성
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md): 모든 Remotion 애니메이션 규칙(useCurrentFrame(),interpolate(),spring(),<Sequence premountFor>,<Audio>,@remotion/google-fonts, CSS 전환 없음)에 대해 따라야 합니다.uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md):uv run --with edge-tts실행에 필요합니다.
빠른 시작
# 1. Remotion 물리 설명 프로젝트 스캐폴딩
uv run python3 \
~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/path/to/project" \
--output "/path/to/project/scaffold-status.json"
# 2. 자연스러운 신경망 음성 해설 + 정확한 WordBoundary 타임스탬프 합성
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/path/to/project" \
--beats-json "/path/to/project/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/path/to/project/public/voiceover/manifest.json"
# 3. 최종 1080p 30fps MP4 렌더링
uv run python3 \
~/.gemini/config/skills/remotion-physics-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "PhysicsExplainer" \
--out-name "PhysicsExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
몰입형 스토리텔링 및 워크플로
snippet을 집중적으로 유지하세요 (2–4줄). 이렇게 하면<SinglePaneStage>가 한 번에 하나의 활성 방정식과 하나의 활성 기호 설명 파일을 스포트라이트할 수 있습니다.- 연속적인 물리적 움직임(진자, 파동, 장, 입자)이 있는 비트에는
"motionStepFrames": 2를 설정하세요. - 보여주고 말하지 마세요: 힘, 장, 에너지 교환, 실시간 움직임 그래프를 동일한 전체 너비
1600×680SVG 캔버스 내에서 (clipPath를 사용하여 움직이는 플롯/파동 처리) 함께 애니메이션하세요. 별도의 분할 화면 상자를 절대 사용하지 마세요. - 항상
npm run lint를 실행하고,read_file과 함께 대표적인 정지 프레임(npx remotion still)을 검사하고, 최종.mp4를out/, 프로젝트 루트, 작업 공간 루트에 저장하세요.