Remotion Math Explainer (remotion-math-explainer)
Présentation
Convertit toute dérivation mathématique, théorème, preuve ou présentation en une vidéo explicative immersive 1920×1080 30fps MP4 avec Remotion, au Format Studio Log2Base2 à un seul panneau.
Ne divise jamais l'écran en panneaux concurrents (côte à côte ou piles de fiches). Chaque vidéo utilise une scène visuelle unique (<SinglePaneStage>) pour que l'attention du spectateur reste entièrement focalisée sur l'histoire visuelle :
- Barre supérieure minimale (
44px, intégrée àSinglePaneStage) :- Titre du sujet + pilule de section active courante à gauche ; compteur d'étapes discret + barre de progression fine à droite.
- UNE scène Log2Base2 unifiée (
SinglePaneStage— 100% de largeur) :- En-tête spot sur une ligne : affiche uniquement le titre de l'étape courante et la ligne d'équation active unique (surlignage du terme parlé en place avec
borderBottom: "2px solid #FACC15", sans jamais ajouter de padding horizontal) plus une pilule d'appel de terme actif compacte (symbole→signification en langage clair) qui apparaît avec une animation autriggerFrame. - Canvas SVG immersif pleine largeur (
viewBox="0 0 1600 680") : graphiques animés continus et spacieux — grilles de coordonnées vivantes avec points de données colorés qui s'étirent et se contractent, nombres qui glissent physiquement hors des matrices dans des blocs mineurs, traits de laser qui balayent, barres de magnitude signées et cubes unités 3D qui se déforment pour revenir à l'identité — intégrés directement sur le même canevas ouvert.
- En-tête spot sur une ligne : affiche uniquement le titre de l'étape courante et la ligne d'équation active unique (surlignage du terme parlé en place avec
- Barre de sous-titres inférieure minimale (
VoiceoverCaptionBar—68px) :- Sous-titres centrés et nets en mode karaoké mot par mot, entraînés par les timestamps exacts
WordBoundaryde la synthèse vocale TTS.
- Sous-titres centrés et nets en mode karaoké mot par mot, entraînés par les timestamps exacts
Dépendances
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md) : doit être suivi pour toutes les règles d'animation Remotion (useCurrentFrame(),interpolate(),spring(),<Sequence premountFor>,<Audio>,@remotion/google-fonts, et zéro transition CSS).uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md) : nécessaire pour exécuteruv run --with edge-ttspour la synthèse vocale neuronale.
Démarrage rapide
# 1. Créer le projet Remotion math explainer
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/chemin/vers/projet" \
--output "/chemin/vers/projet/scaffold-status.json"
# 2. Synthétiser la voix off neuronale naturelle + timestamps exacts WordBoundary et des termes
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/chemin/vers/projet" \
--beats-json "/chemin/vers/projet/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/chemin/vers/projet/public/voiceover/manifest.json"
# 3. Rendre le MP4 final 1080p 30fps via le moteur de rendu rapide à 8 workers avec déduplication d'images clés
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/chemin/vers/projet" \
--composition-id "MathExplainer" \
--out-name "MathExplainer.mp4" \
--concurrency 8 \
--output "/chemin/vers/projet/render-report.json"
Narration immersive et flux de travail
- Concevoir des séquences rythmées (
beats.json) :- Rédiger une narration conversationnelle avec un accroche forte (éviter le ton sec des manuels) pour que même les étudiants non motivés restent engagés.
- Limiter
snippetà 2–4 lignes concises où chaquetokenapparaît textuellement dans une ligne et correspond à untriggerWordpropre en minuscules danstext. - Mettre
"motionStepFrames": 2sur les séquences avec des animations continues de courbes, vecteurs, grilles ou éléments volants.
- Créer le projet et synthétiser la voix off :
- Exécuter
scaffold(copieSinglePaneStage.tsx,VoiceoverCaptionBar.tsxetrender_full_mp4.mjs) etsynthesize-voiceoverviascripts/explainer_cli.py.
- Exécuter
- Créer les graphiques animés plein-canvas (
viewBox="0 0 1600 680") :- Passer votre scène SVG immersive comme
childrende<SinglePaneStage>. - Montrer, ne pas dire : remplacer les fiches de texte statiques par des mouvements physiques — particules/points qui suivent des déformations de coordonnées, éléments qui volent entre positions, traits de laser qui balayent, jauges vivantes et tracés en direct côte à côte dans le même canevas ouvert.
- Toujours envelopper les lignes de grille qui se déforment/s'étendent dans
<clipPath>pour que le mouvement ne déborde jamais sur les libellés ou les pilules.
- Passer votre scène SVG immersive comme
- Vérifier les images fixes et rendre le MP4 final :
- Exécuter
npm run lintet inspecter des images fixes représentatives (npx remotion still) avecread_fileavant de lancerrender-mp4. - Copier le fichier
.mp4final dansout/, la racine du projet et la racine de l'espace de travail.
- Exécuter
Limitation de débit et erreurs fréquentes
scripts/explainer_cli.pyapplique un verrou/tmp/remotion_edge_tts.lock(espacement de0.35s, 3 tentatives avec backoff1s/2s/4s).- Ne jamais utiliser une disposition en écran divisé multi-panneaux ou empiler des sous-fiches bordées — utiliser
<SinglePaneStage>pour qu'il n'y ait strictement qu'un panneau principal à l'écran. - Ne jamais afficher une preuve multi-étapes complète en une fois ; ne mettre en avant qu'une ligne d'équation active et une pilule d'appel active à la fois.
- Ne jamais ajouter de
paddinghorizontal aux termes en surbrillance inline (borderBottom: "2px solid #FACC15"etbackgroundColorseulement).