Manim Video-Produktions-Pipeline
Wann verwenden
Verwenden, wenn Nutzer Folgendes anfordern: animierte Erklärungen, mathematische Animationen, Konzeptvisualisierungen, Algorithmus-Walkthroughs, technische Erklärstücke, 3Blue1Brown-artige Videos oder jede programmatische Animation mit geometrischem/mathematischem Inhalt. Erstellt 3Blue1Brown-artige Erklärvideos, Algorithmusvisualisierungen, Gleichungsherleitungen, Architekturdiagramme und Datenstorys mit Manim Community Edition.
Kreativitätsstandard
Dies ist Bildungskino. Jeder Frame lehrt. Jede Animation offenbart Struktur.
Bevor eine einzige Zeile Code geschrieben wird, artikuliere den narrativen Bogen. Welches Missverständnis wird korrigiert? Was ist der „Aha-Moment"? Welche visuelle Geschichte führt den Zuschauer von Verwirrung zu Verständnis? Die Anfrage des Nutzers ist ein Ausgangspunkt – interpretiere sie mit pädagogischem Ehrgeiz.
Geometrie vor Algebra. Zeige zuerst die Form, dann die Gleichung. Visuelles Gedächtnis kodiert schneller als symbolisches Gedächtnis. Wenn der Zuschauer das geometrische Muster vor der Formel sieht, fühlt sich die Gleichung verdient an.
Exzellenz im ersten Render ist nicht verhandelbar. Die Ausgabe muss visuell klar und ästhetisch kohärent sein, ohne Überarbeitungsrunden. Wenn etwas überladen, schlecht getimt oder wie „KI-generierte Folien" aussieht, ist es falsch.
Deckkraftschichtung lenkt die Aufmerksamkeit. Zeige niemals alles in voller Helligkeit. Primäre Elemente auf 1.0, kontextuelle Elemente auf 0.4, strukturelle Elemente (Achsen, Gitter) auf 0.15. Das Gehirn verarbeitet visuelle Auffälligkeit in Schichten.
Atempause. Jede Animation benötigt self.wait() danach. Der Zuschauer braucht Zeit, um das eben Erschienene zu verarbeiten. Eile nie von einer Animation zur nächsten. Eine 2-sekündige Pause nach einer Schlüsselenthüllung ist niemals verschwendet.
Kohärente visuelle Sprache. Alle Szenen teilen eine Farbpalette, konsistente Typografiegrößen, passende Animationsgeschwindigkeiten. Ein technisch korrektes Video, in dem jede Szene zufällige verschiedene 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 |
|---|---|---|---|
| Konzepterklärer | Thema/Konzept | Animierte Erklärung mit geometrischer Intuition | references/scene-planning.md |
| Gleichungsherleitung | Mathematische Ausdrücke | Schrittweise animierter Beweis | references/equations.md |
| Algorithmusvisualisierung | Algorithmusbeschreibung | Schrittweise Ausführung mit Datenstrukturen | references/graphs-and-data.md |
| Datenstory | Daten/Metriken | Animierte Diagramme, Vergleiche, Zähler | references/graphs-and-data.md |
| Architekturdiagramm | Systembeschreibung | Komponenten, die sich mit Verbindungen aufbauen | references/mobjects.md |
| Paper-Erklärer | Forschungsarbeit | Zentrale Ergebnisse und Methoden animiert | 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.
| Schicht | Werkzeug | Zweck |
|---|---|---|
| Kern | Manim Community Edition | Szenen-Rendering, Animations-Engine |
| Mathematik | LaTeX (texlive/MiKTeX) | Gleichungsrendering via MathTex |
| Video I/O | ffmpeg | Szenenverknüpfung, Formatkonvertierung, Audio-Multiplexing |
| TTS | ElevenLabs / Qwen3-TTS (optional) | Sprachausgabe als Voiceover |
Pipeline
PLANEN --> CODIEREN --> RENDERN --> VERKNÜPFEN --> AUDIO (optional) --> ÜBERPRÜFEN
- PLANEN — Schreibe
plan.mdmit narrativem Bogen, Szenenliste, visuellen Elementen, Farbpalette, Voiceover-Skript - CODIEREN — Schreibe
script.pymit einer Klasse pro Szene, jede unabhängig renderbar - RENDERN —
manim -ql script.py Szene1 Szene2 ...für Entwurf,-qhfür Produktion - VERKNÜPFEN — ffmpeg concat der Szenenclips zu
final.mp4 - AUDIO (optional) — Füge Voiceover und/oder Hintergrundmusik via ffmpeg hinzu. Siehe
references/rendering.md - ÜBERPRÜFEN — Rendere Vorschaustandbilder, überprüfe gegen Plan, passe an
Projektstruktur
projektname/
plan.md # Narrativer Bogen, Szenenaufteilung
script.py # Alle Szenen in einer Datei
concat.txt # ffmpeg Szenenliste
final.mp4 # Verknüpfte Ausgabe
media/ # Automatisch generiert von Manim
videos/script/480p15/
Kreative Richtung
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 | Einladend |
| Neon Tech | #0A0A0A | #00F5FF | #FF00FF | #39FF14 | Systeme, Architektur |
| Monochrom | #1A1A2E | #EAEAEA | #888888 | #FFFFFF | Minimalistisch |
Animationsgeschwindigkeit
| Kontext | run_time | self.wait() nachher |
|---|---|---|
| Titel/Einführung erscheinen | 1.5s | 1.0s |
| Schlüsselgleichung enthüllen | 2.0s | 2.0s |
| Transformieren/Verwandeln | 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ärtext |
| Beschriftung | 24 | Anmerkungen, Achsenbeschriftungen |
| Untertitel | 20 | Untertitel, Kleingedrucktes |
Schriftarten
Verwende Nichtproportionalschriften für jeglichen Text. Manims Pango-Renderer produziert gebrochenes Kerning mit proportionalen Schriftarten bei allen Größen. Siehe references/visual-design.md für vollständige Empfehlungen.
MONO = "Menlo" # einmalig am Anfang 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") # Mathematik (verwendet LaTeX)
Minimale font_size=18 für Lesbarkeit.
Szenenvariation
Verwende niemals identische Konfiguration für alle Szenen. Für jede Szene:
- Andere dominante Farbe aus der Palette
- Anderes Layout — zentriere nicht immer alles
- Anderer Animationseintritt — variiere zwischen Write, FadeIn, GrowFromCenter, Create
- Anderes visuelles Gewicht — einige Szenen dicht, andere spärlich
Arbeitsablauf
Schritt 1: Planen (plan.md)
Vor jeglichem Code, schreibe plan.md. Siehe references/scene-planning.md für die umfassende Vorlage.
Schritt 2: Codieren (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_Einleitung(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 am Dateianfang für szenenübergreifende Konsistenz
self.camera.background_colorin jeder Szene gesetzt- Saubere Ausgänge — FadeOut aller Mobjects am Szenenende:
self.play(FadeOut(Group(*self.mobjects)))
Schritt 3: Rendern
manim -ql script.py Szene1_Einleitung Szene2_Kernkonzept # Entwurf
manim -qh script.py Szene1_Einleitung Szene2_Kernkonzept # Produktion
Schritt 4: Verknüpfen
cat > concat.txt << 'EOF'
datei 'media/videos/script/480p15/Szene1_Einleitung.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üfen
manim -ql --format=png -s script.py Szene2_Kernkonzept # Vorschaustandbild
Kritische Implementierungshinweise
Raw-Strings für LaTeX
# FALSCH: MathTex("\\frac{1}{2}")
# RICHTIG:
MathTex(r"\frac{1}{2}")
buff >= 0.5 für Randtexte
label.to_edge(DOWN, buff=0.5) # niemals < 0.5
FadeOut vor Textersetzung
self.play(ReplacementTransform(notiz1, notiz2)) # nicht Write(notiz2) darüber
Niemals Nicht-Hinzugefügte Mobjects Animieren
self.play(Create(kreis)) # muss zuerst hinzugefügt werden
self.play(kreis.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 |
Iteriere immer mit -ql. Rendere -qh nur für die endgültige Ausgabe.
Referenzen
| Datei | Inhalt |
|---|---|
references/animations.md | Kernanimationen, Geschwindigkeitsfunktionen, Komposition, .animate-Syntax, Timing-Muster |
references/mobjects.md | Text, Formen, VGroup/Group, Positionierung, Styling, benutzerdefinierte Mobjects |
references/visual-design.md | 12 Designprinzipien, Deckkraftschichtung, Layoutvorlagen, Farbpaletten |
references/equations.md | LaTeX in Manim, TransformMatchingTex, Herleitungsmuster |
references/graphs-and-data.md | Achsen, Plotten, BarChart, animierte Daten, Algorithmusvisualisierung |
references/camera-and-3d.md | MovingCameraScene, ThreeDScene, 3D-Oberflächen, Kamerasteuerung |
references/scene-planning.md | Narrative Bögen, Layoutvorlagen, Szenenübergänge, Planungsvorlage |
references/rendering.md | CLI-Referenz, Qualitätsvoreinstellungen, 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, Erzählsynchronisation |
references/updaters-and-trackers.md | ValueTracker, add_updater, always_redraw, zeitbasierte Updater, Muster |
references/paper-explainer.md | Forschungspapiere in Animationen verwandeln – Arbeitsablauf, Vorlagen, Domänenmuster |
references/decorations.md | SurroundingRectangle, Brace, Pfeile, DashedLine, Winkel, Anmerkungslebenszyklus |
references/production-quality.md | Vor-Code-, Vor-Render-, Nach-Render-Checklisten, räumliches Layout, Farbe, Tempo |
Kreative Abweichung (nur verwenden, wenn Nutzer experimentelle/kreative/einzigartige Ausgaben anfordern)
Wenn der Nutzer nach kreativen, experimentellen oder unkonventionellen Erklärungsansätzen fragt, wähle eine Strategie und durchdenke sie VOR dem Design der Animation.
- SCAMPER — wenn der Nutzer eine neue Perspektive auf eine Standarderklärung möchte
- Annahmeumkehrung — wenn der Nutzer herausfordern möchte, wie etwas typischerweise gelehrt wird
SCAMPER-Transformation
Nimm eine Standard-Mathematik-/Technikvisualisierung und transformiere sie:
- Substitute: ersetze die Standard-Visualmetapher (Zahlenstrahl → gewundener Pfad, Matrix → Stadtgitter)
- Combine: kombiniere zwei Erklärungsansätze (algebraisch + geometrisch gleichzeitig)
- Reverse: leite rückwärts her – beginne mit dem Ergebnis und dekonstruiere bis zu den Axiomen
- Modify: übertreibe einen Parameter, um zu zeigen, warum er wichtig ist (10x die Lernrate, 1000x die Stichprobengröße)
- Eliminate: entferne alle Notation – erkläre rein durch Animation und räumliche Beziehungen
Annahmeumkehrung
- Liste auf, was „Standard" 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-Herleitung, 3D-Einbettung eines 2D-Konzepts, kontinuierliches Verwandeln statt Schritte, Null Notation)
- Erkunde, was die Umkehrung offenbart, was der Standardansatz verbirgt