Remotion Math Explainer (remotion-math-explainer)
Descripción general
Convierte cualquier derivación matemática, teorema, demostración o presentación en un video explicativo 1920×1080 30fps MP4 inmersivo y sincronizado cuadro a cuadro, en el Formato Single-Pane Log2Base2 Studio.
Nunca dividas la pantalla en paneles laterales enfrentados o paredes de tarjetas de texto apiladas. Cada video usa una única escena visual unificada (<SinglePaneStage>) para que la atención del espectador permanezca fija en la historia visual:
- Barra superior mínima (
44px, integrada enSinglePaneStage):- Título del tema + píldora de sección activa actual a la izquierda; contador de paso sutil + barra de progreso fina a la derecha.
- UNA escena Log2Base2 unificada (
SinglePaneStage— 100% de ancho):- Encabezado de foco en una sola línea: Muestra solo el título del paso actual y la línea de ecuación activa única (resaltando el término hablado activo en su lugar con
borderBottom: "2px solid #FACC15", sin agregar nunca relleno horizontal) más una píldora compacta de información del token activo (símbolo→significado en lenguaje natural) que aparece entriggerFrame. - Lienzo SVG inmersivo de ancho completo (
viewBox="0 0 1600 680"): Gráficos en movimiento continuos y espaciosos: cuadrículas de coordenadas vivas con puntos de datos de colores que se estiran y colapsan, números que se deslizan físicamente de matrices a bloques menores, líneas de tachado que barren, barras de magnitud con signo y cubos unitarios 3D que se deshacen hasta la identidad, integrados directamente en el mismo lienzo abierto.
- Encabezado de foco en una sola línea: Muestra solo el título del paso actual y la línea de ecuación activa única (resaltando el término hablado activo en su lugar con
- Barra de subtítulos inferior mínima (
VoiceoverCaptionBar—68px):- Subtítulos karaoke limpios centrados, palabra por palabra resaltada, impulsados por marcas de tiempo exactas de
WordBoundaryde TTS.
- Subtítulos karaoke limpios centrados, palabra por palabra resaltada, impulsados por marcas de tiempo exactas de
Dependencias
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md): Deben seguirse todas las reglas de animación de Remotion (useCurrentFrame(),interpolate(),spring(),<Sequence premountFor>,<Audio>,@remotion/google-fonts, y cero transiciones CSS).uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md): Requerido para ejecutaruv run --with edge-ttspara la síntesis de voz neural.
Inicio rápido
# 1. Crear el proyecto explicador de matemáticas con Remotion
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/ruta/al/proyecto" \
--output "/ruta/al/proyecto/scaffold-status.json"
# 2. Sintetizar voz neural natural + marcas de tiempo WordBoundary y de términos exactas
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/ruta/al/proyecto" \
--beats-json "/ruta/al/proyecto/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/ruta/al/proyecto/public/voiceover/manifest.json"
# 3. Renderizar el MP4 final a 1080p 30fps mediante el renderizador rápido de 8 workers con deduplicación de fotogramas clave
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/ruta/al/proyecto" \
--composition-id "MathExplainer" \
--out-name "MathExplainer.mp4" \
--concurrency 8 \
--output "/ruta/al/proyecto/render-report.json"
Narración inmersiva y flujo de trabajo
- Diseñar beats energéticos (
beats.json):- Escribe una narración conversacional y atractiva (evita la redacción de libros de texto seca) para que incluso los estudiantes sin motivación sigan interesados.
- Mantén el
snippeten 2–4 líneas nítidas donde cadatokenaparezca textualmente en una línea y coincida con unatriggerWordlimpia en minúsculas entext. - Establece
"motionStepFrames": 2en beats con animaciones continuas de curvas, vectores, cuadrículas o elementos voladores.
- Crear proyecto y sintetizar voz:
- Ejecuta
scaffold(copiaSinglePaneStage.tsx,VoiceoverCaptionBar.tsxyrender_full_mp4.mjs) ysynthesize-voiceovermediantescripts/explainer_cli.py.
- Ejecuta
- Crear gráficos en movimiento de lienzo completo (
viewBox="0 0 1600 680"):- Pasa tu escena SVG inmersiva como
childrena<SinglePaneStage>. - Muestra, no digas: Reemplaza las tarjetas estáticas de texto/viñetas con movimiento físico: partículas/puntos que recorren deformaciones de coordenadas, elementos que vuelan entre posiciones, líneas de barrido láser, indicadores en vivo y gráficos en vivo lado a lado dentro del mismo lienzo abierto.
- Siempre envuelve las líneas de cuadrícula que se deforman/extienden dentro de
<clipPath>para que el movimiento nunca se superponga a etiquetas o píldoras.
- Pasa tu escena SVG inmersiva como
- Verificar fotogramas fijos y renderizar MP4 final:
- Ejecuta
npm run linte inspecciona fotogramas fijos representativos (npx remotion still) conread_fileantes de ejecutarrender-mp4. - Copia el
.mp4final aout/, la raíz del proyecto y la raíz del espacio de trabajo.
- Ejecuta
Límites de velocidad y errores comunes
scripts/explainer_cli.pyimpone/tmp/remotion_edge_tts.lock(espaciado de0.35s, 3 reintentos con retroceso de1s/2s/4s).- Nunca uses un diseño de pantalla dividida con múltiples paneles ni apiles sub-tarjetas con bordes—usa
<SinglePaneStage>para que haya estrictamente un panel principal en pantalla. - Nunca muestres una demostración completa de varios pasos a la vez; resalta una línea de ecuación activa y una píldora de información activa a la vez.
- Nunca agregues
paddinghorizontal a los tokens en línea resaltados (soloborderBottom: "2px solid #FACC15"ybackgroundColor).