Manim Motion Studio
Créez des animations programmatiques nettes en 60fps, exécutez des pipelines d'édition vidéo assistés par IA et synchronisez la production vidéo avec Notion en utilisant Manim Community, ffmpeg et des paquets Python modulaires pour le multimédia.
Installation modulaire (scripts/setup_manim.sh)
Installez uniquement le profil dont vous avez besoin afin que les dépendances GUI, CV ou 3D incompatibles n'entrent jamais en conflit :
bash scripts/setup_manim.sh core # manim + imageio-ffmpeg + pillow + numpy + scipy
bash scripts/setup_manim.sh editing # + av, moviepy, scenedetect, opencv-headless, faster-whisper, pydub
bash scripts/setup_manim.sh plugins # + manim-slides, manim-physics, manim-voiceover
bash scripts/setup_manim.sh vision # + opencv-python-headless, mediapipe, scikit-image
bash scripts/setup_manim.sh audio # + librosa, pydub, soundfile, faster-whisper
bash scripts/setup_manim.sh notion # + notion-client
bash scripts/setup_manim.sh full # pile complète sans conflit (Manim + édition IA + plugins + Notion)
Si ffmpeg système est manquant, scripts/setup_manim.sh crée un lien symbolique du binaire fourni par imageio_ffmpeg vers /tmp/bin/ffmpeg, et scripts/render.py et scripts/video_edit.py l'injectent automatiquement dans PATH.
Règle de portabilité sans LaTeX : Les environnements
pip install manimminimaux n'incluent paspdflatex. Utilisez toujoursText/MarkupTextpour les étiquettes et transmettezlabel_constructor=TextdansAxes,BarChartetThreeDAxes(axis_config={"label_constructor": Text}) sauf si vous avez vérifié quelatexetdvisvgmsont installés pourMathTex/Tex.
Workflow
- Récupérez le brief, le script ou les données depuis Notion (via l'application Notion connectée ou
scripts/notion_sync.py) lorsque vous travaillez à partir d'un storyboard ou d'un tableau KPI d'un espace de travail. - Choisissez la classe de scène et les paquets appropriés à l'aide de la matrice des capacités ci-dessous (et de
references/python-motion-ecosystem.mdpour la pile rapide,references/python-animation-library-catalogue.mdpour le catalogue complet en 18 sections). - Démarrez à partir d'un modèle vérifié dans
templates/ou combinez des motifs provenant dereferences/. - Prévisualisez rapidement en qualité brouillon (
--quality draft) pour vérifier le timing, la mise en page, le suivi de caméra et le cadrage avant un rendu complet en 60fps. - Effectuez le rendu au format cible en utilisant
scripts/render.py(ne combinez jamais-qhavec des dimensions-rpersonnalisées). - Éditez, sous-titrez, recadrez, mixez et exportez avec
scripts/video_edit.py(combine,detect-scenes,auto-captions,burn-subtitles,smart-reframe,beat-markers,duck-audio,mux-audio,overlay,trim,speed,gif,probe). - Inspectez visuellement les images extraites via
ffmpegavant de livrer le fichier.mp4ou.giffinal, et enregistrez le rendu dans Notion.
Matrice des capacités
| Domaine | Classes, animations et outils principaux | Référence / Modèle |
|---|---|---|
| Graphismes animés et caméra | MovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, traits lumineux en couches | references/motion-graphics-camera.mdtemplates/motion_graphics_camera.py |
| Dessin de traits et morphing | Create, DrawBorderThenFill, Write, ShowPassingFlash, chemins Bezier VMobject, SVGMobject, TransformMatchingShapes, Homotopy | references/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py |
| Chargeurs UI, micro-interactions et reels de démonstration | 20 chargeurs UI (balle rebondissante, remplissage liquide, squelette/texte scintillant, orbite, spinners à dégradé/rayons, carrés en poursuite, batterie), navigateur macOS, liste de contrôle progressive, grille Bento 5×4 simultanée | references/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py |
| Personnages articulés et arrière-plans personnalisés | Rigging FK/IK à 2 articulations, squash & stretch, clignements/expressions, timelines multi-actions ValueTracker, suivi de caméra sécurisé dt, ImageMobject scènes papier/bureau, suppression d'arrière-plan de personnages | references/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py |
| Scènes et surfaces 3D | ThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjects | references/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py |
| Visualisation de données et graphiques | Axes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + compteurs en direct always_redraw | references/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py |
| Code, maths, physique et graphes | Code, Table, Brace, SurroundingRectangle, apply_matrix, ComplexPlane, ArrowVectorField, StreamLines, Graph/DiGraph, add_updater(mob, dt) | references/3d-charts-physics-hybrid.mdtemplates/math_code_and_diagrams.py |
| Vidéo hybride photo / CV | ImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarker | references/3d-charts-physics-hybrid.md |
| Écosystème plus large du mouvement Python | manim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, matrice de compatibilité | references/python-motion-ecosystem.md |
| Catalogue complet des bibliothèques d'animation | Catalogue en 18 sections : math/explainer, 2D/jeu, codage créatif, vectoriel/SVG, édition vidéo, CV/IA, 3D, physique, graphiques, GUI, narration, easing, audio, outils adjacents, index pip, avertissements, combinaisons d'objectifs, pile de base | references/python-animation-library-catalogue.md |
| Édition vidéo et post-production IA | scripts/video_edit.py, detect-scenes (PySceneDetect), auto-captions (faster-whisper), burn-subtitles, smart-reframe (suivi OpenCV), beat-markers (librosa), duck-audio, combinaison xfade, remplissage flou de proportions mixtes, superpositions .mov transparentes, GIFs | references/video-editing-postprod.mdscripts/video_edit.py |
| Workflows de production Notion | Application Notion connectée + scripts/notion_sync.py : recherche, lecture de briefs/storyboards, export de métriques DB vers JSON pour les graphiques Manim, création de pages storyboard, mise à jour des statuts, journalisation des métadonnées MP4 rendues, ajout de blocs et commentaires | references/notion-video-workflows.mdscripts/notion_sync.py |
Commandes essentielles de rendu, d'édition vidéo et Notion
Rendu des scènes Manim (scripts/render.py)
# Aperçu rapide en brouillon (demi-résolution 15fps)
python3 scripts/render.py templates/character_rig_scene.py CharacterRigShowcase --quality draft
# Rendu complet 1080p60 16:9
python3 scripts/render.py templates/stroke_drawing_morphing.py StrokeMorphShowcase --quality high
# Portrait 9:16 (1080x1920), 3:4 (1080x1440) ou Carré 1:1 (1080x1080) en 60fps
python3 scripts/render.py my_scene.py MyScene --preset portrait --quality high
python3 scripts/render.py my_scene.py MyScene --preset square --quality high
# Superposition transparente (.mov avec canal alpha pour composition sur vidéo)
python3 scripts/render.py lower_third.py LowerThird --transparent --quality high
Éditer, sous-titrer, recadrer et assembler des vidéos (scripts/video_edit.py)
# Inspecter n'importe quel clip vidéo
python3 scripts/video_edit.py probe clip1.mp4 clip2.mp4
# Combiner des clips de proportions mixtes avec fondus enchaînés de 0,5 s et remplissage flou grand écran ambiant
python3 scripts/video_edit.py combine clip1.mp4 square_clip.mp4 -o Combined.mp4 --preset landscape --xfade 0.5 --bg-mode blur
# Édition IA : détection de plans, sous-titrage automatique Whisper, gravure de sous-titres, recadrage intelligent 9:16, synchronisation au beat, ducking
python3 scripts/video_edit.py detect-scenes raw.mp4 --out scenes.json --split-dir shots/
python3 scripts/video_edit.py auto-captions talk.mp4 -o captions.srt --json-out words.json --words
python3 scripts/video_edit.py burn-subtitles talk.mp4 --srt captions.srt -o captioned.mp4
python3 scripts/video_edit.py smart-reframe wide.mp4 -o reel_9x16.mp4 --preset portrait
python3 scripts/video_edit.py beat-markers music.mp3 --out beats.json
python3 scripts/video_edit.py duck-audio video.mp4 --voice narration.mp3 --music bgm.mp3 -o mixed.mp4
# Rogner, accélérer, composer une superposition transparente Manim, mixer l'audio ou exporter un GIF
python3 scripts/video_edit.py trim in.mp4 -o cut.mp4 --start 2.0 --end 14.5
python3 scripts/video_edit.py speed in.mp4 -o fast.mp4 --factor 1.5
python3 scripts/video_edit.py overlay base.mp4 overlay.mov -o out.mp4
python3 scripts/video_edit.py mux-audio video.mp4 music.mp3 -o final.mp4 --volume 0.35 --fade-out 1.5
python3 scripts/video_edit.py gif final.mp4 -o preview.gif --fps 24 --width 720
Synchronisation avec Notion (scripts/notion_sync.py ou l'application Notion connectée)
export NOTION_TOKEN="ntn_..."
python3 scripts/notion_sync.py search "Video Roadmap"
python3 scripts/notion_sync.py read-page <PAGE_ID> --out brief.md
python3 scripts/notion_sync.py query-db <DB_ID> --out metrics.json
python3 scripts/notion_sync.py create-page --parent-db <DB_ID> --title "Launch Reel" --status "Draft" --body-file storyboard.md
python3 scripts/notion_sync.py update-status <PAGE_ID> --prop Status --value "Rendered"
python3 scripts/notion_sync.py log-render <PAGE_ID> --video out.mp4 --notes "1080p60 final"
Pièges critiques
-qhréinitialise les dimensions personnalisées : Ne passez jamais-qhlors du rendu de scènes portrait (1080x1920,1080x1440) ou carré (1080x1080) ; utilisezscripts/render.py --preset ...ou-r LARGEUR,HAUTEUR --fps 60, et faites correspondreself.camera.frame_width/frame_heightdansconstruct()au format cible.- Installations sans conflit uniquement : Ne mélangez jamais
opencv-python+opencv-python-headless,pygame+pygame-ce,manim+manimgl, oupip install ffmpeg(utilisezimageio-ffmpeg/ le binaire système). - Décodage audio
faster-whisper: Décodez toujours l'audio au préalable en monofloat3216 kHz viaffmpegavant de le passer àWhisperModel.transcribe(...)(video_edit.py auto-captionsgère cela automatiquement). - Mise à jour de la caméra
MovingCameraScene: Appelez toujoursself.add(self.camera.frame)avantself.camera.frame.add_updater(track_cam), et utilisez un lissage basé surdt(1.0 - np.exp(-k * dt)) afin que les brouillons 15fps et les rendus 60fps suivent de manière identique. - Point d'ancrage de la hanche d'un personnage qui tourne : Ne calculez jamais
hip_h = -min(l_foot_y, r_foot_y)lorsqueabs(body_spin) > 0.02; conservez unhip_hfixe et droit pendant les rotations 360°/720° pour que la tête ne plonge pas vers le sol. - Placement du centre d'
AnnularSector: Passezarc_center=centerdirectement plutôt que.move_to(center)(qui aligne le centre de la boîte englobante). - Bases de temps
xfadedeffmpeg: Placezfps=60,settb=1/60,format=yuv420pà la fin de chaque branche d'entrée (en particulier aprèsoverlay) avant d'enchaînerxfade. - HUD 3D et axes sans LaTeX : Dans
ThreeDScene, appelezself.add_fixed_in_frame_mobjects(...)pour les éléments HUD 2D ; transmettezaxis_config={"label_constructor": Text}àAxes,BarChartetThreeDAxes.