Communitygithub.com

manim-motion-studio

Mostra ao agente como planejar, construir ou editar um "manim motion studio", gerando como saída concreta um roteiro visual (beat sheet) e uma lista de cenas (shot list). O fluxo passa pelo Manim Motion Studio, Configuração Modular e Workflow. Use-o quando uma nova tarefa exigir essa habilidade.

O que é manim-motion-studio?

Manim Motion Studio é uma skill abrangente para criação de animações programáticas em 60fps, edição de vídeo assistida por IA e sincronização com o Notion, utilizando Manim Community, ffmpeg e pacotes Python modulares. Ela fornece um conjunto de scripts (setup_manim.sh, render.py, video_edit.py, notion_sync.py) que permitem instalar perfis específicos de dependências (core, editing, plugins, vision, audio, notion, full) sem conflitos, renderizar cenas em diversas resoluções e aspectos, e realizar tarefas de pós-produção como detecção de cenas, legendas automáticas, reframing inteligente e sincronização com batidas musicais. A skill também oferece integração direta com o Notion para buscar briefings, registrar métricas e atualizar status dos projetos. Sua matriz de capacidades cobre desde motion graphics, rigging de personagens e gráficos 3D até visualização de dados, código, matemática e física, além de oferecer referências detalhadas e templates prontos para uso. É ideal para agentes que precisam produzir animações explicativas, vídeos para redes sociais, demonstrações técnicas ou qualquer conteúdo que combine animação procedural com edição profissional.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 manim não incluem pdflatex. Sempre use Text / MarkupText para rótulos e passe label_constructor=Text dentro de Axes, BarChart e ThreeDAxes (axis_config={"label_constructor": Text}), a menos que você tenha verificado que latex e dvisvgm estão instalados para MathTex/Tex.

Workflow

  1. 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.
  2. Escolha a classe de cena e os pacotes certos da matriz de capacidades abaixo (e references/python-motion-ecosystem.md para a pilha rápida, references/python-animation-library-catalogue.md para o catálogo completo de 18 seções).
  3. Comece a partir de um template verificado em templates/ ou combine padrões de references/.
  4. 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.
  5. Renderize na proporção de aspecto alvo usando scripts/render.py (nunca combine -qh com dimensões personalizadas -r).
  6. 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).
  7. Inspecione visualmente os quadros extraídos via ffmpeg antes de entregar o .mp4 ou .gif final, e registre a renderização de volta no Notion.

Matriz de Capacidades

DomínioClasses, Animações e Ferramentas PrincipaisReferência / Template
Motion Graphics e CâmeraMovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, traços brilhantes em camadasreferences/motion-graphics-camera.mdtemplates/motion_graphics_camera.py
Desenho de Traços e MorfismoCreate, DrawBorderThenFill, Write, ShowPassingFlash, caminhos Bezier VMobject, SVGMobject, TransformMatchingShapes, Homotopyreferences/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py
Carregadores de UI, Micro-Interações e Reels de Mostruário20 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âneareferences/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py
Personagens Articulados e Fundos PersonalizadosRigs 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 personagensreferences/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py
Cenas e Superfícies 3DThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjectsreferences/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py
Visualização de Dados e GráficosAxes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + contadores ao vivo always_redrawreferences/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py
Código, Matemática, Física e GrafosCode, 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 / CVImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarkerreferences/3d-charts-physics-hybrid.md
Ecosistema de Animação Python Mais Amplomanim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, matriz de compatibilidadereferences/python-motion-ecosystem.md
Catálogo Completo de Bibliotecas de AnimaçãoCatá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 principalreferences/python-animation-library-catalogue.md
Edição de Vídeo e Pós-Produção com IAscripts/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, GIFsreferences/video-editing-postprod.mdscripts/video_edit.py
Fluxos de Produção com NotionAplicativo 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áriosreferences/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

  • -qh redefine dimensões personalizadas: Nunca passe -qh ao renderizar cenas em retrato (1080x1920, 1080x1440) ou quadrado (1080x1080); use scripts/render.py --preset ... ou -r LARGURA,ALTURA --fps 60 e ajuste self.camera.frame_width / frame_height em construct() para a proporção de aspecto alvo.
  • Apenas instalações sem conflitos: Nunca misture opencv-python + opencv-python-headless, pygame + pygame-ce, manim + manimgl, ou pip install ffmpeg (use imageio-ffmpeg / binário do sistema).
  • Decodificação de áudio do faster-whisper: Sempre pré-decode o áudio para 16 kHz mono float32 via ffmpeg antes de passar para WhisperModel.transcribe(...) (video_edit.py auto-captions lida com isso automaticamente).
  • Atualizadores de câmera MovingCameraScene: Sempre chame self.add(self.camera.frame) antes de self.camera.frame.add_updater(track_cam) e use suavização baseada em dt (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) enquanto abs(body_spin) > 0.02; mantenha um hip_h fixo e ereto durante giros de 360°/720° para que a cabeça não mergulhe no chão.
  • Posicionamento do centro do AnnularSector: Passe arc_center=center diretamente em vez de .move_to(center) (que alinha o centro da caixa delimitadora).
  • Timebases do ffmpeg xfade: Coloque fps=60,settb=1/60,format=yuv420p no final de cada ramo de entrada (especialmente após overlay) antes de encadear xfade.
  • HUD 3D e eixos sem LaTeX: Em ThreeDScene, chame self.add_fixed_in_frame_mobjects(...) para elementos HUD 2D; passe axis_config={"label_constructor": Text} para Axes, BarChart e ThreeDAxes.

Habilidades Relacionadas