概要
- Manim は数学動画向けの プログラマブルアニメーションエンジン
- 公式版(ManimGL) と コミュニティ版 の2種類が存在
- 本リポジトリは 3Blue1Brown によるオリジナル版
- インストールや使い方は バージョンごとに注意 が必要
- FFmpeg, OpenGL, LaTeX などの依存関係と Python3.7以上 が必要
ManimGLの概要とバージョンの違い
- Manim は、 数学解説動画 のために設計された 精密なアニメーションエンジン
- 3Blue1Brown が自身の動画用に開発した オリジナルリポジトリ
- 2020年 より開発者コミュニティが コミュニティ版（Community Edition） を分岐
- 安定性向上
- テスト充実
- コミュニティの貢献促進
- 初心者にも始めやすい設計
- どちらのバージョンを使うか 事前に選択 が必要
インストール時の注意点
- 本リポジトリはManimGL（3b1b版）
- pip install manimgl でインストール
- manim や manimlib ではなく manimgl を指定
- Python3.7以上 が必須
- FFmpeg, OpenGL, LaTeX （LaTeXは任意）のインストールが必要
- Linux では Pango とその開発ヘッダーも必要
インストール手順
- 共通手順
- pip install manimgl で直接インストール
- 動作確認: manimgl
- ソースからのインストール
- リポジトリをクローン: git clone https://github.com/3b1b/manim.git
- ディレクトリ移動: cd manim
- 開発モードでインストール: pip install -e .
- サンプル実行: manimgl example_scenes.py OpeningManimExample または manim-render example_scenes.py OpeningManimExample
- Windows
- FFmpeg インストール
- LaTeX （MiKTeX推奨）インストール
- 上記Python手順を実行
- Mac OSX
- Homebrew で FFmpeg, LaTeX をインストール: brew install ffmpeg mactex
- ARMプロセッサの場合は Cairo もインストール: arch -arm64 brew install pkg-config cairo
- Python手順を実行
- Anaconda
- LaTeX インストール後、 conda create -n manim python=3.8
- conda activate manim で環境有効化
- pip install -e . でmanimglインストール
ManimGLの基本的な使い方
- サンプル実行: manimgl example_scenes.py OpeningManimExample
- シンプルなシーンが再生されるウィンドウ表示
- example_scenes.py 内のサンプルで 構文やアニメーション例 を確認可能
- 3b1b/videos リポジトリで 3Blue1Brown動画のコード を参照
- 古い動画コードは最新版と互換性がない場合あり
- README でインタラクティブなワークフローの詳細解説
コマンドラインオプション
- -w: シーンをファイルに書き出し
- -o: ファイルに書き出し結果を自動で開く
- -s: 最終フレームのみ表示
- -so: 最終フレームを画像保存し表示
- -n <number>: シーン内のn番目のアニメーションにスキップ
- -f: 再生ウィンドウをフルスクリーン表示
設定ファイルとカスタマイズ
- custom_config.yml で詳細設定
- 出力先ディレクトリ
- 画像・音声ファイルの参照先
- スタイルや動画品質のデフォルト
- custom_config.yml を任意のディレクトリに追加することで個別カスタマイズ
ドキュメント・参考情報
- 公式ドキュメント: 3b1b.github.io/manim
- 中国語版: docs.manim.org.cn
- manim-kindergarten による追加クラスやサンプル: manim_sandboxリポジトリ
コントリビュート・ライセンス
- コントリビュート は常時歓迎
- コミュニティ版 が最も活発
- テスト・CI も整備
- プルリクエストには 変更理由と効果例 の説明を推奨
- ライセンス: MIT License