manim은(는) 무엇을 하나요?
설치 위치: Manim Community v0.22.1 (manim이 PATH에 있음, typst 추가 기능이 포함된 uv tool 설치), TeX Live와 dvisvgm(Tex/MathTex용), 그리고 Chatterbox Turbo(음성 해설용, ~/.local/opt/chatterbox 아래 자체 venv에 CPU 설치, narration.py로 구동). 씬 파일은 도구 자체의 Python에서 실행되며, 여기에는 numpy, scipy 및 networkx가 포함됩니다. 다른 import는 실패합니다. ManimCE API만 사용하세요. 3Blue1Brown의 manimgl은 별개의 라이브러리이므로, 이 라이브러리용으로 작성된 코드는 여기서 실행되지 않습니다.
스타일
Manim은 정보를 역동적이고 흥미로운 방식으로 제시하기 위한 도구입니다. 만약 당신이 만든 것이 순서도, 스프레드시트, 점 그래프 또는 슬라이드쇼로 쉽게 만들 수 있었다면, 당신은 manim을 올바르게 사용하고 있지 않은 것입니다. 아름다운 것이 더 매력적이고 더 기억에 남습니다. 전문 용어를 피하고, 프레젠테이션을 접근하기 쉽게 유지하세요. 모티프 세트를 정하고 일관되게 유지하세요. 개념은 일관된 시각적 표현을 가져야 합니다. 이야기를 들려주세요. 시작은 이야기의 중간에서 시작하세요. 아이디어와 문제를 기본 원리부터 소개하세요.
단계
-
출력 선택. 정적 그림(레이블이 있는 다이어그램, 플롯, 표 또는 수식)에는 정적 PNG를 사용하세요. 변화나 순서(단계별 유도, 움직이는 점, 변환)를 보여줄 때는 MP4를 사용하세요. GIF는 대상 플랫폼이 비디오를 재생할 수 없을 때만 사용하세요.
-
가장 가까운 예제 찾기. 아래 주제 파일을 열고 상단의 인덱스를 스캔하여 필요한 것과 가장 가까운 예제 1~3개를 읽으세요. 예제를 적용하여 씬을 구성하세요. 해당 예제들의 API 사용법은 이 버전에서 작동하는 것으로 확인되었습니다.
-
씬 작성
/tmp/manim/<slug>/scene.py에 (사용자가 다른 위치를 지정하지 않은 경우). 파일을from manim import *로 시작하고 하나의Scene하위 클래스(MovingCameraScene/ThreeDScene/ZoomedScene– 예제에서 사용하는 경우)를 정의하세요.사물(구름, 서버, 자물쇠, 깃발, 사람, 문서)의 모든 그림은 이 스킬의 라이브러리에서 가져온 아이콘이며, 있는 그대로 사용합니다: icons.py를 씬 옆에 복사하고, 이 스킬의 디렉토리에서
grep -iw <word> assets/index.tsv로 id를 찾은 후(단어가 없으면 동의어 시도)icon(id, color=..., height=...)로 로드합니다.tabler/outline/*및tabler/filled/*는color로 그려진 단색 선 및 채워진 아이콘(Tabler 아이콘)입니다.fluent/*는 자체 색상을 유지하는 풀컬러 이모지(Fluent Emoji, Flat 스타일)입니다. 다이어그램 구조만 Manim의 도형(상자, 화살표, 선, 축, 플롯, 레이블)을 사용하여 직접 그리세요. 각 개념에 하나의 아이콘을 할당하고 모티프 중 하나로 재사용하세요.텍스트를 표시하는 MP4 또는 GIF는 시청자에게 읽기 시간을 제공해야 하며, 검사기가 이를 강제합니다. reading_time.py를 씬 옆에 복사하고
from reading_time import ReadingTime으로 import한 후, 믹스인을 씬 기본 클래스 앞에 배치하세요:class SceneName(ReadingTime, Scene). 텍스트를 숨기거나, 교체하거나, 흐리게 하는 모든play앞에서self.wait_to_read()를 호출하세요. 이 메서드는 각 보이는 텍스트가 화면에 1초 + 단어 수(150 wpm 기준)만큼 표시될 때까지 대기하며, 하나의play로 드러난 모든 텍스트는 함께 읽힙니다.become()대신 새로운 mobject(FadeIn,ReplacementTransform)로 새 단어를 표시하여 시간이 새로 시작되도록 하세요. 대기 중에도 모션은 계속 실행될 수 있습니다: 텍스트가 떠 있는 동안 재생되는 애니메이션 뒤에self.wait_to_read()를 배치하세요.캡션으로 설명하는 MP4는 음성 해설됩니다: 음성이 텍스트를 읽어줍니다. narration.py를 씬 옆에 복사하고
ReadingTime앞에 배치하세요:class SceneName(Narration, ReadingTime, Scene).self.speak(text)는 이전 줄이 끝날 때까지 기다렸다가 다음 줄을 시작하며, 그 뒤에 오는 애니메이션은 음성이 나오는 동안 재생됩니다. 음성이 읽는 캡션을 보여주는play바로 앞에 배치하세요. 캡션은 음성 줄을 단어 그대로 표시하며, 모든 음성 줄에는 캡션이 있습니다: 각 줄을 한 번 작성하고 동일한 문자열을speak와 캡션의Text에 전달하세요. 화면에 표시되는 것과 다르게 발음해야 하는 경우(예: "20"을 "twenty"로), 씬의pronounce딕셔너리에 추가하면 음성만 변경됩니다. 음성 해설 씬에서는 음성이 대기 시간을 설정합니다: 음성 줄이 말해지는 동안 나타나는 텍스트는 내레이터가 말을 마친 후 0.5초 멈춤까지 유지되어야 하며,self.wait_to_read()는 다음 변경 전까지 정확히 그 시간 동안 대기합니다(무음 중에 표시된 텍스트는 단어 수 규칙을 유지합니다). 음성은 차분한 남성 내레이터의 신경망 클론(Chatterbox Turbo)으로, 기술 다이어그램을 설명하는 데 최적화되었습니다. 각 새 줄은 음성 길이의 약 1~3배 시간이 합성에 소요되며(드래프트 스틸 포함),media/voice아래에 캐시되므로 이후 렌더링에서는 변경한 줄만 음성 합성합니다. 각 줄은 읽히기 위한 것이지 읽기 위한 것이 아닙니다. API, TLS, HTTP와 같은 약어는 쓴 대로 잘 읽히며,narration.py는 숫자 뒤의 단위(200 ms), 점으로 구분된 버전(2.4.1) 및k8s를 이미 발음 처리합니다. 다른 기계 문자열은 내레이터가 말하는 방식으로, 다시pronounce를 통해 처리하세요: "2026.11.1711"이 아닌 "seventeen eleven". 경로와 브랜치 이름은 읽지 말고 설명하세요("an auto patches release branch"), 그리고 음성이 잘못 발음하는 단어는 씬의pronounce딕셔너리로 수정하세요({"edgeworker": "edge worker"}).모든 MP4 또는 GIF는 이를 만든 모델을 명명하는 크레딧 카드로 끝납니다. produced_by.py를 씬 옆에 복사하고 믹스인을 가장 먼저 배치하세요:
class SceneName(ProducedBy, Narration, ReadingTime, Scene)(또는 텍스트가 없는 씬의 경우class SceneName(ProducedBy, Scene)), 그리고produced_by를 시스템 프롬프트가 알려주는 자신의 모델 이름으로 설정하세요 (produced_by = "Claude Opus 5.5"). 지침에 모델 이름이 없다면 사용자에게 물어보세요. 씬, 음성 해설 및 읽기 시간 검사가 완료되면 믹스인이 씬을 페이드 아웃하고 마지막 0.5초 동안 카드를 유지합니다. 정적 렌더링에서는 이를 건너<0xEB><0x9B><0x84>니다. -
드래프트 및 확인. 저화질 스틸을 렌더링하고 PNG를 읽으세요:
cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py SceneName # -> media/images/scene/draft.png애니메이션의 경우 주요 순간도 확인하세요:
-s -n 0,K는 애니메이션 K(0부터 시작, 각self.play및self.wait가 하나씩 카운트) 이후에 중지하고 해당 프레임을 저장합니다. 프레임은 약 14.2 × 8 유닛이며 원점을 중심으로 합니다. 확인한 모든 프레임이 프레임 내에 모든 요소를 표시하고, 레이블이 겹치지 않으며, 텍스트를 읽을 수 있을 때까지 수정하고 다시 렌더링하세요.텍스트를 너무 빨리 제거하는 씬은
ReadingTimeError와 함께 실패하며, 각 텍스트, 나타난 시간, 표시된 시간 및 필요한 시간이 나열됩니다. 나열된 각 변경 전에self.wait_to_read()를 추가하세요. 타이밍이 수정되기 전에 드래프트 프레임을 보려면 명령어 앞에MANIM_READING_TIME=warn을 붙이세요. 최종 렌더링은 이것 없이 실행되며 통과해야 합니다. -
최종 렌더링.
-qm(720p30)을 사용하세요. 3D 씬은 Cairo 렌더러에서 느리므로-ql로 드래프트하세요.manim render -qh --media_dir media -o final scene.py SceneName # -> media/videos/scene/1080p60/final.mp4 (GIF의 경우 --format gif 추가; PNG의 경우 -s를 사용하면 media/images/scene/final.png) -
전달. 인터페이스가 미디어를 표시할 수 있을 때(명령어가 Markdown 이미지 구문이 이미지나 비디오를 임베드한다고 명시하는 경우, T3 Code의 경우) 출력을 인라인으로 표시하세요. 출력 파일을 세션의 작업 디렉토리로 복사한 다음, 절대 경로를 사용하여 거기서 임베드하세요 (
; MP4와 PNG 모두 작동합니다). T3 Code는 작업 디렉토리에서만 미디어를 인라인으로 렌더링하므로/tmp를 가리키는 임베드는 일반 링크로 표시됩니다. 일반 터미널과 같이 텍스트만 표시하는 인터페이스에서는 대신 출력 파일의 절대 경로를 제공하세요. 어느 쪽이든 씬 파일 경로도 제공하여 사용자가 수정할 수 있도록 하세요.모든 반복은 전달로 끝납니다. 씬을 변경할 때마다(사용자의 피드백 또는 자체 수정을 위해) 턴을 마무리하기 위해 세트의 모든 비디오를 최종 품질로 다시 렌더링하고(건드리지 않은 것까지) 각각을 6단계와 같이 전달하세요. 스틸과 프레임 캡처는 작업 확인에 도움이 되지만 비디오를 대체하지는 않습니다. 각 라운드마다 고유한 파일 이름을 사용하세요 (
<name>-v2.mp4,<name>-v3.mp4). 이전 메시지가 설명한 버전을 계속 표시할 수 있도록 하기 위함입니다.
주제 파일
각 파일은 파일에 달리 명시되지 않는 한 v0.22.1 문서에서 그대로 가져온 렌더 테스트된 예제를 보유하며, 상단에 인덱스가 있습니다.
- references/basics.md: 위치 지정, 스타일링, 그룹화/배치,
.animate,Transform, 사용자 정의 애니메이션. - references/text-and-math.md:
Text/MarkupText,Tex/MathTex, Typst 수학, 수식 부분 색칠, 방정식 재배열, 글머리 기호 목록, 제목, 코드 블록, 중괄호, 실시간 숫자. - references/plots-and-axes.md:
Axes플롯, 영역 및 리만 합, 도함수/할선, 음함수/매개변수/극곡선, 로그 축, 데이터 선 그래프, 수직선과 평면, 복소 평면, 막대 차트. - references/diagrams-and-geometry.md: 화살표, 레이블이 있는 선/점/도형, 각도, 직각, 강조(둘러싸는 상자, 밑줄, 십자), 벤/부울 도형, 다각형, 점선 윤곽선.
- references/code.md: 구문 강조 코드: 입력, 줄 강조, 토큰 선택, 한 버전에서 다음 버전으로 변형.
- references/graphs-tables-matrices.md: 노드-링크
Graph/DiGraph, 트리, 신경망 계층, networkx 가져오기, 레이아웃 변경, 표, 행렬, 행렬식, 평면의 선형 변환. - references/animation-and-motion.md: 업데이터,
ValueTracker,always_redraw, 추적 경로, 변환 변형,MoveToTarget/Restore,Succession/LaggedStart타이밍, 강조(Indicate,Circumscribe,Flash), 성장/페이드 인트로, 속도 함수. - references/camera-3d-fields.md: 카메라 이동/확대/축소, 확대 삽입,
ThreeDScene카메라 제어, 3D 표면 및 곡선, 벡터장 및 흐름선. - references/complete-scenes.md: 다단계 설명의 속도를 보여주는 두 개의 더 긴 씬.
API 조회
전체 독스트링이 포함된 설치된 소스는 ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/에 있습니다. 키워드 인자를 추측하기 전에 클래스나 메서드의 시그니처와 옵션을 grep하세요.
주의사항
- LaTeX 문자열은 raw 문자열로 작성하세요 (
r"\frac{a}{b}"). LaTeX 오류는.tex로그를 출력하며, 문제가 있는 줄은 대개 끝 부분에 있습니다. xelatex는 설치되어 있지 않으므로, 이를 필요로 하는TexTemplateLibrary템플릿(예:ctex)은 실패합니다. CJK 텍스트는Text/MarkupText를 사용하세요. 이들은 Pango를 통해 시스템 글꼴로 렌더링됩니다(fc-list로 확인 가능).Typst/MathTypst는Tex/MathTex보다 빠른 대안이며 LaTeX가 필요 없습니다.icon()으로 아이콘을 로드하면 Tabler 아이콘의 색상이 다시 지정됩니다. 해당 파일은currentColor로 그려지며, 일반SVGMobject는 검은색으로 읽습니다.- 검은색으로 그려진 Fluent 아이콘(
fluent/black-flag,fluent/black-cat)은 검은 배경에서 사라집니다. 다른 아이콘을 선택하거나 밝은 도형 위에 설정하세요. - Tabler 선 아이콘은
tabler/outline/server의 표시등과 같이 길이가 0인 선으로 그려진 점을 잃습니다.