Remotion 소프트웨어 엔지니어링 설명 동영상 (remotion-software-explainer)
개요
시스템 설계, 분산 아키텍처, 디자인 패턴, 데이터베이스 내부 구조, DevOps 워크플로 등 모든 주제를 프레임 동기화된 1920×1080 30fps MP4 Remotion 설명 동영상으로 변환합니다. 단일 화면 Log2Base2 스튜디오 형식을 사용합니다.
화면을 여러 개의 경쟁적인 분할 창이나 텍스트 카드 벽으로 나누지 않습니다. 모든 동영상은 하나의 통합된 시각적 무대 (<SinglePaneStage>)를 사용합니다:
- 미니멀 상단 바 (
SinglePaneStage내장44px):- 왼쪽에 주제 제목 + 활성 섹션 필, 오른쪽에 미묘한 단계 카운터 + 얇은 진행 막대.
- 하나의 통합된 Log2Base2 무대 (
SinglePaneStage— 100% 너비):- 집중된 한 줄 스포트라이트 헤더: 활성화된 음성 요소(
replicas: 3,ConsistentHash,WAL,CircuitBreaker)를 활성 사양/계약 줄에서borderBottom: "2px solid #FACC15"로 강조 표시하고(절대로 가로 패딩을 추가하지 마세요)triggerFrame에 하나의 간결한 활성 콜아웃 필(term→architectural role)을 추가합니다. - 전체 너비 몰입형 SVG 캔버스 (
viewBox="0 0 1600 680"): 음성에 따라 점진적으로 나타나는 서비스 노드(Client, API Gateway, Load Balancer, Microservices, Message Queue, Cache, DB Shards, K8s Pods), 애니메이션 대시 파이프라인으로 연결된 이동하는 요청 패킷, 실시간 캐시 적중/처리량 게이지, 동일한 열린 캔버스 위를 직접 흐르는 요청 추적 범위.
- 집중된 한 줄 스포트라이트 헤더: 활성화된 음성 요소(
- 미니멀 하단 자막 바 (
VoiceoverCaptionBar—68px):- 정확한 TTS
WordBoundary타임스탬프에 의해 구동되는 깔끔한 중앙 정렬 단어별 강조 자막.
- 정확한 TTS
의존성
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md)uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md)
빠른 시작
# 1. 스캐폴딩
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/path/to/project" \
--output "/path/to/project/scaffold-status.json"
# 2. 음성 합성
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-software-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 MP4 렌더링
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/path/to/project" \
--composition-id "SoftwareExplainer" \
--out-name "SoftwareExplainer.mp4" \
--concurrency 8 \
--output "/path/to/project/render-report.json"
몰입형 스토리텔링 및 워크플로
snippet을 집중적으로 유지하세요(2–4줄).<SinglePaneStage>가 하나의 활성 계약 줄을 스포트라이트하고 아키텍처 노드를 점진적으로 표시할 수 있도록 하며, 절대 처음부터 15개의 상자를 덤프하지 마세요.- 이동하는 요청 패킷, 장애 조치(failover) 계단식 전파, 또는 오토스케일링 애니메이션이 있는 비트에는
"motionStepFrames": 2를 설정하세요. - 말로 설명하지 말고 보여주세요: 별도의 분할 화면 상자가 아닌, 동일한 전체 너비
1600×680SVG 캔버스 내에서 요청 패킷이 노드 사이를 이동하는 애니메이션과 실시간 지연 시간/대기열/추적 막대를 직접 표시하세요(<clipPath>를 필요한 곳에 사용). - 항상
npm run lint를 실행하고,read_file로 대표적인 정지 프레임(npx remotion still)을 검사한 후 최종.mp4를out/, 프로젝트 루트, 작업 공간 루트에 저장하세요.