Remotion Code Explainer (remotion-code-explainer)
Aperçu
Transforme n'importe quel fichier de code source en une vidéo explicative immersive et synchronisée au format MP4 1920×1080 à 30 images/s, dans le format de studio Log2Base2 à volet unique.
Ne scinde jamais l'écran en volets concurrents côte à côte ou en murs de cartes surchargés. Chaque vidéo utilise une seule scène visuelle unifiée (<SinglePaneStage>) pour que l'attention entière du spectateur reste focalisée sur la façon dont le code s'exécute :
- Barre supérieure minimale (
44px, intégrée àSinglePaneStage) :- Titre de la leçon + pilule de section active à gauche ; compteur d'étapes subtil + barre de progression fine à droite.
- UNE scène Log2Base2 unifiée (
SinglePaneStage— 100% de largeur) :- En-tête de spot lumineux sur une seule ligne : Affiche uniquement le titre de l'étape en cours et la ligne de code active unique en police monospace nette (mettant en évidence le token parlé actif avec
borderBottom: "2px solid #FACC15", sans jamais ajouter de rembourrage horizontal) plus une pilule d'appel compacte (token→signification en français simple) qui apparaît autriggerFrame. - Canvas SVG immersif pleine largeur (
viewBox="0 0 1600 680") : Graphiques animés spacieux et continus combinant les visuels mémoire/exécution de Log2Base2 (boîtes mémoire étiquetées0x1004, variables mutantes, flèches de pointeurs animéesstrokeDashoffset, piles de frames qui s'empilent/se dépilent, échanges de tableaux/arbres) directement à côté d'aperçus en direct de l'UI, de la sortie standard ou des tenseurs sur le même canvas ouvert.
- En-tête de spot lumineux sur une seule ligne : Affiche uniquement le titre de l'étape en cours et la ligne de code active unique en police monospace nette (mettant en évidence le token parlé actif avec
- Barre de sous-titres minimale en bas (
VoiceoverCaptionBar—68px) :- Sous-titres propres centrés mot par mot, mis en évidence comme au karaoké, pilotés par les horodatages millisecondes exacts des
WordBoundaryde la synthèse vocale (startMs,endMs).
- Sous-titres propres centrés mot par mot, mis en évidence comme au karaoké, pilotés par les horodatages millisecondes exacts des
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) : Requis pour exécuteruv run --with edge-ttspour la synthèse vocale neuronale et l'extraction des horodatagesWordBoundary.
Démarrage rapide
# 1. Créer la structure du projet Remotion explainer
uv run python3 \
~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
scaffold \
--project-dir "/chemin/vers/projet" \
--source-file "/chemin/vers/source.ext" \
--output "/chemin/vers/projet/scaffold-status.json"
# 2. Synthétiser une voix off neuronale naturelle + horodatages exacts WordBoundary et tokens
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
synthesize-voiceover \
--project-dir "/chemin/vers/projet" \
--beats-json "/chemin/vers/projet/beats.json" \
--voice "fr-FR-DeniseNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/chemin/vers/projet/public/voiceover/manifest.json"
# 3. Rendre le MP4 final 1080p 30 ips via un rendu rapide à 8 workers avec déduplication d'images clés
uv run python3 \
~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
render-mp4 \
--project-dir "/chemin/vers/projet" \
--composition-id "CodeExplainer" \
--out-name "Explainer.mp4" \
--concurrency 8 \
--output "/chemin/vers/projet/render-report.json"
Narration immersive et flux de travail
- Concevoir des beats énergiques (
beats.json) :- Rédigez une narration concise et conversationnelle qui accroche immédiatement le spectateur sur le pourquoi le code se comporte ainsi.
- Gardez
codeSnippetciblé (1–4lignes) afin que la ligne active passée à<SinglePaneStage>contienne letokenactif textuellement. - Définissez
"motionStepFrames": 2sur les beats avec des paquets voyageurs, des sauts de pointeurs, des échanges de tableaux ou des animations de tenseurs/UI en direct.
- Créer la structure et synthétiser la voix off :
- Exécutez
scaffold(copieSinglePaneStage.tsx,VoiceoverCaptionBar.tsxetrender_full_mp4.mjs) etsynthesize-voiceoverviascripts/code_explainer_cli.py.
- Exécutez
- Réaliser des graphiques animés sur tout le canvas (
viewBox="0 0 1600 680") :- Passez votre storyboard SVG animé Log2Base2 × KodeKloud comme
childrendans<SinglePaneStage>. - Montrez, ne racontez pas : Remplacez les murs de code statiques et les boîtes de texte par du mouvement physique — des valeurs volant des registres/variables vers les emplacements mémoire, des pointeurs se réorientant en douceur, des paquets de données voyageant à travers les composants, et des sorties d'état/UI en direct se mettant à jour sur le même canvas ouvert.
- Enveloppez les grilles dynamiques ou les traces défilantes dans
<clipPath>afin que le mouvement ne déborde jamais de sa région.
- Passez votre storyboard SVG animé Log2Base2 × KodeKloud comme
- Vérifier les images fixes et effectuer le rendu final MP4 :
- Exécutez
npm run lintet inspectez les images fixes représentatives (npx remotion still) avecread_filepour vérifier qu'il n'y a pas de chevauchement ou de clipping. - Exécutez
render-mp4(scripts/render_full_mp4.mjs) et assurez-vous que le.mp4final est sauvegardé dansout/, à la racine du projet et à la racine de l'espace de travail.
- Exécutez
Limitation de débit et erreurs courantes
scripts/code_explainer_cli.pyimpose/tmp/remotion_edge_tts.lock(espacement de0.35s, 3 tentatives avec backoff de1s/2s/4s).- N'utilisez jamais un tableau de bord à deux zones divisées ou un mur de code défilant de 40 lignes ; gardez l'écran sur un seul volet
<SinglePaneStage>. - N'ajoutez jamais de rembourrage
paddinghorizontal aux tokens en ligne mis en évidence (utilisez uniquementborderBottom: "2px solid #FACC15"etbackgroundColor). - N'utilisez jamais de cartes de texte statiques à l'intérieur de la scène SVG quand un mouvement animé de mémoire/pointeur/paquet peut démontrer le concept visuellement.