Manim Motion Studio
Construye animaciones programáticas nítidas a 60 fps, ejecuta tuberías de edición de vídeo asistidas por IA y sincroniza la producción de vídeo con Notion utilizando Manim Community, ffmpeg y paquetes Python modulares.
Configuración modular (scripts/setup_manim.sh)
Instala solo el perfil que necesites para que las dependencias incompatibles de GUI, CV o 3D nunca entren en conflicto:
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 # stack completo sin conflictos (Manim + edición IA + plugins + Notion)
Si el ffmpeg del sistema falta, scripts/setup_manim.sh crea un enlace simbólico del binario empaquetado de imageio_ffmpeg a /tmp/bin/ffmpeg, y tanto scripts/render.py como scripts/video_edit.py lo inyectan automáticamente en PATH.
Regla de portabilidad sin LaTeX: Los entornos mínimos de
pip install manimno incluyenpdflatex. Siempre usaText/MarkupTextpara las etiquetas y pasalabel_constructor=Textdentro deAxes,BarChartyThreeDAxes(axis_config={"label_constructor": Text}) a menos que hayas verificado quelatexydvisvgmestán instalados paraMathTex/Tex.
Flujo de trabajo
- Obtén el brief, guión o datos desde Notion (mediante la app conectada de Notion o
scripts/notion_sync.py) cuando trabajes a partir de un storyboard del espacio de trabajo o una tabla de KPI. - Elige la clase de escena y paquetes adecuados de la matriz de capacidades a continuación (y de
references/python-motion-ecosystem.mdpara la pila rápida,references/python-animation-library-catalogue.mdpara el catálogo completo de 18 secciones). - Comienza desde una plantilla verificada en
templates/o combina patrones dereferences/. - Previsualiza rápido en calidad de borrador (
--quality draft) para verificar tiempos, diseño, seguimiento de cámara y encuadre antes de un renderizado completo a 60 fps. - Renderiza en la relación de aspecto objetivo usando
scripts/render.py(nunca combines-qhcon dimensiones-rpersonalizadas). - Edita, subtitula, reencuadra, mezcla y exporta con
scripts/video_edit.py(combine,detect-scenes,auto-captions,burn-subtitles,smart-reframe,beat-markers,duck-audio,mux-audio,overlay,trim,speed,gif,probe). - Inspecciona visualmente los fotogramas extraídos mediante
ffmpegantes de entregar el.mp4o.giffinal, y registra el renderizado de vuelta a Notion.
Matriz de capacidades
| Dominio | Clases principales, animaciones y herramientas | Referencia / Plantilla |
|---|---|---|
| Gráficos en movimiento y cámara | MovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, trazos brillantes en capas | references/motion-graphics-camera.mdtemplates/motion_graphics_camera.py |
| Dibujo de trazos y morphing | Create, DrawBorderThenFill, Write, ShowPassingFlash, VMobject curvas Bezier, SVGMobject, TransformMatchingShapes, Homotopy | references/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py |
| Cargadores de UI, microinteracciones y reels de demostración | 20 cargadores de UI (pelota rebotando, relleno líquido, brillo de esqueleto/texto, órbita, spinners de radio/gradiente, cuadrados persiguiendo, batería), navegador macOS, lista de verificación progresiva, cuadrícula Bento 5×4 simultánea | references/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py |
| Personajes articulados y fondos personalizados | Rigs de personajes FK/IK de 2 articulaciones, squash & stretch, parpadeos/expresiones, líneas de tiempo ValueTracker multi-acto, seguimiento de cámara seguro con dt, escenas de papel/escritorio con ImageMobject, eliminación de fondos de personajes | references/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py |
| Escenas 3D y superficies | ThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjects | references/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py |
| Visualización de datos y gráficos | Axes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + always_redraw contadores en vivo | references/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py |
| Código, matemáticas, física y grafos | 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 |
| Vídeo híbrido / CV con fotos | ImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarker | references/3d-charts-physics-hybrid.md |
| Ecosistema de movimiento Python más amplio | manim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, matriz de compatibilidad | references/python-motion-ecosystem.md |
| Catálogo completo de bibliotecas de animación | Catálogo de 18 secciones: matemáticas/explicativas, 2D/juegos, coding creativo, vector/SVG, edición de vídeo, CV/IA, 3D, física, gráficos, GUI, narración, easing, audio, herramientas adyacentes, índice pip, advertencias, combinaciones de objetivos, pila central | references/python-animation-library-catalogue.md |
| Edición de vídeo y postproducción con IA | scripts/video_edit.py, detect-scenes (PySceneDetect), auto-captions (faster-whisper), burn-subtitles, smart-reframe (seguimiento OpenCV), beat-markers (librosa), duck-audio, combinación xfade, relleno borroso de aspecto mixto, superposiciones .mov transparentes, GIFs | references/video-editing-postprod.mdscripts/video_edit.py |
| Flujos de producción con Notion | App conectada de Notion + scripts/notion_sync.py: búsqueda, lectura de briefs/storyboards, exportación de métricas de DB a JSON para gráficos Manim, creación de páginas de storyboard, actualización de estados, registro de metadatos de MP4 renderizados, añadido de bloques y comentarios | references/notion-video-workflows.mdscripts/notion_sync.py |
Comandos esenciales de renderizado, edición de vídeo y Notion
Renderizar escenas de Manim (scripts/render.py)
# Vista previa rápida en borrador (media resolución 15 fps)
python3 scripts/render.py templates/character_rig_scene.py CharacterRigShowcase --quality draft
# Renderizado completo 1080p60 16:9
python3 scripts/render.py templates/stroke_drawing_morphing.py StrokeMorphShowcase --quality high
# Retrato 9:16 (1080x1920), 3:4 (1080x1440) o Cuadrado 1:1 (1080x1080) a 60 fps
python3 scripts/render.py my_scene.py MyScene --preset portrait --quality high
python3 scripts/render.py my_scene.py MyScene --preset square --quality high
# Superposición transparente (.mov con canal alfa para componer sobre vídeo)
python3 scripts/render.py lower_third.py LowerThird --transparent --quality high
Editar, subtitular, reencuadrar y ensamblar vídeos (scripts/video_edit.py)
# Inspeccionar cualquier clip de vídeo
python3 scripts/video_edit.py probe clip1.mp4 clip2.mp4
# Combinar clips de aspecto mixto con fundidos cruzados de 0.5 s y relleno de pantalla panorámica borroso ambiental
python3 scripts/video_edit.py combine clip1.mp4 square_clip.mp4 -o Combined.mp4 --preset landscape --xfade 0.5 --bg-mode blur
# Edición con IA: detección de tomas, subtítulos automáticos con Whisper, incrustación de subtítulos, reencuadre inteligente 9:16, sincronización de ritmo, 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
# Recortar, cambiar velocidad, componer superposición Manim transparente, multiplexar audio o exportar 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
Sincronizar con Notion (scripts/notion_sync.py o app conectada de Notion)
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"
Errores críticos (Gotchas)
-qhreinicia las dimensiones personalizadas: Nunca pases-qhal renderizar escenas en retrato (1080x1920,1080x1440) o cuadrado (1080x1080); usascripts/render.py --preset ...o-r WIDTH,HEIGHT --fps 60, y haz coincidirself.camera.frame_width/frame_heightenconstruct()con la relación de aspecto objetivo.- Solo instalaciones sin conflictos: Nunca mezcles
opencv-python+opencv-python-headless,pygame+pygame-ce,manim+manimgl, opip install ffmpeg(usaimageio-ffmpeg/ binario del sistema). - Decodificación de audio con
faster-whisper: Siempre predecodifica el audio a 16 kHz monofloat32medianteffmpegantes de pasarlo aWhisperModel.transcribe(...)(video_edit.py auto-captionslo maneja automáticamente). - Actualizadores de cámara en
MovingCameraScene: Siempre llama aself.add(self.camera.frame)antes deself.camera.frame.add_updater(track_cam), y usa suavizado basado endt(1.0 - np.exp(-k * dt)) para que los borradores a 15 fps y los renders a 60 fps sigan la misma trayectoria. - Anclaje de cadera del personaje giratorio: Nunca calcules
hip_h = -min(l_foot_y, r_foot_y)mientrasabs(body_spin) > 0.02; mantén unhip_hfijo y vertical durante giros de 360°/720° para que la cabeza no se hunda en el suelo. - Colocación del centro de
AnnularSector: Pasaarc_center=centerdirectamente en lugar de.move_to(center)(que alinea el centro del cuadro delimitador). - Bases de tiempo de
xfadeenffmpeg: Colocafps=60,settb=1/60,format=yuv420pal final de cada rama de entrada (especialmente después deoverlay) antes de encadenarxfade. - HUD 3D y ejes sin LaTeX: En
ThreeDScene, llama aself.add_fixed_in_frame_mobjects(...)para elementos HUD 2D; pasaaxis_config={"label_constructor": Text}aAxes,BarChartyThreeDAxes.