Communitygithub.com

manim-motion-studio

Montre à un agent comment planifier, construire ou monter un "manim motion studio" afin d'obtenir une fiche de rythme et une liste de plans. La procédure passe par Manim Motion Studio, l'installation modulaire (`scripts/setup_manim.sh`) et le workflow. À utiliser quand une nouvelle mission nécessite ce savoir-faire.

Qu'est-ce que manim-motion-studio ?

Manim Motion Studio est un ensemble complet d'outils et de workflows pour produire des animations programmatiques fluides en 60fps, éditer des vidéos assistées par IA, et synchroniser la production vidéo avec Notion. Il s'appuie sur Manim Community, ffmpeg et divers paquets Python modulaires. La compétence fournit un script d'installation modulaire (`setup_manim.sh`) qui permet d'installer uniquement les profils nécessaires (core, editing, plugins, vision, audio, notion, full) pour éviter les conflits de dépendances. Le workflow guide l'utilisateur de la récupération du brief depuis Notion jusqu'au rendu final, en passant par la sélection de la classe de scène appropriée, l'utilisation de templates, l'aperçu rapide en qualité draft, le rendu aux formats cibles, et l'édition vidéo avancée avec détection de plans, sous-titrage automatique, recadrage intelligent, marquage de beats et mixage audio. Inclut également une matrice complète des capacités, des commandes essentielles de rendu et d'édition, et une synchronisation Notion pour la gestion de projet.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Japheth234-14/animatedVidEd-skill/tree/HEAD/manim-motion-studio

Demander à votre IA préférée

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

Documentation

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 manim minimaux n'incluent pas pdflatex. Utilisez toujours Text / MarkupText pour les étiquettes et transmettez label_constructor=Text dans Axes, BarChart et ThreeDAxes (axis_config={"label_constructor": Text}) sauf si vous avez vérifié que latex et dvisvgm sont installés pour MathTex/Tex.

Workflow

  1. 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.
  2. 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.md pour la pile rapide, references/python-animation-library-catalogue.md pour le catalogue complet en 18 sections).
  3. Démarrez à partir d'un modèle vérifié dans templates/ ou combinez des motifs provenant de references/.
  4. 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.
  5. Effectuez le rendu au format cible en utilisant scripts/render.py (ne combinez jamais -qh avec des dimensions -r personnalisées).
  6. É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).
  7. Inspectez visuellement les images extraites via ffmpeg avant de livrer le fichier .mp4 ou .gif final, et enregistrez le rendu dans Notion.

Matrice des capacités

DomaineClasses, animations et outils principauxRéférence / Modèle
Graphismes animés et caméraMovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, traits lumineux en couchesreferences/motion-graphics-camera.mdtemplates/motion_graphics_camera.py
Dessin de traits et morphingCreate, DrawBorderThenFill, Write, ShowPassingFlash, chemins Bezier VMobject, SVGMobject, TransformMatchingShapes, Homotopyreferences/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py
Chargeurs UI, micro-interactions et reels de démonstration20 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éereferences/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py
Personnages articulés et arrière-plans personnalisésRigging 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 personnagesreferences/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py
Scènes et surfaces 3DThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjectsreferences/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py
Visualisation de données et graphiquesAxes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + compteurs en direct always_redrawreferences/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py
Code, maths, physique et graphesCode, 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 / CVImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarkerreferences/3d-charts-physics-hybrid.md
Écosystème plus large du mouvement Pythonmanim-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'animationCatalogue 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 basereferences/python-animation-library-catalogue.md
Édition vidéo et post-production IAscripts/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, GIFsreferences/video-editing-postprod.mdscripts/video_edit.py
Workflows de production NotionApplication 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 commentairesreferences/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

  • -qh réinitialise les dimensions personnalisées : Ne passez jamais -qh lors du rendu de scènes portrait (1080x1920, 1080x1440) ou carré (1080x1080) ; utilisez scripts/render.py --preset ... ou -r LARGEUR,HAUTEUR --fps 60, et faites correspondre self.camera.frame_width / frame_height dans construct() au format cible.
  • Installations sans conflit uniquement : Ne mélangez jamais opencv-python + opencv-python-headless, pygame + pygame-ce, manim + manimgl, ou pip install ffmpeg (utilisez imageio-ffmpeg / le binaire système).
  • Décodage audio faster-whisper : Décodez toujours l'audio au préalable en mono float32 16 kHz via ffmpeg avant de le passer à WhisperModel.transcribe(...) (video_edit.py auto-captions gère cela automatiquement).
  • Mise à jour de la caméra MovingCameraScene : Appelez toujours self.add(self.camera.frame) avant self.camera.frame.add_updater(track_cam), et utilisez un lissage basé sur dt (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) lorsque abs(body_spin) > 0.02 ; conservez un hip_h fixe et droit pendant les rotations 360°/720° pour que la tête ne plonge pas vers le sol.
  • Placement du centre d'AnnularSector : Passez arc_center=center directement plutôt que .move_to(center) (qui aligne le centre de la boîte englobante).
  • Bases de temps xfade de ffmpeg : Placez fps=60,settb=1/60,format=yuv420p à la fin de chaque branche d'entrée (en particulier après overlay) avant d'enchaîner xfade.
  • HUD 3D et axes sans LaTeX : Dans ThreeDScene, appelez self.add_fixed_in_frame_mobjects(...) pour les éléments HUD 2D ; transmettez axis_config={"label_constructor": Text} à Axes, BarChart et ThreeDAxes.

Skills associés