Manim-Videoproduktionspipeline
Kreativstandard
Das ist Bildungskino. Jeder Frame lehrt. Jede Animation offenbart Struktur.
Bevor eine einzige Zeile Code geschrieben wird, den narrativen Bogen artikulieren. Welches Missverständnis wird hiermit 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. 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 beim ersten Rendern ist nicht verhandelbar. Die Ausgabe muss visuell klar und ästhetisch kohärent sein, ohne Überarbeitungsrunden. Wenn etwas überladen, schlecht getimed oder wie „KI-generierte Folien“ aussieht, ist es falsch.
Opazitätsschichtung lenkt die Aufmerksamkeit. Zeige niemals alles in 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.
Durchatmen. Jede Animation braucht danach self.wait(). Der Zuschauer braucht Zeit, um das gerade Erschienene aufzunehmen. Nie von einer Animation zur nächsten hetzen. Eine 2-sekündige Pause nach einer Schlüsselenthüllung ist nie verschwendet.
Kohärente visuelle Sprache. Alle Szenen teilen sich eine Farbpalette, einheitliche Typografiegrößen, übereinstimmende Animationsgeschwindigkeiten. Ein technisch korrektes Video, in dem jede Szene zufällige, unterschiedliche Farben verwendet, ist ein ästhetisches Versagen.
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. Referenzdokumentation 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 |
| 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 | Komponenten, die sich mit Verbindungen aufbauen | references/mobjects.md |
| Paper-Erklärer | Forschungspapier | Wichtigste Erkenntnisse 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 |
| Mathe | LaTeX (texlive/MiKTeX) | Gleichungs-Rendering via MathTex |
| Video I/O | ffmpeg | Szenen-Zusammenfügung, Formatkonvertierung, Audio-Muxing |
| TTS | ElevenLabs / Qwen3-TTS (optional) | Erzähl-Voiceover |
Pipeline
PLAN --> CODE --> RENDER --> STITCH --> AUDIO (optional) --> REVIEW
- PLAN – Schreibe
plan.mdmit narrativem Bogen, Szenenliste, visuellen Elementen, Farbpalette, Voiceover-Skript - CODE – Schreibe
script.pymit einer Klasse pro Szene, jede unabhängig renderbar - RENDER –
manim -ql script.py Scene1 Scene2 ...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 Vorschaustills, überprüfe gegen den Plan, passe an
Projektstruktur
project-name/
plan.md # Narrativer Bogen, Szenenaufteilung
script.py # Alle Szenen in einer Datei
concat.txt # ffmpeg Szenenliste
final.mp4 # Zusammengefügte Ausgabe
media/ # Automatisch von Manim generiert
videos/script/480p15/
Kreative Richtlinien
Farbpaletten
| Palette | Hintergrund | Primär | Sekundär | Akzent | Anwendungsfall |
|---|---|---|---|---|---|
| Klassisch 3B1B | #1C1C1C | #58C4DD (BLAU) | #83C167 (GRÜN) | #FFFF00 (GELB) | Allgemein Mathe/Informatik |
| 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() danach |
|---|---|---|
| Titel/Einführung erscheint | 1,5s | 1,0s |
| Schlüsselgleichung enthüllt | 2,0s | 2,0s |
| Transformation/Morph | 1,5s | 1,5s |
| Unterstützendes Label | 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 | Erläuternder Text |
| Label | 24 | Annotationen, Achsenbeschriftungen |
| Untertitel | 20 | Untertitel, Kleingedrucktes |
Schriftarten
Verwende Monospace-Schriftarten für allen Text. Manims Pango-Renderer erzeugt defekte Unterschneidung (Kerning) mit proportionalen Schriftarten bei allen Größen. Siehe references/visual-design.md für vollständige Empfehlungen.
MONO = "Menlo" # einmal 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) # Labels
MathTex(r"\nabla L") # Mathe (verwendet LaTeX)
Mindest font_size=18 für Lesbarkeit.
Szenenspezifische 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 Scene1_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 am Dateianfang für szenenübergreifende Konsistenz
self.camera.background_colorin jeder Szene gesetzt- Saubere Ausgänge – FadeOut aller Mobs am Szenenende:
self.play(FadeOut(Group(*self.mobjects)))
Schritt 3: Rendern
manim -ql script.py Scene1_Einfuehrung Scene2_Kernkonzept # Entwurf
manim -qh script.py Scene1_Einfuehrung Scene2_Kernkonzept # Produktion
Schritt 4: Zusammenfügen
cat > concat.txt << 'EOF'
datei 'media/videos/script/480p15/Scene1_Einfuehrung.mp4'
datei 'media/videos/script/480p15/Scene2_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 Scene2_Kernkonzept # Vorschaustill
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(notiz1, notiz2)) # nicht Write(notiz2) darüber
Niemals Nicht-hinzugefügte Mobs 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 mit -ql iterieren. Nur -qh für die endgültige Ausgabe rendern.
Referenzen
| Datei | Inhalt |
|---|---|
references/animations.md | Kernanimationen, Geschwindigkeitsfunktionen, Komposition, .animate-Syntax, Timing-Muster |
references/mobjects.md | Text, Formen, VGroup/Group, Positionierung, Styling, benutzerdefinierte Mobs |
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, Plotten, BarChart, animierte Daten, Algorithmusvisualisierung |
references/camera-and-3d.md | MovingCameraScene, ThreeDScene, 3D-Oberflächen, Kamerasteuerung |
references/scene-planning.md | Narrative Bögen, Layout-Vorlagen, 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 umwandeln – Workflow, Vorlagen, Domänenmuster |
references/decorations.md | SurroundingRectangle, Brace, Pfeile, DashedLine, Angle, Annotationslebenszyklus |
references/production-quality.md | Checklisten vor Code, vor Render, nach Render, räumliches Layout, Farbe, Tempo |
Kreative Divergenz (nur verwenden, wenn der Benutzer experimentelle/kreative/einzigartige Ausgabe anfordert)
Wenn der Benutzer nach kreativen, experimentellen oder unkonventionellen Erklärungsansätzen fragt, wähle eine Strategie und denke sie DURCH, bevor du die Animation entwirfst.
- SCAMPER – wenn der Benutzer eine neue Perspektive auf eine Standarderklärung möchte
- Annahme-Umkehrung – wenn der Benutzer herausfordern möchte, wie etwas normalerweise vermittelt wird
SCAMPER-Transformation
Nimm eine standardmäßige mathematische/technische Visualisierung und transformiere sie:
- Substitute: Ersetze die standardmäßige visuelle Metapher (Zahlenstrahl → gewundener Pfad, Matrix → Stadtplan)
- Combine: Kombiniere zwei Erklärungsansätze (algebraisch + geometrisch gleichzeitig)
- Reverse: Leite rückwärts ab – starte vom Ergebnis und dekonstruiere zu 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
Annahme-Umkehrung
- 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-Ableitung, 3D-Einbettung eines 2D-Konzepts, kontinuierliches Verformen statt Schritte, null Notation)
- Erkunde, was die Umkehrung offenbart, was der Standardansatz verbirgt