Communitygithub.com

MoreiraTv/vibe-video

Pipeline de production vidéo pour animations mathématiques et techniques avec Manim Community Edition. Crée des vidéos explicatives de type 3Blue1Brown, visualisations d'algorithmes, dérivations d'équations, diagrammes d'architecture et histoires de données.

Qu'est-ce que vibe-video ?

Ce skill transforme des prompts utilisateur en vidéos animées pédagogiques de haute qualité, en s'appuyant sur Manim Community Edition. Il suit un pipeline rigoureux en six étapes : Planification (rédaction d'un plan narratif), Code (écriture d'un script Python unique), Rendu (utilisation de manim en basse ou haute qualité), Assemblage (concaténation des scènes avec ffmpeg), Audio (ajout optionnel de voix off) et Révision. Le skill impose un standard créatif exigeant : chaque image doit enseigner, la géométrie prime sur l'algèbre, et l'excellence du premier rendu est non négociable. Il fournit des palettes de couleurs prédéfinies (classique 3B1B, académique chaleureux, néon tech, monochrome), des vitesses d'animation recommandées, une échelle typographique cohérente, et des directives détaillées pour l'utilisation des polices (monospace obligatoire). Plusieurs modes sont disponibles : explicatif de concept, dérivation d'équation, visualisation d'algorithme, histoire de données, diagramme d'architecture, explicatif d'article et visualisation 3D. Le skill inclut également des mécanismes de divergence créative (SCAMPER, renversement d'hypothèses) pour les demandes expérimentales. Il fonctionne sur toute plateforme supportant Python 3.10+, Manim CE v0.20+, LaTeX et ffmpeg.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MoreiraTv/vibe-video/tree/HEAD/skills/manim-video

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Pipeline de Production Vidéo Manim

Standard Créatif

C'est du cinéma éducatif. Chaque image enseigne. Chaque animation révèle une structure.

Avant d'écrire une seule ligne de code, articulez l'arc narratif. Quelle idée fausse cette vidéo corrige-t-elle ? Quel est le « déclic » ? Quelle histoire visuelle emmène le spectateur de la confusion à la compréhension ? Le prompt de l'utilisateur est un point de départ — interprétez-le avec ambition pédagogique.

La géométrie avant l'algèbre. Montrez d'abord la forme, l'équation ensuite. La mémoire visuelle encode plus vite que la mémoire symbolique. Quand le spectateur voit le motif géométrique avant la formule, l'équation semble méritée.

L'excellence du premier rendu est non négociable. La sortie doit être visuellement claire et esthétiquement cohérente sans cycles de révision. Si quelque chose semble encombré, mal chronométré ou ressemble à des « diapositives générées par IA », c'est faux.

La superposition d'opacité dirige l'attention. Ne montrez jamais tout à pleine luminosité. Éléments principaux à 1.0, éléments contextuels à 0.4, éléments structurels (axes, grilles) à 0.15. Le cerveau traite la saillance visuelle par couches.

Des pauses. Chaque animation a besoin d'un self.wait() après elle. Le spectateur a besoin de temps pour absorber ce qui vient d'apparaître. Ne vous précipitez jamais d'une animation à l'autre. Une pause de 2 secondes après une révélation clé n'est jamais perdue.

Langage visuel cohérent. Toutes les scènes partagent une palette de couleurs, une taille de typographie cohérente, des vitesses d'animation assorties. Une vidéo techniquement correcte où chaque scène utilise des couleurs aléatoires différentes est un échec esthétique.

Prérequis

Exécutez scripts/setup.sh pour vérifier toutes les dépendances. Nécessite : Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (texlive-full sur Linux, mactex sur macOS), et ffmpeg. Documentation de référence testée avec Manim CE v0.20.1.

Modes

ModeEntréeSortieRéférence
Explicatif de conceptSujet/conceptExplication animée avec intuition géométriquereferences/scene-planning.md
Dérivation d'équationExpressions mathématiquesPreuve animée étape par étapereferences/equations.md
Visualisation d'algorithmeDescription d'algorithmeExécution étape par étape avec structures de donnéesreferences/graphs-and-data.md
Histoire de donnéesDonnées/métriquesGraphiques animés, comparaisons, compteursreferences/graphs-and-data.md
Diagramme d'architectureDescription du systèmeComposants se construisant avec connexionsreferences/mobjects.md
Explicatif d'articleArticle de rechercheRésultats et méthodes clés animésreferences/scene-planning.md
Visualisation 3DConcept 3DSurfaces tournantes, courbes paramétriques, géométrie spatialereferences/camera-and-3d.md

Stack

Un seul script Python par projet. Pas de navigateur, pas de Node.js, pas de GPU nécessaire.

CoucheOutilObjectif
CœurManim Community EditionRendu de scène, moteur d'animation
MathématiquesLaTeX (texlive/MiKTeX)Rendu d'équations via MathTex
Vidéo I/OffmpegAssemblage de scènes, conversion de format, multiplexage audio
TTSElevenLabs / Qwen3-TTS (optionnel)Voix off de narration

Pipeline

PLAN --> CODE --> RENDU --> ASSEMBLAGE --> AUDIO (optionnel) --> RÉVISION
  1. PLAN — Écrivez plan.md avec l'arc narratif, la liste des scènes, les éléments visuels, la palette de couleurs, le script de voix off
  2. CODE — Écrivez script.py avec une classe par scène, chacune rendable indépendamment
  3. RENDU — manim -ql script.py Scene1 Scene2 ... pour le brouillon, -qh pour la production
  4. ASSEMBLAGE — Concaténation ffmpeg des clips de scènes en final.mp4
  5. AUDIO (optionnel) — Ajoutez une voix off et/ou une musique de fond via ffmpeg. Voir references/rendering.md
  6. RÉVISION — Rendu d'images d'aperçu, vérification par rapport au plan, ajustements

Structure du Projet

nom-projet/
  plan.md                # Arc narratif, décomposition des scènes
  script.py              # Toutes les scènes dans un seul fichier
  concat.txt             # Liste des scènes ffmpeg
  final.mp4              # Sortie assemblée
  media/                 # Généré automatiquement par Manim
    videos/script/480p15/

Direction Créative

Palettes de Couleurs

PaletteArrière-planPrimaireSecondaireAccentCas d'usage
Classique 3B1B#1C1C1C#58C4DD (BLEU)#83C167 (VERT)#FFFF00 (JAUNE)Maths/CS général
Académique chaleureux#2D2B55#FF6B6B#FFD93D#6BCB77Accessible
Néon tech#0A0A0A#00F5FF#FF00FF#39FF14Systèmes, architecture
Monochrome#1A1A2E#EAEAEA#888888#FFFFFFMinimaliste

Vitesse d'Animation

Contexterun_timeself.wait() après
Apparition du titre/intro1.5s1.0s
Révélation d'une équation clé2.0s2.0s
Transformation/morphing1.5s1.5s
Étiquette de soutien0.8s0.5s
Nettoyage FadeOut0.5s0.3s
Révélation « Déclic »2.5s3.0s

Échelle Typographique

RôleTaille de policeUsage
Titre48Titres de scène, texte d'ouverture
En-tête36En-têtes de section dans une scène
Corps30Texte explicatif
Étiquette24Annotations, étiquettes d'axes
Légende20Sous-titres, petits caractères

Polices

Utilisez des polices à chasse fixe (monospace) pour tout le texte. Le moteur de rendu Pango de Manim produit un crénage défectueux avec les polices proportionnelles à toutes les tailles. Voir references/visual-design.md pour les recommandations complètes.

MONO = "Menlo"  # définir une fois en haut du fichier

Text("Série de Fourier", font_size=48, font=MONO, weight=BOLD)  # titres
Text("n=1 : sin(x)", font_size=20, font=MONO)                   # étiquettes
MathTex(r"\nabla L")                                              # mathématiques (utilise LaTeX)

Taille de police minimale font_size=18 pour la lisibilité.

Variation Par Scène

N'utilisez jamais une configuration identique pour toutes les scènes. Pour chaque scène :

  • Couleur dominante différente de la palette
  • Disposition différente — ne centrez pas toujours tout
  • Entrée d'animation différente — variez entre Write, FadeIn, GrowFromCenter, Create
  • Poids visuel différent — certaines scènes denses, d'autres épurées

Flux de Travail

Étape 1 : Plan (plan.md)

Avant tout code, écrivez plan.md. Voir references/scene-planning.md pour le modèle complet.

Étape 2 : Code (script.py)

Une classe par scène. Chaque scène est rendable indépendamment.

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Scene1_Introduction(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("Pourquoi cela fonctionne-t-il ?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Pourquoi cela fonctionne-t-il ?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

Motifs clés :

  • Sous-titres sur chaque animation : self.add_subcaption("texte", duration=N) ou subcaption="texte" dans self.play()
  • Constantes de couleur partagées en haut du fichier pour la cohérence entre scènes
  • self.camera.background_color défini dans chaque scène
  • Sorties propres — FadeOut de tous les mobjects à la fin de la scène : self.play(FadeOut(Group(*self.mobjects)))

Étape 3 : Rendu

manim -ql script.py Scene1_Introduction Scene2_CoreConcept  # brouillon
manim -qh script.py Scene1_Introduction Scene2_CoreConcept  # production

Étape 4 : Assemblage

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Scene1_Introduction.mp4'
file 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

Étape 5 : Révision

manim -ql --format=png -s script.py Scene2_CoreConcept  # image d'aperçu

Notes d'Implémentation Critiques

Chaînes Brutes pour LaTeX

# FAUX : MathTex("\frac{1}{2}")
# CORRECT :
MathTex(r"\frac{1}{2}")

buff >= 0.5 pour le Texte en Bordure

label.to_edge(DOWN, buff=0.5)  # jamais < 0.5

FadeOut Avant de Remplacer du Texte

self.play(ReplacementTransform(note1, note2))  # pas Write(note2) par-dessus

Ne Jamais Animer des Mobjects Non Ajoutés

self.play(Create(circle))  # doit d'abord être ajouté
self.play(circle.animate.set_color(RED))  # puis animé

Objectifs de Performance

QualitéRésolutionFPSVitesse
-ql (brouillon)854x480155-15s/scène
-qm (moyen)1280x7203015-60s/scène
-qh (production)1920x10806030-120s/scène

Itérez toujours en -ql. Ne faites un rendu -qh que pour la sortie finale.

Références

FichierContenu
references/animations.mdAnimations de base, fonctions de taux, composition, syntaxe .animate, motifs de timing
references/mobjects.mdTexte, formes, VGroup/Group, positionnement, style, mobjects personnalisés
references/visual-design.md12 principes de design, superposition d'opacité, modèles de disposition, palettes de couleurs
references/equations.mdLaTeX dans Manim, TransformMatchingTex, motifs de dérivation
references/graphs-and-data.mdAxes, tracé, BarChart, données animées, visualisation d'algorithme
references/camera-and-3d.mdMovingCameraScene, ThreeDScene, surfaces 3D, contrôle de caméra
references/scene-planning.mdArcs narratifs, modèles de disposition, transitions de scène, modèle de planification
references/rendering.mdRéférence CLI, préréglages de qualité, ffmpeg, flux de travail voix off, exportation GIF
references/troubleshooting.mdErreurs LaTeX, erreurs d'animation, erreurs courantes, débogage
references/animation-design-thinking.mdQuand animer vs afficher statique, décomposition, rythme, synchronisation narration
references/updaters-and-trackers.mdValueTracker, add_updater, always_redraw, updaters basés sur le temps, motifs
references/paper-explainer.mdTransformer des articles de recherche en animations — flux de travail, modèles, motifs par domaine
references/decorations.mdSurroundingRectangle, Brace, flèches, DashedLine, Angle, cycle de vie des annotations
references/production-quality.mdListes de contrôle pré-code, pré-rendu, post-rendu, disposition spatiale, couleur, tempo

Divergence Créative (utiliser uniquement lorsque l'utilisateur demande une sortie expérimentale/créative/unique)

Si l'utilisateur demande des approches explicatives créatives, expérimentales ou non conventionnelles, sélectionnez une stratégie et raisonnez-la AVANT de concevoir l'animation.

  • SCAMPER — lorsque l'utilisateur souhaite une nouvelle vision d'une explication standard
  • Renversement d'Hypothèses — lorsque l'utilisateur souhaite remettre en question la façon dont quelque chose est généralement enseigné

Transformation SCAMPER

Prenez une visualisation mathématique/technique standard et transformez-la :

  • Substituer : remplacez la métaphore visuelle standard (droite numérique → chemin sinueux, matrice → grille de ville)
  • Combiner : fusionnez deux approches explicatives (algébrique + géométrique simultanément)
  • Inverser : déduisez à l'envers — partez du résultat et déconstruisez jusqu'aux axiomes
  • Modifier : exagérez un paramètre pour montrer pourquoi il est important (10x le taux d'apprentissage, 1000x la taille de l'échantillon)
  • Éliminer : supprimez toute notation — expliquez uniquement par l'animation et les relations spatiales

Renversement d'Hypothèses

  1. Listez ce qui est « standard » dans la façon dont ce sujet est visualisé (de gauche à droite, 2D, étapes discrètes, notation formelle)
  2. Choisissez l'hypothèse la plus fondamentale
  3. Inversez-la (dérivation de droite à gauche, plongement 3D d'un concept 2D, morphing continu au lieu d'étapes, zéro notation)
  4. Explorez ce que le renversement révèle que l'approche standard cache

Skills associés