Remotion Math Explainer (remotion-math-explainer)
Visão Geral
Transforma qualquer derivação matemática, teorema, prova ou conjunto de slides em um vídeo explicativo Remotion MP4 1920×1080 30fps totalmente sincronizado, no formato single-pane Log2Base2 Studio.
Nunca divida a tela em painéis laterais concorrentes ou paredes de cartões de texto empilhados. Cada vídeo usa um palco visual unificado (<SinglePaneStage>) para que toda a atenção do espectador permaneça na história visual:
- Barra Superior Mínima (
44px, integrada aoSinglePaneStage):- Título do tópico + pílula da seção ativa à esquerda; contador de etapas sutil + barra de progresso fina à direita.
- ÚNICO Palco Log2Base2 Unificado (
SinglePaneStage— 100% de largura):- Cabeçalho Spotlight de Linha Única: Mostra apenas o título da etapa atual e a única linha de equação ativa (destacando o termo falado ativo no local com
borderBottom: "2px solid #FACC15", nunca adicionando padding horizontal) além de uma pílula compacta de chamada de token ativo (símbolo→significado em linguagem simples) surgindo emtriggerFrame. - Canvas SVG Imersivo em Largura Total (
viewBox="0 0 1600 680"): Gráficos em movimento contínuos e espaçosos — grades de coordenadas vivas com pontos de dados coloridos se esticando e colapsando, números deslizando fisicamente de matrizes para blocos menores, linhas de corte a laser, barras de magnitude sinalizadas e cubos unitários 3D se desfazendo de volta à identidade — integrados diretamente no mesmo canvas aberto.
- Cabeçalho Spotlight de Linha Única: Mostra apenas o título da etapa atual e a única linha de equação ativa (destacando o termo falado ativo no local com
- Barra de Legenda Inferior Mínima (
VoiceoverCaptionBar—68px):- Legendas limpas centralizadas com destaque palavra por palavra no estilo karaokê, acionadas por timestamps exatos de
WordBoundarydo TTS.
- Legendas limpas centralizadas com destaque palavra por palavra no estilo karaokê, acionadas por timestamps exatos de
Dependências
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md): Deve ser seguido para todas as regras de animação Remotion (useCurrentFrame(),interpolate(),spring(),<Sequence premountFor>,<Audio>,@remotion/google-fontse zero transições CSS).uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md): Necessário para executaruv run --with edge-ttsna síntese de voz neural.
Início Rápido
# 1. Scaffold do projeto Remotion math explainer
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/caminho/para/projeto" \
--output "/caminho/para/projeto/scaffold-status.json"
# 2. Sintetizar narração neural natural + timestamps exatos WordBoundary e de termos
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/caminho/para/projeto" \
--beats-json "/caminho/para/projeto/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/caminho/para/projeto/public/voiceover/manifest.json"
# 3. Renderizar MP4 final em 1080p 30fps via renderizador rápido com 8 workers e deduplicação de keyframes
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/caminho/para/projeto" \
--composition-id "MathExplainer" \
--out-name "MathExplainer.mp4" \
--concurrency 8 \
--output "/caminho/para/projeto/render-report.json"
Narrativa Imersiva e Fluxo de Trabalho
- Projetar Beats Energéticos (
beats.json) :- Escreva narração conversacional e com gancho inicial (evite frases secas de livro didático) para que até estudantes desmotivados permaneçam engajados.
- Mantenha
snippetcom 2–4 linhas nítidas onde cadatokenapareça literalmente em uma linha e corresponda a umatriggerWordlimpa em minúsculas emtext. - Defina
"motionStepFrames": 2em beats com animações contínuas de curvas, vetores, grades ou elementos voadores.
- Scaffold e Sintetizar Voz:
- Execute
scaffold(copiaSinglePaneStage.tsx,VoiceoverCaptionBar.tsxerender_full_mp4.mjs) esynthesize-voiceoveratravés descripts/explainer_cli.py.
- Execute
- Criar Gráficos em Movimento em Tela Cheia (
viewBox="0 0 1600 680"):- Passe seu palco SVG imersivo como
childrenpara<SinglePaneStage>. - Mostre, não conte: Substitua cartões estáticos de texto/bullet por movimento físico — partículas/pontos montados em deformações de coordenadas, elementos voando entre posições, linhas de laser varrendo, medidores ao vivo e gráficos lado a lado no mesmo canvas aberto.
- Sempre envolva linhas de grade que se deformam/estendem dentro de
<clipPath>para que o movimento nunca sangre sobre rótulos ou pílulas.
- Passe seu palco SVG imersivo como
- Verificar Stills e Renderizar MP4 Final:
- Execute
npm run linte inspecione stills representativos (npx remotion still) comread_fileantes de executarrender-mp4. - Copie o
.mp4final paraout/, a raiz do projeto e a raiz do workspace.
- Execute
Limitação de Taxa e Erros Comuns
scripts/explainer_cli.pyimpõe/tmp/remotion_edge_tts.lock(espaçamento de0.35s, 3 tentativas com1s/2s/4sde backoff).- Nunca use um layout de tela dividida com vários painéis ou empilhe subcartões com borda — use
<SinglePaneStage>para que haja estritamente um painel principal na tela. - Nunca despeje uma prova completa de várias etapas na tela de uma vez; destaque uma linha de equação ativa e uma pílula de chamada ativa por vez.
- Nunca adicione
paddinghorizontal a tokens inline destacados (apenasborderBottom: "2px solid #FACC15"ebackgroundColor).