manim 是做什麼的?
安裝位置:Manim Community v0.22.1(manim 在 PATH 上,以 uv tool 安裝並帶有 typst 擴充),加上 TeX Live 和 dvisvgm 以支援 Tex/MathTex,以及 Chatterbox Turbo 用於旁白(在自有虛擬環境下的 CPU 安裝,位於 ~/.local/opt/chatterbox,由 narration.py 驅動)。場景檔案在工具自帶的 Python 環境中執行,該環境包含 numpy、scipy 和 networkx;其他匯入會失敗。僅使用 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 <單詞> assets/index.tsv來尋找 ID(如果找不到,可嘗試同義詞),然後使用icon(id, color=..., height=...)來載入它。tabler/outline/*和tabler/filled/*是使用color繪製的單色線條和實心圖示(Tabler Icons);fluent/*是保留自身顏色的全彩表情符號(Fluent Emoji,扁平風格)。僅使用 Manim 的形狀(如方塊、箭頭、線條、軸、圖形和標籤)來繪製圖表的結構。為每個概念指定一個圖示並重複使用它,作為其中一個主題。MP4 或 GIF 若包含文字,必須為觀眾提供閱讀時間,並且有檢查機制會強制執行。將 reading_time.py 複製到場景旁,使用
from reading_time import ReadingTime匯入,並將 mixin 放在場景基底類別之前:class SceneName(ReadingTime, Scene)。在每次隱藏、替換或淡化文字的play之前呼叫self.wait_to_read()。它會保持等待,直到每個可見文字已顯示在螢幕上至少 1 秒,再加上以每分鐘 150 字計算其字數所需的時間,且所有由一個play揭示的文字會被一起計算。應以新的 mobject(FadeIn、ReplacementTransform)顯示新文字,而不是使用become(),這樣它的計時才會重新開始。動畫可以在等待期間繼續進行:將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:例如說 "seventeen eleven",而不是 "2026.11.1711"。描述路徑和分支名稱時應說明而非逐字朗讀(例如 "an auto patches release branch"),並透過場景的pronounce字典修正任何語音念錯的單詞(例如{"edgeworker": "edge worker"})。每個 MP4 或 GIF 的最後會有一個製作者卡片,顯示製作的模型名稱。將 produced_by.py 複製到場景旁,並將 mixin 放在所有其他 mixin 之前:
class SceneName(ProducedBy, Narration, ReadingTime, Scene)(對於沒有文字的場景則為class SceneName(ProducedBy, Scene)),並將produced_by設定為你的系統提示所給的模型名稱(例如produced_by = "Claude Opus 5.5")。如果你的指示沒有指定模型名稱,請詢問使用者。當場景、其旁白和閱讀時間檢查都完成後,mixin 會淡化場景並在最後 0.5 秒顯示卡片。靜態渲染會跳過此步驟。 -
草稿與檢查。 渲染低品質的靜態畫面並查看 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
已安裝的原始碼,包含完整的 docstring,位於 ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/。在猜測關鍵字參數之前,請使用 grep 搜尋類別或方法的簽名和選項。
注意事項
- 將 LaTeX 字串寫為原始字串(
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上的指示燈。