Remotion Math Explainer (remotion-math-explainer)
Übersicht
Verwandelt jede mathematische Ableitung, jedes Theorem, jeden Beweis oder jede Folienpräsentation in ein immersives, framesynchronisiertes 1920×1080 30fps MP4 Remotion-Erklärvideo im Single-Pane-Log2Base2-Studio-Format.
Teile den Bildschirm niemals in konkurrierende Side-by-Side-Panels oder gestapelte Textkartenwände auf. Jedes Video verwendet eine einzige, einheitliche visuelle Bühne (<SinglePaneStage>), sodass die volle Aufmerksamkeit des Betrachters auf der visuellen Geschichte bleibt:
- Minimale obere Leiste (
44px, inSinglePaneStageintegriert):- Titel des Themas + aktuelle Abschnittsmarkierung links; dezenter Schritt-Indikator + dünner Fortschrittsbalken rechts.
- EINHEITLICHE Log2Base2-Bühne (
SinglePaneStage– 100% Breite):- Fokussierter Einzeiler-Spotlight-Header: Zeigt nur den aktuellen Schritttitel und die aktive Gleichungszeile (Hervorhebung des gesprochenen Begriffs an Ort und Stelle mit
borderBottom: "2px solid #FACC15", niemals horizontales Padding) plus eine kompakte, aktive Erklärungskachel (symbol→alltagssprachliche Bedeutung), die beitriggerFrameerscheint. - Vollformatige immersive SVG-Leinwand (
viewBox="0 0 1600 680"): Großzügige, kontinuierliche Bewegungsgrafiken – Live-Koordinatengitter mit farbigen Datenpunkten, die sich ausdehnen und zusammenziehen, Zahlen, die physisch aus Matrizen in kleine Blöcke gleiten, schwungvolle Laser-Durchstreichungen, Balken mit Vorzeichen und 3D-Einheitswürfel, die sich zurück zur Identität entzerren – direkt auf derselben offenen Leinwand integriert.
- Fokussierter Einzeiler-Spotlight-Header: Zeigt nur den aktuellen Schritttitel und die aktive Gleichungszeile (Hervorhebung des gesprochenen Begriffs an Ort und Stelle mit
- Minimale untere Untertitel-Leiste (
VoiceoverCaptionBar–68px):- Saubere, zentrierte Karaoke-Wort-für-Wort-Untertitel mit Hervorhebung, gesteuert durch exakte
WordBoundary-Millisekunden-Zeitstempel der TTS.
- Saubere, zentrierte Karaoke-Wort-für-Wort-Untertitel mit Hervorhebung, gesteuert durch exakte
Abhängigkeiten
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md): Muss für alle Remotion-Animationen befolgt werden (useCurrentFrame(),interpolate(),spring(),<Sequence premountFor>,<Audio>,@remotion/google-fontsund keine CSS-Übergänge).uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md): Erforderlich zum Ausführen vonuv run --with edge-ttsfür die neuronale Sprachsynthese.
Kurzstart
# 1. Erstelle das Remotion-Mathe-Erklärprojekt
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/pfad/zum/projekt" \
--output "/pfad/zum/projekt/scaffold-status.json"
# 2. Synthetisiere natürliche neuronale Sprachausgabe + exakte WordBoundary & Begriff-Zeitstempel
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/pfad/zum/projekt" \
--beats-json "/pfad/zum/projekt/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/pfad/zum/projekt/public/voiceover/manifest.json"
# 3. Rendere das finale 1080p 30fps MP4 über den schnellen 8-Worker-Keyframe-Deduplication-Renderer
uv run python3 \
~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/pfad/zum/projekt" \
--composition-id "MathExplainer" \
--out-name "MathExplainer.mp4" \
--concurrency 8 \
--output "/pfad/zum/projekt/render-report.json"
Immersive Erzählweise & Arbeitsablauf
- Entwerfe energiegeladene Beats (
beats.json):- Schreibe eine gesprächige, hakenbetonte Erzählung (vermeide trockene Lehrbuchformulierungen), damit auch unmotivierte Studenten engagiert bleiben.
- Halte
snippetauf 2–4 prägnante Zeilen, wobei jedestokenwörtlich in einer Zeile erscheint und mit einem sauberen, kleingeschriebenentriggerWordintextübereinstimmt. - Setze
"motionStepFrames": 2auf Beats mit kontinuierlichen Kurven-, Vektor-, Gitter- oder fliegenden Element-Animationen.
- Erstelle Projektgerüst & synthetisiere Sprachausgabe:
- Führe
scaffold(kopiertSinglePaneStage.tsx,VoiceoverCaptionBar.tsxundrender_full_mp4.mjs) undsynthesize-voiceoverüberscripts/explainer_cli.pyaus.
- Führe
- Autorisiere Voll-Canvas-Bewegungsgrafiken (
viewBox="0 0 1600 680"):- Übergib deine immersive SVG-Bühne als
childrenan<SinglePaneStage>. - Zeigen, nicht erzählen: Ersetze statische Text-/Kartenkarten durch physische Bewegung – Partikel/Punkte, die auf Koordinatenverzerrungen reiten, Elemente, die zwischen Positionen fliegen, schwungvolle Laserlinien, Live-Anzeigen und Live-Plots nebeneinander in der gleichen offenen Leinwand.
- Wickle verzerrte/sich ausdehnende Gitterlinien immer in
<clipPath>, damit die Bewegung niemals über Labels oder Kacheln läuft.
- Übergib deine immersive SVG-Bühne als
- Überprüfe Standbilder & rendere finales MP4:
- Führe
npm run lintaus und inspiziere repräsentative Einzelbilder (npx remotion still) mitread_file, bevor durender-mp4ausführst. - Kopiere das finale
.mp4inout/, das Projekt-Stammverzeichnis und das Workspace-Stammverzeichnis.
- Führe
Ratenbegrenzung & Häufige Fehler
scripts/explainer_cli.pyerzwingt/tmp/remotion_edge_tts.lock(0,35sAbstand, 3 Wiederholungen mit1s/2s/4sBackoff).- Verwende niemals ein geteiltes Multi-Pane-Layout oder gestapelte Unterkarten – verwende
<SinglePaneStage>, sodass es streng einen Hauptbereich auf dem Bildschirm gibt. - Überflute niemals den gesamten Bildschirm mit einem mehrstufigen Beweis; hebe jeweils eine aktive Gleichungszeile und eine aktive Erklärungskachel hervor.
- Füge niemals horizontales
paddingzu hervorgehobenen Inline-Tokens hinzu (borderBottom: "2px solid #FACC15"undbackgroundColornur).