Que fait manim ?
Installé ici : Manim Community v0.22.1 (manim dans le PATH, installé via uv tool avec l'extension typst), ainsi que TeX Live et dvisvgm pour Tex/MathTex, et Chatterbox Turbo pour la narration (installation CPU dans son propre venv sous ~/.local/opt/chatterbox, piloté par narration.py). Les fichiers de scènes s'exécutent sur le propre Python de l'outil, qui inclut numpy, scipy et networkx ; les autres imports échouent. Utilisez uniquement l'API ManimCE. manimgl de 3Blue1Brown est une bibliothèque différente, donc le code qui lui est destiné ne fonctionnera pas ici.
Style
Manim est un outil pour présenter des informations de manière dynamique et intéressante. Si ce que vous avez créé aurait tout aussi bien pu être un organigramme, un tableur, un graphe en points ou un diaporama, vous n'utilisez pas correctement manim. Le beau est plus engageant et plus mémorisable. Évitez le jargon technique, gardez votre présentation accessible. Choisissez un ensemble de motifs et tenez-vous-y – un concept doit avoir une représentation visuelle cohérente. Racontez une histoire, commencez in medias res. Introduisez les idées et les problèmes à partir des premiers principes.
Étapes
-
Choisissez le format de sortie. Utilisez un PNG fixe pour une image statique (diagramme légendé, tracé, tableau ou formule). Utilisez un MP4 pour montrer un changement ou une séquence (dérivation pas à pas, point en mouvement, transformation). Utilisez un GIF uniquement lorsque le support de destination ne peut pas lire de vidéo.
-
Trouvez les exemples les plus proches. Ouvrez le ou les fichiers thématiques ci-dessous, parcourez l'index en haut et lisez les 1 à 3 exemples les plus proches de ce dont vous avez besoin. Construisez votre scène en les adaptant : leur utilisation de l'API est connue pour fonctionner sur cette version.
-
Écrivez la scène dans
/tmp/manim/<slug>/scene.pysauf si l'utilisateur a spécifié un emplacement. Commencez parfrom manim import *et définissez une sous-classe deScene(MovingCameraScene/ThreeDScene/ZoomedScenelorsque les exemples en utilisent une).Chaque image représentant une chose (un nuage, un serveur, un cadenas, un drapeau, une personne, un document) est une icône de la bibliothèque de ce skill, utilisée telle quelle : copiez icons.py à côté de la scène, trouvez un identifiant avec
grep -iw <mot> assets/index.tsvdans le répertoire de ce skill (essayez un synonyme si un mot ne trouve rien), et chargez-la avecicon(id, color=..., height=...).tabler/outline/*ettabler/filled/*sont des icônes linéaires et pleines monochromes (Tabler Icons) dessinées dans lacolor;fluent/*sont des emoji en couleur (Fluent Emoji, style Flat) qui conservent leurs propres couleurs. Dessinez vous-même uniquement la structure du diagramme avec les formes de Manim : boîtes, flèches, lignes, axes, tracés et étiquettes. Donnez à chaque concept une icône et réutilisez-la, comme l'un des motifs.Un MP4 ou un GIF qui montre du texte doit donner aux spectateurs du temps de lecture, et un vérificateur l'impose. Copiez reading_time.py à côté de la scène, importez-le avec
from reading_time import ReadingTime, et placez le mixin avant la classe de base de la scène :class NomDeLaScène(ReadingTime, Scene). Appelezself.wait_to_read()avant chaqueplayqui cache, remplace ou atténue du texte. Il attend que chaque texte visible soit resté à l'écran pendant 1 s plus le nombre de mots à 150 mots/min, tous les textes révélés par un seulplayétant lus ensemble. Montrez les nouveaux mots en tant que nouveaux mobjects (FadeIn,ReplacementTransform) plutôt qu'avecbecome(), afin que leur temps de lecture reparte de zéro. L'animation peut continuer pendant l'attente : placezself.wait_to_read()après une animation qui se joue pendant que le texte est affiché.Un MP4 qui explique avec des légendes est également narré : une voix le lit. Copiez narration.py à côté de la scène et placez-le avant
ReadingTime:class NomDeLaScène(Narration, ReadingTime, Scene).self.speak(texte)attend que la ligne précédente se termine, puis commence la suivante, et les animations qui suivent se jouent pendant qu'elle est prononcée. Placez-le juste avant leplayqui montre la légende qu'il lit. La légende affiche la ligne parlée mot pour mot, et chaque ligne parlée en a une : écrivez chaque ligne une fois et passez cette même chaîne àspeaket auTextde la légende. Lorsque la voix a besoin d'une réécriture que l'écran n'affiche pas ("vingt" pour "20"), placez-la dans le dictionnairepronouncede la scène, qui modifie uniquement ce qui est prononcé. Dans une scène narrée, la voix définit l'attente au lieu du nombre de mots : le texte qui apparaît pendant qu'une ligne est prononcée doit rester jusqu'à ce que le narrateur ait fini plus une pause de 0,5 s, etself.wait_to_read()attend exactement cette durée avant le changement suivant (le texte affiché en silence conserve la règle du nombre de mots). La voix est un clone neuronal d'un narrateur masculin calme (Chatterbox Turbo), réglé pour parcourir des diagrammes techniques. Chaque nouvelle ligne prend environ 1 à 3 fois sa longueur parlée à synthétiser (y compris les brouillons d'images fixes) et est mise en cache dansmedia/voice, donc les rendus ultérieurs ne vocalisent que les lignes modifiées. Écrivez chaque ligne pour être entendue, pas lue. Les acronymes comme API, TLS et HTTP se lisent bien tels quels, etnarration.pyépelle déjà les unités après les nombres (200 ms), les versions pointées (2.4.1) etk8s. Dites les autres chaînes machine comme le ferait un narrateur, toujours viapronounce: "dix-sept onze", pas "2026.11.1711". Décrivez les chemins et noms de branches plutôt que de les lire textuellement ("une branche de correction automatique de patchs"), et corrigez tout mot que la voix prononce mal via le dictionnairepronouncede la scène ({"edgeworker": "edge worker"}).Chaque MP4 ou GIF se termine par une carte de crédit indiquant le modèle qui l'a créé. Copiez produced_by.py à côté de la scène, placez le mixin en premier :
class NomDeLaScène(ProducedBy, Narration, ReadingTime, Scene)(ouclass NomDeLaScène(ProducedBy, Scene)pour une scène sans texte), et définissezproduced_byavec le nom de votre propre modèle tel que donné par votre prompt système (produced_by = "Claude Opus 5.5"). Si vos instructions ne donnent pas le nom de votre modèle, demandez à l'utilisateur. Une fois la scène, sa narration et sa vérification du temps de lecture terminées, le mixin fond la scène et maintient la carte pendant les 0,5 dernières secondes. Les rendus statiques l'omettent. -
Brouillon et inspection. Effectuez un rendu basse qualité d'une image fixe et lisez le PNG :
cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py NomDeLaScène # -> media/images/scene/draft.pngPour une animation, vérifiez aussi les moments clés :
-s -n 0,Ks'arrête après l'animationK(à partir de 0 ; chaqueself.playet chaqueself.waitcompte pour un) et enregistre cette image. L'image fait environ 14,2 × 8 unités, centrée sur l'origine. Corrigez et refaites le rendu jusqu'à ce que chaque image vérifiée montre tous les éléments dans le cadre, sans étiquettes qui se chevauchent, et un texte lisible.Une scène qui retire le texte trop tôt échoue avec une
ReadingTimeError, qui liste chaque texte, son apparition et sa durée d'affichage par rapport à la durée requise. Ajoutezself.wait_to_read()avant chaque changement listé. Pour inspecter les images du brouillon avant que la synchronisation ne soit corrigée, préfixez la commande parMANIM_READING_TIME=warn. Le rendu final s'effectue sans cela et doit réussir. -
Rendu final. Utilisez
-qm(720p30). Les scènes 3D sont lentes sur le rendu Cairo, donc faites-en un brouillon en-ql.manim render -qh --media_dir media -o final scene.py NomDeLaScène # -> media/videos/scene/1080p60/final.mp4 (ajoutez --format gif pour un GIF ; -s pour un PNG dans media/images/scene/final.png) -
Livraison. Affichez la sortie en ligne lorsque votre interface peut l'afficher, c'est-à-dire lorsque vos instructions disent que la syntaxe Markdown d'image incorpore des images ou des vidéos (comme le fait T3 Code). Copiez le fichier de sortie dans le répertoire de travail de la session, puis intégrez-le à partir de là avec son chemin absolu (
; cela fonctionne à la fois pour MP4 et PNG). T3 Code rend les médias en ligne uniquement depuis le répertoire de travail, donc une intégration pointant vers/tmpapparaît comme un lien simple. Dans une interface qui n'affiche que du texte, comme un terminal simple, donnez plutôt le chemin absolu du fichier de sortie. Dans les deux cas, donnez aussi le chemin du fichier de scène pour que l'utilisateur puisse le modifier.Chaque itération se termine par une livraison. Chaque fois que vous modifiez une scène, que ce soit suite aux retours de l'utilisateur ou pour vos propres corrections, terminez le tour en refaisant le rendu de chaque vidéo de l'ensemble en qualité finale (même celles que vous n'avez pas touchées), et livrez chacune d'elles comme à l'étape 6. Les images fixes et les captures d'écran vous aident à vérifier votre travail, mais ne remplacent pas les vidéos. Donnez à chaque tour ses propres noms de fichiers (
<nom>-v2.mp4,<nom>-v3.mp4), afin que les messages précédents continuent d'afficher les versions qu'ils décrivaient.
Fichiers thématiques
Chacun contient des exemples testés par rendu, textuellement issus de la documentation v0.22.1 sauf mention contraire, avec un index en haut.
- references/basics.md : positionnement, style, regroupement/disposition,
.animate,Transform, animations personnalisées. - references/text-and-math.md :
Text/MarkupText,Tex/MathTex, mathématiques Typst, coloration de parties de formules, réarrangement d'équations, listes à puces, titres, blocs de code, accolades, nombres en direct. - references/plots-and-axes.md : tracés
Axes, aires et sommes de Riemann, dérivées/sécantes, courbes implicites/paramétriques/polaires, axes logarithmiques, graphiques linéaires de données, droites et plans numériques, plan complexe, diagrammes à barres. - references/diagrams-and-geometry.md : flèches, droites/points/formes étiquetées, angles, angles droits, mise en évidence (boîte englobante, soulignement, croix), formes Venn/algèbre de Boole, polygones, contours en pointillés.
- references/code.md : code avec coloration syntaxique : saisie au clavier, mise en évidence de lignes, extraction d'un jeton, transformation d'une version en la suivante.
- references/graphs-tables-matrices.md :
Graph/DiGraphnœuds-liens, arbres, couches de réseaux de neurones, import networkx, changements de disposition, tableaux, matrices, déterminants, transformations linéaires du plan. - references/animation-and-motion.md : updaters,
ValueTracker,always_redraw, chemins tracés, variantes de transformation,MoveToTarget/Restore, synchronisationSuccession/LaggedStart, accentuation (Indicate,Circumscribe,Flash), entrées par croissance/fondu, fonctions de taux. - references/camera-3d-fields.md : caméra mobile/zoom, incrustation zoomée, contrôle de caméra
ThreeDScene, surfaces et courbes 3D, champs vectoriels et lignes de courant. - references/complete-scenes.md : deux scènes plus longues montrant comment rythmer une explication en plusieurs étapes.
Consultation de l'API
La source installée, avec les docstrings complètes, se trouve dans ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/. Utilisez grep pour trouver la signature et les options d'une classe ou d'une méthode avant de deviner un argument nommé.
Pièges
- Écrivez les chaînes LaTeX comme des chaînes brutes (
r"\frac{a}{b}"). Une erreur LaTeX imprime le journal.tex, et la ligne problématique se trouve généralement vers la fin. xelatexn'est pas installé, donc les modèlesTexTemplateLibraryqui en ont besoin (par ex.ctex) échouent. Pour le texte CJK, utilisezText/MarkupText, qui s'affichent via Pango avec les polices système (fc-listles affiche).Typst/MathTypstsont une alternative plus rapide àTex/MathTexet ne nécessitent pas LaTeX.- Chargez les icônes avec
icon(), qui recolore les icônes Tabler : leurs fichiers sont dessinés aveccurrentColor, qu'un simpleSVGMobjectlit comme noir. - Les icônes Fluent dessinées en noir (
fluent/black-flag,fluent/black-cat) disparaissent sur fond noir ; choisissez une autre icône ou placez-la sur une forme claire. - Les icônes linéaires Tabler perdent les points dessinés comme des lignes de longueur nulle, par exemple les lumières sur
tabler/outline/server.