Manim は何をしますか?
ここにインストール済み: Manim Community v0.22.1 (manim が PATH に存在、uv tool で typst エクストラを含めてインストール)、さらに TeX Live と dvisvgm (Tex/MathTex 用)、ナレーション用の Chatterbox Turbo (~/.local/opt/chatterbox 以下の独自 venv に CPU インストール、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 *で始め、1 つの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 の図形(ボックス、矢印、線、軸、プロット、ラベル)のみを使用して自分で描画してください。各概念に 1 つのアイコンを与え、モチーフの 1 つとしてそれを再利用します。MP4 または GIF でテキストを表示する場合は、視聴者に読む時間を与える必要があり、チェッカーがこれを強制します。reading_time.py をシーンの隣にコピーし、
from reading_time import ReadingTimeでインポートし、ミックスインをシーンの基底クラスの前に配置します:class SceneName(ReadingTime, Scene)。テキストを非表示、置換、または暗くするすべてのplayの前にself.wait_to_read()を呼び出します。これにより、表示されている各テキストが 1 秒 + その単語数 / 150 wpm の間画面に表示されるまで待機します。1 つのplayで明らかになったすべてのテキストは一緒に読まれます。新しい単語は、become()ではなく、新しいモブジェクトとして(FadeIn、ReplacementTransform)表示し、その時間を新たに開始します。モーションはホールド中も実行を継続できます。テキストが表示されている間に再生されるアニメーションの後にself.wait_to_read()を配置します。キャプションで説明する MP4 はナレーションも付けられます。声が読み上げます。narration.py をシーンの隣にコピーし、
ReadingTimeの前に配置します:class SceneName(Narration, ReadingTime, Scene)。self.speak(text)は前の行が終了するのを待ってから次の行を開始し、その後のアニメーションはそれが話されている間に再生されます。それが読み上げるキャプションを表示するplayの直前に配置します。キャプションは話された行を一言一句表示し、話されたすべての行にキャプションがあります。各行を 1 回記述し、その同じ文字列を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」のように。パスやブランチ名は読み上げるのではなく説明し(「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 秒間カードを表示します。静止画レンダリングではこれをスキップします。 -
下書きをして確認する。 低品質の静止画をレンダリングし、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は 1 つとしてカウント)の後で停止し、そのフレームを保存します。フレームは約 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: 複数ステップの説明をどのようにペース配分するかを示す 2 つの長めのシーン。
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のライトなど、長さゼロの線として描画されるドットを失います。