Communitygithub.com

Manim Motion Studio

AI 에이전트가 Manim Motion Studio를 사용하여 비트 시트(beat sheet)와 샷 리스트(shot list)를 계획, 제작 및 편집하는 방법을 안내합니다. 모듈식 설정, 비디오 편집, Notion 동기화 워크플로우를 다룹니다.

Manim Motion Studio란 무엇인가요?

Manim Motion Studio는 AI 에이전트가 Manim Community, ffmpeg, 그리고 모듈식 Python 미디어 패키지를 사용하여 60fps 프로그래매틱 애니메이션을 제작하고 AI 기반 비디오 편집 파이프라인을 실행하며 Notion과 비디오 제작을 동기화할 수 있도록 지원하는 스킬입니다. 이 스킬은 충돌 없는 모듈식 설치 스크립트(`scripts/setup_manim.sh`), 렌더링 및 편집 스크립트(`scripts/render.py`, `scripts/video_edit.py`), Notion 동기화 스크립트(`scripts/notion_sync.py`)를 제공합니다. 또한 모션 그래픽, 캐릭터 리깅, 3D 씬, 데이터 시각화, 비디오 편집 및 AI 후반 작업 등 12개 이상의 도메인에 대한 능력 매트릭스를 포함하고 있어 복잡한 애니메이션 제작 워크플로우를 효과적으로 관리할 수 있습니다. 특히 Notion과의 통합을 통해 브리프, 스토리보드, 렌더링 로그를 중앙에서 관리할 수 있어 협업 및 프로젝트 추적에 유용합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Manim Motion Studio은(는) 무엇을 하나요?

Manim Community, ffmpeg 및 모듈식 Python 미디어 패키지를 사용하여 선명한 60fps 프로그래매틱 애니메이션을 제작하고, AI 기반 비디오 편집 파이프라인을 실행하며, Notion과 비디오 제작 워크플로우를 동기화합니다.

모듈식 설치 (scripts/setup_manim.sh)

호환되지 않는 GUI, CV 또는 3D 종속성이 충돌하지 않도록 필요한 프로필만 설치하세요:

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     # 충돌 없는 전체 스택 (Manim + AI 편집 + 플러그인 + Notion)

시스템 ffmpeg가 누락된 경우, scripts/setup_manim.sh가 imageio_ffmpeg에 번들된 바이너리를 /tmp/bin/ffmpeg에 심볼릭 링크로 연결하며, scripts/render.py 및 scripts/video_edit.py 모두 자동으로 이를 PATH에 추가합니다.

LaTeX-프리 이식성 규칙: 최소 pip install manim 환경에는 pdflatex가 포함되지 않습니다. MathTex/Tex를 위해 latex 및 dvisvgm이 설치되어 있음을 확인하지 않은 한, 레이블에는 항상 Text / MarkupText를 사용하고, Axes, BarChart, ThreeDAxes 내부에서는 label_constructor=Text를 전달하세요 (axis_config={"label_constructor": Text}).

워크플로우

  1. Notion에서 브리프, 대본 또는 데이터 가져오기 (연결된 Notion 앱 또는 scripts/notion_sync.py를 통해) – 워크스페이스 스토리보드나 KPI 테이블에서 작업할 때.
  2. 적절한 Scene 클래스 및 패키지 선택 – 아래 능력 매트릭스(및 references/python-motion-ecosystem.md의 빠른 스택, references/python-animation-library-catalogue.md의 전체 18섹션 카탈로그)를 참고.
  3. 검증된 템플릿에서 시작 (templates/ 폴더 사용) 또는 references/에서 패턴을 조합.
  4. 드래프트 품질로 빠르게 미리보기 (--quality draft) – 전체 60fps 렌더링 전에 타이밍, 레이아웃, 카메라 트래킹, 프레이밍을 확인.
  5. 대상 비율로 렌더링 (scripts/render.py 사용, -qh와 사용자 정의 -r 크기를 절대 함께 사용하지 마세요).
  6. 편집, 자막, 리프레임, 믹싱 및 내보내기 (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. 추출된 프레임 시각적 검사 – 최종 .mp4 또는 .gif 제공 전에 ffmpeg로 검사하고, 렌더링 로그를 Notion에 기록.

능력 매트릭스

도메인핵심 클래스, 애니메이션 및 도구참고 / 템플릿
모션 그래픽 및 카메라MovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, 레이어드 글로우 스트로크references/motion-graphics-camera.mdtemplates/motion_graphics_camera.py
스트로크 드로잉 및 모핑Create, DrawBorderThenFill, Write, ShowPassingFlash, VMobject 베지어 경로, SVGMobject, TransformMatchingShapes, Homotopyreferences/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py
UI 로더, 마이크로인터랙션 및 쇼케이스 릴20가지 UI 로더 (바운싱 볼, 리퀴드 필, 스켈레톤/텍스트 쉬머, 오빗/그라디언트 스피너, 체이싱 스퀘어, 배터리), macOS 브라우저 크롬, 프로그레시브 체크리스트, 5×4 동시 Bento 그리드references/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py
관절 캐릭터 및 사용자 정의 배경2-조인트 FK/IK 캐릭터 리그, 스쿼시 & 스트레치, 깜빡임/표정, 멀티-액트 ValueTracker 타임라인, dt-세이프 카메라 트래킹, ImageMobject 종이/책상 씬, 배경 캐릭터 제거references/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py
3D 씬 및 표면ThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjectsreferences/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py
데이터 시각화 및 차트Axes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + always_redraw 실시간 카운터references/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py
코드, 수학, 물리 및 그래프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
하이브리드 사진 / CV 비디오ImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarkerreferences/3d-charts-physics-hybrid.md
광범위한 Python 모션 생태계manim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, 호환성 매트릭스references/python-motion-ecosystem.md
전체 애니메이션 라이브러리 카탈로그18섹션 카탈로그: 수학/설명, 2D/게임, 크리에이티브 코딩, 벡터/SVG, 비디오 편집, CV/AI, 3D, 물리, 차트, GUI, 스토리텔링, 이징, 오디오, 인접 도구, pip 색인, 경고, 목표 조합, 핵심 스택references/python-animation-library-catalogue.md
비디오 편집 및 AI 후반 제작scripts/video_edit.py, detect-scenes (PySceneDetect), auto-captions (faster-whisper), burn-subtitles, smart-reframe (OpenCV 트래킹), beat-markers (librosa), duck-audio, xfade 결합, 혼합 비율 블러 패딩, 투명 .mov 오버레이, GIFreferences/video-editing-postprod.mdscripts/video_edit.py
Notion 제작 워크플로우연결된 Notion 앱 + scripts/notion_sync.py: 검색, 브리프/스토리보드 읽기, DB 메트릭스를 Manim 차트용 JSON으로 내보내기, 스토리보드 페이지 생성, 상태 업데이트, 렌더링된 MP4 메타데이터 기록, 블록 및 댓글 추가references/notion-video-workflows.mdscripts/notion_sync.py

필수 렌더링, 비디오 편집 및 Notion 명령어

Manim 씬 렌더링 (scripts/render.py)

# 빠른 드래프트 미리보기 (절반 해상도 15fps)
python3 scripts/render.py templates/character_rig_scene.py CharacterRigShowcase --quality draft

# 전체 1080p60 16:9 렌더링
python3 scripts/render.py templates/stroke_drawing_morphing.py StrokeMorphShowcase --quality high

# 세로 9:16 (1080x1920), 3:4 (1080x1440), 또는 정사각형 1:1 (1080x1080) 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

# 투명 오버레이 (알파 채널이 있는 .mov, 비디오 합성용)
python3 scripts/render.py lower_third.py LowerThird --transparent --quality high

비디오 편집, 자막, 리프레임 및 조립 (scripts/video_edit.py)

# 비디오 클립 검사
python3 scripts/video_edit.py probe clip1.mp4 clip2.mp4

# 혼합 비율 클립을 0.5초 크로스페이드 및 블러 앰비언트 와이드스크린 패딩으로 결합
python3 scripts/video_edit.py combine clip1.mp4 square_clip.mp4 -o Combined.mp4 --preset landscape --xfade 0.5 --bg-mode blur

# AI 편집: 샷 감지, Whisper 자동 자막, 자막 번인, 스마트 9:16 리프레임, 비트 동기화, 덕킹
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

# 트림, 속도 램핑, 투명 Manim 오버레이 합성, 오디오 먹싱, 또는 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

Notion 동기화 (scripts/notion_sync.py 또는 연결된 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"

중요한 주의사항 (Gotchas)

  • -qh는 사용자 정의 해상도를 초기화합니다: 세로 (1080x1920, 1080x1440) 또는 정사각형 (1080x1080) 씬을 렌더링할 때 -qh를 절대 전달하지 마십시오. 대신 scripts/render.py --preset ... 또는 -r WIDTH,HEIGHT --fps 60을 사용하고, construct() 내부의 self.camera.frame_width / frame_height를 대상 화면 비율과 일치시키십시오.
  • 충돌 없는 설치만 허용: opencv-python + opencv-python-headless, pygame + pygame-ce, manim + manimgl, 또는 pip install ffmpeg를 절대 혼합하지 마십시오 (대신 imageio-ffmpeg / 시스템 바이너리 사용).
  • faster-whisper 오디오 디코딩: WhisperModel.transcribe(...)에 전달하기 전에 항상 ffmpeg를 사용하여 오디오를 16kHz 모노 float32로 사전 디코딩하십시오 (video_edit.py auto-captions는 자동으로 처리).
  • MovingCameraScene 카메라 업데이터: 항상 self.add(self.camera.frame) 다음에 self.camera.frame.add_updater(track_cam)을 호출하고, dt 기반 스무딩 (1.0 - np.exp(-k * dt))을 사용하여 15fps 드래프트와 60fps 렌더링이 동일하게 트래킹되도록 하십시오.
  • 회전하는 캐릭터 엉덩이 앵커: abs(body_spin) > 0.02인 동안에는 절대 hip_h = -min(l_foot_y, r_foot_y)를 계산하지 마십시오. 360°/720° 회전 중에는 고정된 수직 hip_h를 유지하여 머리가 바닥에 닿지 않도록 하십시오.
  • AnnularSector 중심 배치: .move_to(center) 대신 arc_center=center를 직접 전달하십시오 (.move_to()는 경계 상자 중심을 정렬합니다).
  • ffmpeg xfade 타임베이스: xfade를 연결하기 전에 모든 입력 분기 끝(특히 overlay 이후)에 fps=60,settb=1/60,format=yuv420p를 배치하십시오.
  • 3D HUD 및 제로-LaTeX 축: ThreeDScene에서 2D HUD 요소에 대해 self.add_fixed_in_frame_mobjects(...)를 호출하고, Axes, BarChart, ThreeDAxes에 axis_config={"label_constructor": Text}를 전달하십시오.

관련 스킬