Manim Motion Studio
Crie animações programáticas nítidas a 60fps, execute pipelines de edição de vídeo assistida por IA e sincronize a produção de vídeo com o Notion usando Manim Community, ffmpeg e pacotes Python modulares.
Configuração Modular (scripts/setup_manim.sh)
Instale apenas o perfil necessário para que dependências incompatíveis de GUI, CV ou 3D nunca colidam:
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 sem conflitos (Manim + edição IA + plugins + Notion)
Se o ffmpeg do sistema estiver ausente, scripts/setup_manim.sh cria um link simbólico do binário incluído no imageio_ffmpeg para /tmp/bin/ffmpeg, e tanto scripts/render.py quanto scripts/video_edit.py o injetam automaticamente no PATH.
Regra de Portabilidade sem LaTeX: Ambientes mínimos de
pip install manimnão incluempdflatex. Sempre useText/MarkupTextpara rótulos e passelabel_constructor=Textdentro deAxes,BarCharteThreeDAxes(axis_config={"label_constructor": Text}), a menos que você tenha verificado quelatexedvisvgmestão instalados paraMathTex/Tex.
Workflow
- Obtenha briefing, roteiro ou dados do Notion (via aplicativo Notion conectado ou
scripts/notion_sync.py) ao trabalhar a partir de um storyboard do workspace ou tabela de KPIs. - Escolha a classe de cena e os pacotes certos da matriz de capacidades abaixo (e
references/python-motion-ecosystem.mdpara a pilha rápida,references/python-animation-library-catalogue.mdpara o catálogo completo de 18 seções). - Comece a partir de um template verificado em
templates/ou combine padrões dereferences/. - Visualize rapidamente em qualidade de rascunho (
--quality draft) para verificar tempo, layout, rastreamento de câmera e enquadramento antes de uma renderização final a 60fps. - Renderize na proporção de aspecto alvo usando
scripts/render.py(nunca combine-qhcom dimensões personalizadas-r). - Edite, legendas, reenquadre, misture e exporte com
scripts/video_edit.py(combine,detect-scenes,auto-captions,burn-subtitles,smart-reframe,beat-markers,duck-audio,mux-audio,overlay,trim,speed,gif,probe). - Inspecione visualmente os quadros extraídos via
ffmpegantes de entregar o.mp4ou.giffinal, e registre a renderização de volta no Notion.
Matriz de Capacidades
| Domínio | Classes, Animações e Ferramentas Principais | Referência / Template |
|---|---|---|
| Motion Graphics e Câmera | MovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, traços brilhantes em camadas | references/motion-graphics-camera.mdtemplates/motion_graphics_camera.py |
| Desenho de Traços e Morfismo | Create, DrawBorderThenFill, Write, ShowPassingFlash, caminhos Bezier VMobject, SVGMobject, TransformMatchingShapes, Homotopy | references/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py |
| Carregadores de UI, Micro-Interações e Reels de Mostruário | 20 carregadores de UI (bola quicando, preenchimento líquido, shimmer de esqueleto/texto, orbit, spinners de raio/gradiente, quadrados perseguindo, bateria), chrome de navegador macOS, checklist progressivo, grade Bento 5×4 simultânea | references/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py |
| Personagens Articulados e Fundos Personalizados | Rigs de personagens FK/IK de 2 articulações, squash & stretch, piscadas/expressões, linhas do tempo ValueTracker de múltiplos atos, rastreamento de câmera seguro com dt, cenas de papel/mesa ImageMobject, remoção de fundo de personagens | references/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py |
| Cenas e Superfícies 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 |
| Visualização de Dados e Gráficos | Axes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + contadores ao vivo always_redraw | references/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py |
| Código, Matemática, Física e 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 Foto / CV | ImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarker | references/3d-charts-physics-hybrid.md |
| Ecosistema de Animação Python Mais Amplo | manim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, matriz de compatibilidade | references/python-motion-ecosystem.md |
| Catálogo Completo de Bibliotecas de Animação | Catálogo de 18 seções: matemática/explicador, 2D/jogos, programação criativa, vetor/SVG, edição de vídeo, CV/IA, 3D, física, gráficos, GUI, storytelling, easing, áudio, ferramentas adjacentes, índice pip, avisos, combinações de objetivos, pilha principal | references/python-animation-library-catalogue.md |
| Edição de Vídeo e Pós-Produção com IA | scripts/video_edit.py, detect-scenes (PySceneDetect), auto-captions (faster-whisper), burn-subtitles, smart-reframe (rastreamento OpenCV), beat-markers (librosa), duck-audio, combinação xfade, preenchimento borrado de aspecto misto, overlays .mov transparentes, GIFs | references/video-editing-postprod.mdscripts/video_edit.py |
| Fluxos de Produção com Notion | Aplicativo Notion conectado + scripts/notion_sync.py: pesquisa, leitura de briefings/storyboards, exportação de métricas do DB para JSON para gráficos Manim, criação de páginas de storyboard, atualização de status, registro de metadados do MP4 renderizado, anexação de blocos e comentários | references/notion-video-workflows.mdscripts/notion_sync.py |
Comandos Essenciais de Renderização, Edição de Vídeo e Notion
Renderizar Cenas do Manim (scripts/render.py)
# Visualização rápida de rascunho (meia resolução 15fps)
python3 scripts/render.py templates/character_rig_scene.py CharacterRigShowcase --quality draft
# Renderização completa 1080p60 16:9
python3 scripts/render.py templates/stroke_drawing_morphing.py StrokeMorphShowcase --quality high
# Retrato 9:16 (1080x1920), 3:4 (1080x1440) ou Quadrado 1:1 (1080x1080) a 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
# Overlay transparente (.mov com canal alpha para composição sobre vídeo)
python3 scripts/render.py lower_third.py LowerThird --transparent --quality high
Editar, Legendas, Reenquadrar e Montar Vídeos (scripts/video_edit.py)
# Inspecionar qualquer clipe de vídeo
python3 scripts/video_edit.py probe clip1.mp4 clip2.mp4
# Combinar clipes de aspectos mistos com crossfades de 0,5s e preenchimento ambiente borrado widescreen
python3 scripts/video_edit.py combine clip1.mp4 square_clip.mp4 -o Combined.mp4 --preset landscape --xfade 0.5 --bg-mode blur
# Edição com IA: detecção de cenas, legendas automáticas com Whisper, queima de legendas, reframing inteligente 9:16, sincronização com batida, 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
# Cortar, acelerar, compor overlay Manim transparente, multiplexar áudio ou 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 com o Notion (scripts/notion_sync.py ou Aplicativo Notion Conectado)
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"
Armadilhas Críticas
-qhredefine dimensões personalizadas: Nunca passe-qhao renderizar cenas em retrato (1080x1920,1080x1440) ou quadrado (1080x1080); usescripts/render.py --preset ...ou-r LARGURA,ALTURA --fps 60e ajusteself.camera.frame_width/frame_heightemconstruct()para a proporção de aspecto alvo.- Apenas instalações sem conflitos: Nunca misture
opencv-python+opencv-python-headless,pygame+pygame-ce,manim+manimgl, oupip install ffmpeg(useimageio-ffmpeg/ binário do sistema). - Decodificação de áudio do
faster-whisper: Sempre pré-decode o áudio para 16 kHz monofloat32viaffmpegantes de passar paraWhisperModel.transcribe(...)(video_edit.py auto-captionslida com isso automaticamente). - Atualizadores de câmera
MovingCameraScene: Sempre chameself.add(self.camera.frame)antes deself.camera.frame.add_updater(track_cam)e use suavização baseada emdt(1.0 - np.exp(-k * dt)) para que rascunhos a 15fps e renderizações a 60fps rastreiem de forma idêntica. - Ancora do quadril do personagem giratório: Nunca calcule
hip_h = -min(l_foot_y, r_foot_y)enquantoabs(body_spin) > 0.02; mantenha umhip_hfixo e ereto durante giros de 360°/720° para que a cabeça não mergulhe no chão. - Posicionamento do centro do
AnnularSector: Passearc_center=centerdiretamente em vez de.move_to(center)(que alinha o centro da caixa delimitadora). - Timebases do
ffmpegxfade: Coloquefps=60,settb=1/60,format=yuv420pno final de cada ramo de entrada (especialmente apósoverlay) antes de encadearxfade. - HUD 3D e eixos sem LaTeX: Em
ThreeDScene, chameself.add_fixed_in_frame_mobjects(...)para elementos HUD 2D; passeaxis_config={"label_constructor": Text}paraAxes,BarCharteThreeDAxes.