Was macht manim?
Installiert hier: Manim Community v0.22.1 (manim im PATH, eine uv tool-Installation mit dem typst-Extra), plus TeX Live und dvisvgm für Tex/MathTex, sowie Chatterbox Turbo für Erzählungen (eine CPU-Installation im eigenen venv unter ~/.local/opt/chatterbox, gesteuert durch narration.py). Szenendateien werden mit dem eigenen Python des Tools ausgeführt, das numpy, scipy und networkx enthält; andere Imports schlagen fehl. Verwenden Sie ausschließlich die ManimCE-API. manimgl von 3Blue1Brown ist eine andere Bibliothek, daher läuft dafür geschriebener Code hier nicht.
Stil
Manim ist ein Werkzeug, um Informationen dynamisch und interessant zu präsentieren. Wenn das, was Sie erstellt haben, genauso gut ein Flussdiagramm, eine Tabelle, ein Kreisdiagramm oder eine Diashow sein könnte, setzen Sie Manim nicht richtig ein. Schönheit ist fesselnder und bleibt besser im Gedächtnis. Vermeiden Sie Fachjargon und halten Sie Ihre Präsentation zugänglich. Wählen Sie ein Set von Motiven und bleiben Sie dabei – ein Konzept sollte eine konsistente visuelle Darstellung haben. Erzählen Sie eine Geschichte, beginnen Sie in medias res. Führen Sie Ideen und Probleme aus ersten Prinzipien ein.
Schritte
-
Wählen Sie die Ausgabe. Verwenden Sie ein stehendes PNG für ein statisches Bild (ein beschriftetes Diagramm, einen Graphen, eine Tabelle oder eine Formel). Verwenden Sie ein MP4, wenn es um Veränderung oder Abfolge geht (eine schrittweise Herleitung, ein sich bewegender Punkt, eine Transformation). Verwenden Sie GIF nur, wenn das Zielmedium kein Video abspielen kann.
-
Finden Sie die nächsten Beispiele. Öffnen Sie die Thema-Datei(en) unten, überfliegen Sie den Index am Anfang und lesen Sie die 1–3 Beispiele, die Ihren Anforderungen am nächsten kommen. Erstellen Sie Ihre Szene durch Anpassung dieser Beispiele: Deren API-Nutzung ist für diese Version getestet.
-
Schreiben Sie die Szene nach
/tmp/manim/<slug>/scene.py, es sei denn, der Benutzer hat einen anderen Speicherort angegeben. Beginnen Sie mitfrom manim import *und definieren Sie eine Unterklasse vonScene(MovingCameraScene/ThreeDScene/ZoomedScene, wenn die Beispiele eine solche verwenden).Jedes Bild eines Gegenstands (einer Wolke, eines Servers, eines Vorhängeschlosses, einer Flagge, einer Person, eines Dokuments) ist ein Icon aus der Bibliothek dieses Skills und wird unverändert verwendet: Kopieren Sie icons.py neben die Szene, finden Sie eine ID mit
grep -iw <Wort> assets/index.tsvim Verzeichnis dieses Skills (versuchen Sie ein Synonym, wenn ein Wort nichts findet), und laden Sie es miticon(id, color=..., height=...).tabler/outline/*undtabler/filled/*sind einfarbige Linien- und Vollzeichen-Icons (Tabler Icons), gezeichnet incolor;fluent/*sind mehrfarbige Emojis (Fluent Emoji, Flat-Stil), die ihre eigenen Farben behalten. Zeichnen Sie nur die Struktur des Diagramms selbst mit Manims Formen: Rechtecke, Pfeile, Linien, Achsen, Graphen und Beschriftungen. Geben Sie jedem Konzept ein Icon und verwenden Sie es wieder, als eines der Motive.Ein MP4 oder GIF, das Text zeigt, muss den Betrachtern Lesezeit geben; ein Prüfmechanismus setzt dies durch. Kopieren Sie reading_time.py neben die Szene, importieren Sie es mit
from reading_time import ReadingTimeund setzen Sie die Mixin-Klasse vor die Szenen-Basisklasse:class SzenenName(ReadingTime, Szene). Rufen Sieself.wait_to_read()vor jedemplayauf, das Text ausblendet, ersetzt oder abdunkelt. Es hält an, bis jeder sichtbare Text 1 s plus seine Wörter bei 150 Wörtern pro Minute auf dem Bildschirm war, wobei alle durch einplaygleichzeitig gezeigten Texte gemeinsam gelesen werden. Zeigen Sie neue Wörter als neues Mobjekt (FadeIn,ReplacementTransform) anstatt mitbecome(), damit die Zeit neu startet. Bewegung kann während des Haltens weiterlaufen: Setzen Sieself.wait_to_read()nach einer Animation, die abläuft, während der Text sichtbar ist.Ein MP4, das in Untertiteln erklärt, wird auch vorgelesen: Eine Stimme spricht den Text. Kopieren Sie narration.py neben die Szene und setzen Sie es vor
ReadingTime:class SzenenName(Narration, ReadingTime, Szene).self.speak(text)wartet, bis die vorherige Zeile beendet ist, startet dann die nächste, und die folgenden Animationen laufen, während sie gesprochen wird. Setzen Sie es direkt vor dasplay, das den Untertitel zeigt, den es vorliest. Der Untertitel zeigt die gesprochene Zeile wortwörtlich, und jede gesprochene Zeile hat einen: Schreiben Sie jede Zeile einmal und übergeben Sie denselben String anspeakund an denTextdes Untertitels. Wenn die Stimme eine Umschreibung benötigt, die der Bildschirm nicht anzeigt („zwanzig" für „20"), setzen Sie sie in daspronounce-Wörterbuch der Szene, das nur die Aussprache ändert. In einer erzählten Szene ersetzt die Stimme die Wörterzahlregel: Text, der während einer gesprochenen Zeile erscheint, muss mindestens bis zum Ende des Sprechers plus einer Pause von 0,5 s sichtbar bleiben;self.wait_to_read()hält genau so lange vor der nächsten Änderung (während der Stille angezeigter Text behält die Wörterzahlregel). Die Stimme ist ein neuronales Klon eines ruhigen männlichen Erzählers (Chatterbox Turbo), optimiert für die Erklärung technischer Diagramme. Jede neue Zeile benötigt etwa das 1- bis 3-Fache ihrer gesprochenen Länge zur Synthese, inklusive Entwurfsstandbilder, und wird untermedia/voicezwischengespeichert, sodass spätere Renderings nur die geänderten Zeilen vertonen. Schreiben Sie jede Zeile zum Hören, nicht zum Lesen. Akronyme wie API, TLS und HTTP werden gut vorgelesen, undnarration.pybuchstabiert bereits Einheiten nach Zahlen (200 ms), gepunktete Versionen (2.4.1) undk8s. Sagen Sie andere Maschinenstrings so, wie ein Erzähler es tun würde, wiederum überpronounce: „siebzehn elf", nicht „2026.11.1711". Beschreiben Sie Pfade und Branchnamen, anstatt sie vorzulesen („ein Auto-Patches-Release-Branch"), und korrigieren Sie jedes Wort, das die Stimme falsch ausspricht, durch daspronounce-Wörterbuch der Szene ({"edgeworker": "edge worker"}).Jedes MP4 oder GIF endet mit einer Credits-Karte, die das Modell nennt, das es erstellt hat. Kopieren Sie produced_by.py neben die Szene, setzen Sie die Mixin als erstes:
class SzenenName(ProducedBy, Narration, ReadingTime, Szene)(oderclass SzenenName(ProducedBy, Szene)für eine Szene ohne Text), und setzen Sieproduced_byauf Ihren eigenen Modellnamen, wie er in Ihrem System-Prompt angegeben ist (produced_by = "Claude Opus 5.5"). Wenn Ihre Anweisungen Ihren Modellnamen nicht nennen, fragen Sie den Benutzer. Nachdem die Szene, ihre Erzählung und der Lesedauer-Check beendet sind, blendet die Mixin die Szene aus und hält die Karte für die letzten 0,5 s an. Standbilder überspringen dies. -
Entwurf und Kontrolle. Rendern Sie ein Standbild in niedriger Qualität und lesen Sie das PNG:
cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py SzenenName # -> media/images/scene/draft.pngFür eine Animation überprüfen Sie auch wichtige Momente:
-s -n 0,Kstoppt nach AnimationK(0-basiert; jederself.playund jederself.waitzählt als einer) und speichert diesen Frame. Der Frame ist etwa 14,2 × 8 Einheiten, zentriert auf dem Ursprung. Korrigieren und rendern Sie erneut, bis jeder von Ihnen überprüfte Frame alle Elemente im Frame zeigt, keine überlappenden Beschriftungen und lesbaren Text enthält.Eine Szene, die Text zu früh entfernt, schlägt mit
ReadingTimeErrorfehl, der jeden Text, seinen Erscheinungszeitpunkt und die angezeigte Dauer im Verhältnis zur erforderlichen Dauer auflistet. Fügen Sieself.wait_to_read()vor jeder aufgeführten Änderung ein. Um Entwurfsframes vor der Korrektur der Zeitsteuerung zu betrachten, setzen SieMANIM_READING_TIME=warnvor den Befehl. Der endgültige Render läuft ohne dies und muss bestehen. -
Endgültiger Render. Verwenden Sie
-qm(720p30). 3D-Szenen sind mit dem Cairo-Renderer langsam; entwerfen Sie sie mit-ql.manim render -qh --media_dir media -o final scene.py SzenenName # -> media/videos/scene/1080p60/final.mp4 (fügen Sie --format gif für ein GIF hinzu; -s für ein PNG unter media/images/scene/final.png) -
Ausliefern. Zeigen Sie die Ausgabe inline an, wenn Ihr Interface dies unterstützt, also wenn Ihre Anweisungen besagen, dass Markdown-Bildsyntax Bilder oder Videos einbettet (T3 Code tut das). Kopieren Sie die Ausgabedatei in das Arbeitsverzeichnis der Sitzung und betten Sie sie von dort mit ihrem absoluten Pfad ein (
; dies funktioniert für MP4 und PNG gleichermaßen). T3 Code rendert Medien nur inline aus dem Arbeitsverzeichnis; ein Embed, das nach/tmpzeigt, erscheint als einfacher Link. In einem Interface, das nur Text anzeigt, wie einem einfachen Terminal, geben Sie stattdessen den absoluten Pfad der Ausgabedatei an. Geben Sie in jedem Fall auch den Pfad der Szenendatei an, damit der Benutzer sie anpassen kann.Jede Iteration endet mit einer Auslieferung. Wann immer Sie eine Szene ändern, sei es aufgrund des Feedbacks des Benutzers oder Ihrer eigenen Korrekturen, beenden Sie den Durchgang, indem Sie jedes Video im Satz in endgültiger Qualität neu rendern, auch diejenigen, die Sie nicht berührt haben, und liefern jedes aus wie in Schritt 6. Standbilder und Frame-Aufnahmen helfen Ihnen, Ihre Arbeit zu überprüfen, ersetzen aber nicht die Videos. Geben Sie jeder Runde eigene Dateinamen (
<Name>-v2.mp4,<Name>-v3.mp4), damit frühere Nachrichten weiterhin die von ihnen beschriebenen Versionen anzeigen.
Themendateien
Jede enthält rendergetestete Beispiele, wörtlich aus der Dokumentation von v0.22.1, sofern die Datei nichts anderes angibt, mit einem Index am Anfang.
- references/basics.md: Positionierung, Styling, Gruppieren/Anordnen,
.animate,Transform, benutzerdefinierte Animationen. - references/text-and-math.md:
Text/MarkupText,Tex/MathTex, Typst-Mathe, Einfärben von Teilen von Formeln, Gleichungsumstellungen, Aufzählungspunkte, Titel, Codeblöcke, Klammern, Live-Zahlen. - references/plots-and-axes.md:
Axes-Graphen, Flächen und Riemann-Summen, Ableitungen/Sekanten, implizite/parametrische/polare Kurven, logarithmische Achsen, Datenliniendiagramme, Zahlenstrahlen und -ebenen, komplexe Ebene, Balkendiagramme. - references/diagrams-and-geometry.md: Pfeile, beschriftete Linien/Punkte/Formen, Winkel, rechte Winkel, Hervorhebungen (umgebende Box, Unterstreichung, Kreuz), Venn-/Boolesche Formen, Polygone, gestrichelte Umrandungen.
- references/code.md: Syntax-hervorgehobener Code: Eintippen, Hervorheben von Zeilen, Auswählen eines Tokens, Umwandeln einer Version in die nächste.
- references/graphs-tables-matrices.md: Knoten-Kanten-
Graph/DiGraph, Bäume, Neuronale-Netz-Schichten, networkx-Import, Layout-Änderungen, Tabellen, Matrizen, Determinanten, lineare Transformationen der Ebene. - references/animation-and-motion.md: Updater,
ValueTracker,always_redraw, verfolgte Pfade, Transformationsvarianten,MoveToTarget/Restore,Succession/LaggedStart-Timing, Betonung (Indicate,Circumscribe,Flash), Wachsen/Verblassen-Eingänge, Rate-Funktionen. - references/camera-3d-fields.md: Bewegte/zoomende Kamera, gezoomtes Inset,
ThreeDScene-Kamerasteuerung, 3D-Oberflächen und -Kurven, Vektorfelder und Stromlinien. - references/complete-scenes.md: Zwei längere Szenen, die zeigen, wie eine mehrschrittige Erklärung getaktet wird.
API-Nachschlagen
Der installierte Quellcode mit vollständigen Docstrings befindet sich unter ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/. Durchsuchen Sie ihn mit grep nach der Signatur und den Optionen einer Klasse oder Methode, bevor Sie ein Schlüsselwortargument erraten.
Fallstricke
- Schreiben Sie LaTeX-Strings als rohe Strings (
r"\frac{a}{b}"). Ein LaTeX-Fehler gibt das.tex-Log aus; die problematische Zeile steht meist am Ende. xelatexist nicht installiert, daher schlagen Vorlagen ausTexTemplateLibrary, die es benötigen (z.B.ctex), fehl. Verwenden Sie für CJK-TextText/MarkupText, die durch Pango mit Systemschriftarten rendern (fc-listzeigt sie an).Typst/MathTypstsind eine schnellere Alternative zuTex/MathTexund benötigen kein LaTeX.- Laden Sie Icons mit
icon(). Diese färbt Tabler-Icons um: Ihre Dateien zeichnen incurrentColor, was ein einfachesSVGMobjectals Schwarz liest. - Fluent-Icons, die in Schwarz gezeichnet sind (
fluent/black-flag,fluent/black-cat), verschwinden auf schwarzem Hintergrund; wählen Sie ein anderes Icon oder setzen Sie es auf eine helle Form. - Tabler-Linien-Icons verlieren Punkte, die als Linien der Länge Null gezeichnet sind, wie die Lichter auf
tabler/outline/server.