Communitygithub.com

Manim Motion Studio

Zeigt einem Agenten, wie man Manim Motion Studio plant, erstellt oder optimiert, mit konkretem Output in Form eines Drehbuchplans und einer Szenenliste. Der Ablauf folgt den Modulen Manim Motion Studio, Modular Setup (`scripts/setup_manim.sh`) und Workflow. Verwende es, wenn ein neuer Auftrag diese Fertigkeit erfordert.

Was ist Manim Motion Studio?

Manim Motion Studio ist eine umfassende AI-Agent-Fertigkeit zur Erstellung, Bearbeitung und Produktion von programmatischen Animationen mit 60 fps unter Verwendung von Manim Community, ffmpeg und modularen Python-Medienpaketen. Es bietet ein modulares Setup-Skript (`scripts/setup_manim.sh`), das Profile wie `core` (Basis-Manim), `editing` (KI-Videobearbeitung), `plugins` (Erweiterungen), `vision` (Computer Vision), `audio` (Audioanalyse) oder `notion` (Notion-Integration) isoliert installiert, um Konflikte zu vermeiden. Der Workflow führt von der Notion-Synchronisation über die Auswahl der richtigen Szene und Pakete (basierend auf einer umfassenden Fähigkeitsmatrix) bis hin zum Rendering, der KI-gestützten Nachbearbeitung (Shot-Erkennung, Untertitel, Smart-Reframing, Beat-Synchronisation) und der Protokollierung in Notion. Besondere Stärken liegen in der portablen LaTeX-freien Textunterstützung (`Text`/`MarkupText`), einer riesigen Bibliothek an Vorlagen und Referenzen für Motion Graphics, Charakter-Rigging, 3D-Szenen, Datenvisualisierung und UI-Loader sowie kritischen Gotchas zur Vermeidung von Package-Konflikten, korrektem Kamera-Tracking und Aspect-Ratio-Handling.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Manim Motion Studio?

Erstelle knackige, programmatische Animationen mit 60fps, führe KI-gestützte Videobearbeitungspipelines durch und synchronisiere die Videoproduktion mit Notion unter Verwendung von Manim Community, ffmpeg und modularen Python-Medienpaketen.

Modulares Setup (scripts/setup_manim.sh)

Installiere nur das Profil, das du benötigst, damit inkompatible GUI-, CV- oder 3D-Abhängigkeiten niemals kollidieren:

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     # vollständiger, konfliktfreier Stack (Manim + KI-Bearbeitung + Plugins + Notion)

Fehlt systemweites ffmpeg, erstellt scripts/setup_manim.sh einen symbolischen Link auf das gebündelte Binary von imageio_ffmpeg nach /tmp/bin/ffmpeg, und sowohl scripts/render.py als auch scripts/video_edit.py injizieren es automatisch in den PATH.

LaTeX-freie Portabilitätsregel: Minimal-Umgebungen mit pip install manim enthalten kein pdflatex. Verwende immer Text / MarkupText für Beschriftungen und übergib label_constructor=Text innerhalb von Axes, BarChart und ThreeDAxes (axis_config={"label_constructor": Text}), es sei denn, du hast überprüft, dass latex und dvisvgm für MathTex/Tex installiert sind.

Workflow

  1. Hole Briefing, Skript oder Daten aus Notion (über die verbundene Notion-App oder scripts/notion_sync.py), wenn du von einem Storyboard oder einer KPI-Tabelle aus einem Workspace arbeitest.
  2. Wähle die richtige Scene-Klasse & Pakete aus der untenstehenden Fähigkeitsmatrix (und references/python-motion-ecosystem.md für den schnellen Stack, references/python-animation-library-catalogue.md für den vollständigen 18-teiligen Katalog).
  3. Beginne mit einer geprüften Vorlage aus templates/ oder kombiniere Muster aus references/.
  4. Vorschau schnell in Entwurfsqualität (--quality draft), um Timing, Layout, Kameranachführung und Bildausschnitt zu überprüfen, bevor ein vollständiger 60fps-Render erstellt wird.
  5. Rendere im Ziel-Seitenverhältnis mit scripts/render.py (kombiniere niemals -qh mit benutzerdefinierten -r-Abmessungen).
  6. Bearbeite, untertitele, schneide neu, mische und exportiere mit 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. Überprüfe extrahierte Frames visuell über ffmpeg, bevor du die endgültige .mp4- oder .gif-Datei auslieferst, und protokolliere den Render zurück in Notion.

Fähigkeitsmatrix

BereichKernklassen, Animationen & WerkzeugeReferenz / Vorlage
Motion Graphics & KameraMovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, geschichtete Leucht-Strichereferences/motion-graphics-camera.mdtemplates/motion_graphics_camera.py
Strichzeichnungen & MorphingCreate, DrawBorderThenFill, Write, ShowPassingFlash, VMobject-Bezier-Pfade, SVGMobject, TransformMatchingShapes, Homotopyreferences/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py
UI-Ladebalken, Mikrointeraktionen & Showreels20 UI-Loader (hüpfender Ball, Liquid-Fill, Skeleton/Text-Shimmer, Orbit, Speichen-/Farbverlauf-Spinner, jagende Quadrate, Batterie), macOS-Browser-Chrome, progressive Checkliste, 5×4 simultanes Bento-Rasterreferences/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py
Artikulierte Charaktere & benutzerdefinierte Hintergründe2-Gelenk-FK/IK-Charakter-Rigs, Squash & Stretch, Blinzeln/Mimik, Multi-Akt-ValueTracker-Zeitlinien, dt-sichere Kameranachführung, ImageMobject-Papier/Schreibtischszenen, Hintergrundcharakter-Entfernungreferences/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py
3D-Szenen & OberflächenThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjectsreferences/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py
Datenvisualisierung & DiagrammeAxes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + always_redraw-Live-Zählerreferences/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py
Code, Mathe, Physik & GraphenCode, 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
Hybrid-Foto / CV-VideoImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarkerreferences/3d-charts-physics-hybrid.md
Breiteres Python-Bewegungs-Ökosystemmanim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, Kompatibilitätsmatrixreferences/python-motion-ecosystem.md
Vollständiger Animationsbibliothekskatalog18-teiliger Katalog: Mathe/Erklärvideos, 2D/Spiele, Creative Coding, Vektor/SVG, Videobearbeitung, CV/KI, 3D, Physik, Diagramme, GUI, Storytelling, Easing, Audio, angrenzende Werkzeuge, pip-Index, Warnungen, Zielkombinationen, Kern-Stackreferences/python-animation-library-catalogue.md
Videobearbeitung & KI-Postproduktionscripts/video_edit.py, detect-scenes (PySceneDetect), auto-captions (faster-whisper), burn-subtitles, smart-reframe (OpenCV-Tracking), beat-markers (librosa), duck-audio, xfade-Kombinieren, gemischt-aspektierte unscharfe Polsterung, transparente .mov-Overlays, GIFsreferences/video-editing-postprod.mdscripts/video_edit.py
Notion-Produktions-WorkflowsVerbundene Notion-App + scripts/notion_sync.py: Suchen, Lesen von Briefings/Storyboards, Export von DB-Metriken als JSON für Manim-Diagramme, Erstellen von Storyboard-Seiten, Aktualisieren von Status, Protokollieren von gerenderten MP4-Metadaten, Anhängen von Blöcken & Kommentarenreferences/notion-video-workflows.mdscripts/notion_sync.py

Wichtige Rendering-, Videobearbeitungs- und Notion-Befehle

Manim-Szenen rendern (scripts/render.py)

# Schnelle Entwurfsvorschau (halbe Auflösung, 15fps)
python3 scripts/render.py templates/character_rig_scene.py CharacterRigShowcase --quality draft

# Vollständiger 1080p60 16:9 Render
python3 scripts/render.py templates/stroke_drawing_morphing.py StrokeMorphShowcase --quality high

# Hochformat 9:16 (1080x1920), 3:4 (1080x1440) oder Quadrat 1:1 (1080x1080) bei 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

# Transparentes Overlay (.mov mit Alphakanal zum Compositing auf Video)
python3 scripts/render.py lower_third.py LowerThird --transparent --quality high

Videos bearbeiten, untertiteln, neu zuschneiden und zusammenfügen (scripts/video_edit.py)

# Ein beliebiges Videoclip inspizieren
python3 scripts/video_edit.py probe clip1.mp4 clip2.mp4

# Gemischt-aspektierte Clips mit 0,5s Überblendungen und unscharfem Ambient-Widescreen-Padding kombinieren
python3 scripts/video_edit.py combine clip1.mp4 square_clip.mp4 -o Combined.mp4 --preset landscape --xfade 0.5 --bg-mode blur

# KI-Bearbeitung: Szenenerkennung, Whisper-Autountertitel, Untertitel-Einbrennung, Smart 9:16-Neuzuschnitt, Beat-Synchronisation, 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

# Schneiden, Speed-Ramping, Compositing eines transparenten Manim-Overlays, Audio muxen oder GIF exportieren
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

Mit Notion synchronisieren (scripts/notion_sync.py oder verbundene Notion-App)

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"

Kritische Fallstricke

  • -qh setzt benutzerdefinierte Maße zurück: Übergib niemals -qh beim Rendern von Hochformat- (1080x1920, 1080x1440) oder Quadrat-Szenen (1080x1080); verwende scripts/render.py --preset ... oder -r BREITE,HOEHE --fps 60, und passe self.camera.frame_width / frame_height in construct() an das Ziel-Seitenverhältnis an.
  • Nur konfliktfreie Installationen: Mische niemals opencv-python + opencv-python-headless, pygame + pygame-ce, manim + manimgl oder pip install ffmpeg (verwende imageio-ffmpeg / systemweites Binary).
  • faster-whisper-Audiodekodierung: Dekodiere Audio vor der Übergabe an WhisperModel.transcribe(...) immer in 16-kHz-Mono-float32 mit ffmpeg (video_edit.py auto-captions erledigt dies automatisch).
  • MovingCameraScene-Kamera-Updater: Rufe immer self.add(self.camera.frame) vor self.camera.frame.add_updater(track_cam) auf und verwende dt-basierte Glättung (1.0 - np.exp(-k * dt)), damit 15fps-Entwürfe und 60fps-Render identisch nachführen.
  • Drehender Charakter-Hüftanker: Berechne hip_h niemals als -min(l_foot_y, r_foot_y), während abs(body_spin) > 0.02; behalte während 360°/720°-Drehungen eine feste, aufrechte hip_h bei, damit der Kopf nicht in den Boden taucht.
  • Positionierung von AnnularSector: Übergib arc_center=center direkt statt .move_to(center) (was den Bounding-Box-Mittelpunkt ausrichtet).
  • ffmpeg xfade-Zeitbasen: Platziere fps=60,settb=1/60,format=yuv420p am Ende jedes Eingabe-Zweigs (insbesondere nach overlay), bevor du xfade verkettest.
  • 3D-HUD & LaTeX-freie Achsen: Rufe in ThreeDScene self.add_fixed_in_frame_mobjects(...) für 2D-HUD-Elemente auf; übergib axis_config={"label_constructor": Text} an Axes, BarChart und ThreeDAxes.

Verwandte Skills