Manim Video-Produktionspipeline
Kreativstandard
Dies ist Bildungskino. Jeder Frame lehrt. Jede Animation enthüllt Struktur.
Bevor eine einzige Zeile Code geschrieben wird, muss der erzählerische Bogen artikuliert werden. Welches Missverständnis wird korrigiert? Was ist der „Aha-Moment"? Welche visuelle Geschichte führt den Zuschauer von Verwirrung zu Verständnis? Der Prompt des Benutzers ist ein Ausgangspunkt – interpretiere ihn mit pädagogischem Ehrgeiz.
Geometrie vor Algebra. Zeige zuerst die Form, dann die Gleichung. Das visuelle Gedächtnis kodiert schneller als das symbolische Gedächtnis. Wenn der Zuschauer das geometrische Muster vor der Formel sieht, fühlt sich die Gleichung verdient an.
Exzellenz beim ersten Rendern ist nicht verhandelbar. Die Ausgabe muss visuell klar und ästhetisch kohärent sein, ohne Überarbeitungsschleifen. Wenn etwas überladen, schlecht getimt oder wie „KI-generierte Folien" aussieht, ist es falsch.
Opazitätsschichten lenken die Aufmerksamkeit. Zeige niemals alles bei voller Helligkeit. Primäre Elemente bei 1.0, kontextuelle Elemente bei 0.4, strukturelle Elemente (Achsen, Gitter) bei 0.15. Das Gehirn verarbeitet visuelle Auffälligkeit in Schichten.
Atempause. Jede Animation braucht ein self.wait() danach. Der Zuschauer braucht Zeit, um das gerade Erschienene aufzunehmen. Hetze niemals von einer Animation zur nächsten. Eine 2-sekündige Pause nach einer wichtigen Enthüllung ist niemals verschwendet.
Kohärente visuelle Sprache. Alle Szenen teilen sich eine Farbpalette, einheitliche Typografie-Größen, passende Animationsgeschwindigkeiten. Ein technisch korrektes Video, in dem jede Szene zufällige, unterschiedliche Farben verwendet, ist ein ästhetischer Fehlschlag.
Voraussetzungen
Führe scripts/setup.sh aus, um alle Abhängigkeiten zu überprüfen. Erforderlich: Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (texlive-full unter Linux, mactex unter macOS) und ffmpeg. Referenzdokumente getestet gegen Manim CE v0.20.1.
Modi
| Modus | Eingabe | Ausgabe | Referenz |
|---|---|---|---|
| Konzept-Erklärung | Thema/Konzept | Animierte Erklärung mit geometrischer Intuition | references/scene-planning.md |
| Gleichungsableitung | Mathematische Ausdrücke | Schrittweise animierter Beweis | references/equations.md |
| Algorithmusvisualisierung | Algorithmusbeschreibung | Schrittweise Ausführung mit Datenstrukturen | references/graphs-and-data.md |
| Datengeschichte | Daten/Metriken | Animierte Diagramme, Vergleiche, Zähler | references/graphs-and-data.md |
| Architekturdiagramm | Systembeschreibung | Komponentenaufbau mit Verbindungen | references/mobjects.md |
| Papier-Erklärung | Forschungsarbeit | Animierte Schlüsselergebnisse und Methoden | references/scene-planning.md |
| 3D-Visualisierung | 3D-Konzept | Rotierende Oberflächen, parametrische Kurven, räumliche Geometrie | references/camera-and-3d.md |
Stack
Ein einzelnes Python-Skript pro Projekt. Kein Browser, kein Node.js, keine GPU erforderlich.
| Ebene | Werkzeug | Zweck |
|---|---|---|
| Kern | Manim Community Edition | Szenen-Rendering, Animations-Engine |
| Mathematik | LaTeX (texlive/MiKTeX) | Gleichungsdarstellung via MathTex |
| Video I/O | ffmpeg | Szenenzusammenschnitt, Formatkonvertierung, Audio-Muxing |
| TTS | ElevenLabs / Qwen3-TTS (optional) | Sprachausgabe (Voiceover) |
Pipeline
PLAN --> CODE --> RENDER --> STITCH --> AUDIO (optional) --> REVIEW
- PLAN — Schreibe
plan.mdmit erzählerischem Bogen, Szenenliste, visuellen Elementen, Farbpalette, Voiceover-Skript - CODE — Schreibe
script.pymit einer Klasse pro Szene, jede unabhängig renderbar - RENDER —
manim -ql script.py Szene1 Szene2 ...für Entwurf,-qhfür Produktion - STITCH — ffmpeg concat der Szenenclips zu
final.mp4 - AUDIO (optional) — Füge Voiceover und/oder Hintergrundmusik via ffmpeg hinzu. Siehe
references/rendering.md - REVIEW — Rendere Vorschaubilder, überprüfe gegen Plan, passe an
Projektstruktur
projekt-name/
plan.md # Erzählerischer Bogen, Szenenaufschlüsselung
script.py # Alle Szenen in einer Datei
concat.txt # ffmpeg Szenenliste
final.mp4 # Zusammengeschnittene Ausgabe
media/ # Automatisch von Manim generiert
videos/script/480p15/
Kreativrichtung
Farbpaletten
| Palette | Hintergrund | Primär | Sekundär | Akzent | Anwendungsfall |
|---|---|---|---|---|---|
| Klassisch 3B1B | #1C1C1C | #58C4DD (BLAU) | #83C167 (GRÜN) | #FFFF00 (GELB) | Allgemein Mathe/CS |
| Warm akademisch | #2D2B55 | #FF6B6B | #FFD93D | #6BCB77 | Zugänglich |
| Neon tech | #0A0A0A | #00F5FF | #FF00FF | #39FF14 | Systeme, Architektur |
| Monochrom | #1A1A2E | #EAEAEA | #888888 | #FFFFFF | Minimalistisch |
Animationsgeschwindigkeit
| Kontext | run_time | self.wait() danach |
|---|---|---|
| Titel/Einführung erscheinen | 1.5s | 1.0s |
| Schlüsselgleichung enthüllt | 2.0s | 2.0s |
| Transformieren/Morphen | 1.5s | 1.5s |
| Unterstützende Beschriftung | 0.8s | 0.5s |
| FadeOut Bereinigung | 0.5s | 0.3s |
| „Aha-Moment"-Enthüllung | 2.5s | 3.0s |
Typografie-Skala
| Rolle | Schriftgröße | Verwendung |
|---|---|---|
| Titel | 48 | Szenentitel, Eröffnungstext |
| Überschrift | 36 | Abschnittsüberschriften innerhalb einer Szene |
| Fließtext | 30 | Erklärender Text |
| Beschriftung | 24 | Annotationen, Achsenbeschriftungen |
| Bildunterschrift | 20 | Untertitel, Kleingedrucktes |
Schriftarten
Verwende Monospace-Schriftarten für allen Text. Manims Pango-Renderer erzeugt defekte Kerning mit proportionalen Schriftarten in allen Größen. Siehe references/visual-design.md für vollständige Empfehlungen.
MONO = "Menlo" # einmal oben in der Datei definieren
Text("Fourier-Reihe", font_size=48, font=MONO, weight=BOLD) # Titel
Text("n=1: sin(x)", font_size=20, font=MONO) # Beschriftungen
MathTex(r"\nabla L") # Mathe (verwendet LaTeX)
Minimale font_size=18 für Lesbarkeit.
Pro-Szene-Variation
Verwende niemals identische Konfiguration für alle Szenen. Für jede Szene:
- Andere dominante Farbe aus der Palette
- Anderes Layout – nicht immer alles zentrieren
- Anderer Animationseintritt – variiere zwischen Write, FadeIn, GrowFromCenter, Create
- Anderes visuelles Gewicht – manche Szenen dicht, andere spärlich
Arbeitsablauf
Schritt 1: Plan (plan.md)
Vor jeglichem Code schreibe plan.md. Siehe references/scene-planning.md für die umfassende Vorlage.
Schritt 2: Code (script.py)
Eine Klasse pro Szene. Jede Szene ist unabhängig renderbar.
from manim import *
BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"
class Szene1_Einfuehrung(Scene):
def construct(self):
self.camera.background_color = BG
title = Text("Warum funktioniert das?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
self.add_subcaption("Warum funktioniert das?", duration=2)
self.play(Write(title), run_time=1.5)
self.wait(1.0)
self.play(FadeOut(title), run_time=0.5)
Wichtige Muster:
- Untertitel bei jeder Animation:
self.add_subcaption("text", duration=N)odersubcaption="text"beiself.play() - Geteilte Farbkonstanten oben in der Datei für szenenübergreifende Konsistenz
self.camera.background_colorin jeder Szene setzen- Saubere Ausgänge — FadeOut aller Mobjects am Szenenende:
self.play(FadeOut(Group(*self.mobjects)))
Schritt 3: Rendern
manim -ql script.py Szene1_Einfuehrung Szene2_Kernkonzept # Entwurf
manim -qh script.py Szene1_Einfuehrung Szene2_Kernkonzept # Produktion
Schritt 4: Zusammenschneiden
cat > concat.txt << 'EOF'
datei 'media/videos/script/480p15/Szene1_Einfuehrung.mp4'
datei 'media/videos/script/480p15/Szene2_Kernkonzept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4
Schritt 5: Überprüfung
manim -ql --format=png -s script.py Szene2_Kernkonzept # Vorschaubild
Kritische Implementierungshinweise
Raw Strings für LaTeX
# FALSCH: MathTex("\frac{1}{2}")
# RICHTIG:
MathTex(r"\frac{1}{2}")
buff >= 0.5 für Randtext
label.to_edge(DOWN, buff=0.5) # niemals < 0.5
FadeOut vor dem Ersetzen von Text
self.play(ReplacementTransform(hinweis1, hinweis2)) # nicht Write(hinweis2) darüber
Niemals Nicht-Hinzugefügte Mobjects Animieren
self.play(Create(circle)) # muss zuerst hinzugefügt werden
self.play(circle.animate.set_color(RED)) # dann animieren
Leistungsziele
| Qualität | Auflösung | FPS | Geschwindigkeit |
|---|---|---|---|
-ql (Entwurf) | 854x480 | 15 | 5-15s/Szene |
-qm (Mittel) | 1280x720 | 30 | 15-60s/Szene |
-qh (Produktion) | 1920x1080 | 60 | 30-120s/Szene |
Immer bei -ql iterieren. Nur für die endgültige Ausgabe mit -qh rendern.
Referenzen
| Datei | Inhalt |
|---|---|
references/animations.md | Kernanimationen, Rate-Funktionen, Komposition, .animate-Syntax, Timing-Muster |
references/mobjects.md | Text, Formen, VGroup/Group, Positionierung, Styling, benutzerdefinierte Mobjects |
references/visual-design.md | 12 Designprinzipien, Opazitätsschichtung, Layout-Vorlagen, Farbpaletten |
references/equations.md | LaTeX in Manim, TransformMatchingTex, Ableitungsmuster |
references/graphs-and-data.md | Achsen, Zeichnen, BarChart, animierte Daten, Algorithmusvisualisierung |
references/camera-and-3d.md | MovingCameraScene, ThreeDScene, 3D-Oberflächen, Kamerasteuerung |
references/scene-planning.md | Erzählerische Bögen, Layout-Vorlagen, Szenenübergänge, Planungsvorlage |
references/rendering.md | CLI-Referenz, Qualitätseinstellungen, ffmpeg, Voiceover-Workflow, GIF-Export |
references/troubleshooting.md | LaTeX-Fehler, Animationsfehler, häufige Fehler, Debugging |
references/animation-design-thinking.md | Wann animieren vs. statisch zeigen, Zerlegung, Tempo, Synchronisation der Erzählung |
references/updaters-and-trackers.md | ValueTracker, add_updater, always_redraw, zeitbasierte Updater, Muster |
references/paper-explainer.md | Forschungsarbeiten in Animationen verwandeln – Workflow, Vorlagen, Domänenmuster |
references/decorations.md | SurroundingRectangle, Brace, Pfeile, DashedLine, Angle, Lebenszyklus von Annotationen |
references/production-quality.md | Vor-Code-, Vor-Render-, Nach-Render-Checklisten, räumliches Layout, Farbe, Tempo |
Kreative Abweichung (nur verwenden, wenn der Benutzer experimentelle/kreative/einzigartige Ausgabe anfordert)
Wenn der Benutzer kreative, experimentelle oder unkonventionelle Erklärungsansätze wünscht, wähle eine Strategie und denke VOR dem Entwurf der Animation darüber nach.
- SCAMPER – wenn der Benutzer eine neue Perspektive auf eine Standarderklärung möchte
- Annahme-Umkehrung – wenn der Benutzer herausfordern möchte, wie etwas normalerweise gelehrt wird
SCAMPER-Transformation
Nimm eine standardmäßige mathematische/technische Visualisierung und transformiere sie:
- Substituieren: ersetze die Standard-Visualmetapher (Zahlenlinie → gewundener Pfad, Matrix → Stadtgitter)
- Kombinieren: vereine zwei Erklärungsansätze (algebraisch + gleichzeitig geometrisch)
- Umkehren: leite rückwärts ab – beginne mit dem Ergebnis und zerlege es bis zu den Axiomen
- Modifizieren: übertreibe einen Parameter, um zu zeigen, warum er wichtig ist (10-fache Lernrate, 1000-fache Stichprobengröße)
- Eliminieren: entferne alle Notation – erkläre rein durch Animation und räumliche Beziehungen
Annahme-Umkehrung
- Liste auf, was „standardmäßig" daran ist, wie dieses Thema visualisiert wird (links-nach-rechts, 2D, diskrete Schritte, formale Notation)
- Wähle die grundlegendste Annahme
- Kehre sie um (rechts-nach-links-Ableitung, 3D-Einbettung eines 2D-Konzepts, kontinuierliches Morphen statt Schritte, null Notation)
- Erkunde, was die Umkehrung offenbart, das der Standardansatz verbirgt