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}).
워크플로우
- Notion에서 브리프, 대본 또는 데이터 가져오기 (연결된 Notion 앱 또는
scripts/notion_sync.py를 통해) – 워크스페이스 스토리보드나 KPI 테이블에서 작업할 때. - 적절한 Scene 클래스 및 패키지 선택 – 아래 능력 매트릭스(및
references/python-motion-ecosystem.md의 빠른 스택,references/python-animation-library-catalogue.md의 전체 18섹션 카탈로그)를 참고. - 검증된 템플릿에서 시작 (
templates/폴더 사용) 또는references/에서 패턴을 조합. - 드래프트 품질로 빠르게 미리보기 (
--quality draft) – 전체 60fps 렌더링 전에 타이밍, 레이아웃, 카메라 트래킹, 프레이밍을 확인. - 대상 비율로 렌더링 (
scripts/render.py사용,-qh와 사용자 정의-r크기를 절대 함께 사용하지 마세요). - 편집, 자막, 리프레임, 믹싱 및 내보내기 (
scripts/video_edit.py사용 –combine,detect-scenes,auto-captions,burn-subtitles,smart-reframe,beat-markers,duck-audio,mux-audio,overlay,trim,speed,gif,probe). - 추출된 프레임 시각적 검사 – 최종
.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, Homotopy | references/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_mobjects | references/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/HandLandmarker | references/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 오버레이, GIF | references/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()는 경계 상자 중심을 정렬합니다).ffmpegxfade타임베이스: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}를 전달하십시오.