Manim 数学动画引擎

项目概述

Manim 是一个用于精确编程式动画的引擎，主要面向数学讲解类视频的制作。该项目最初由 3Blue1Brown 作者作为个人项目开发，用于制作其频道中的数学动画视频。2020 年部分开发者将其分叉，形成了社区版（Manim Community/manim），后者更注重稳定性、测试完善与新贡献者友好度。本仓库为 3b1b 维护的 ManimGL 版本。

安装说明

警告：以下安装步骤仅适用于 ManimGL，不可与社区版安装指南混用。请先确认要安装的版本。本仓库对应的 pip 包名为 manimgl，而非 manim 或 manimlib。

系统要求

• Python 3.10 及以上
• FFmpeg（视频编解码）
• OpenGL（图形渲染）
• LaTeX（可选，用于公式排版）
• Linux 平台还需安装 Pango 及其开发头文件

快速安装

# 直接通过 pip 安装
pip install manimgl

# 安装后可直接调用命令行工具
manimgl

源码安装（用于二次开发）

git clone https://github.com/3b1b/manim.git
cd manim
pip install -e .

# 运行示例场景
manimgl example_scenes.py OpeningManimExample
# 或者使用 manim-render
manim-render example_scenes.py OpeningManimExample

Linux (Ubuntu/Debian) 完整流程

# 1. 安装系统依赖
sudo apt update
sudo apt install ffmpeg python3-pip libpango1.0-dev

# 2. 安装轻量级 LaTeX（可选）
sudo apt install texlive-science texlive-fonts-extra texlive-latex-extra

# 3. 克隆并安装
git clone https://github.com/3b1b/manim.git
cd manim
python3 -m pip install -e .

# 4. 验证安装
manimgl example_scenes.py OpeningManimExample

建议使用虚拟环境隔离依赖：

sudo apt install python3-venv
python3 -m venv venv
source venv/bin/activate
python3 -m pip install -e .

Windows

1. 安装 FFmpeg
2. 安装 LaTeX 发行版（推荐 MiKTeX）
3. 克隆仓库并以可编辑模式安装：

git clone https://github.com/3b1b/manim.git
cd manim
pip install -e .
manimgl example_scenes.py OpeningManimExample

macOS

# 1. 通过 Homebrew 安装 FFmpeg 与 LaTeX
brew install ffmpeg mactex

# 2. ARM 架构需要额外安装 Cairo
arch -arm64 brew install pkg-config cairo

# 3. 安装 ManimGL
git clone https://github.com/3b1b/manim.git
cd manim
pip install -e .
manimgl example_scenes.py OpeningManimExample

若 manimgl 命令未找到，需将 pip 安装目录加入 PATH。

Anaconda 安装

conda create -n manim python=3.10
conda activate manim
pip install -e .

使用方式

运行以下命令会弹出一个窗口，播放示例场景：

manimgl example_scenes.py OpeningManimExample

可通过官方示例场景库学习各类动画语法与对象类型；3b1b/videos 仓库则包含 3Blue1Brown 所有视频的源码（部分老视频代码可能与最新版本不兼容）。

常用命令行参数

• -w：将场景渲染输出到文件
• -o：渲染并自动打开结果文件
• -s：跳到末尾，仅显示最终画面；-so 可保存该画面为图片
• -n <number>：跳转到第 n 个动画处
• -f：全屏播放

配置文件

更多配置项位于 custom_config.yml，可指定视频输出目录、图片与音频素材路径，以及默认的样式与画质参数。直接编辑该文件，或在运行目录下放置同名配置文件即可覆盖默认设置。

文档与扩展资源

官方文档地址为 3b1b.github.io/manim。中文文档由社区维护，地址为 docs.manim.org.cn。此外，manim-kindergarten 组织在 manim_sandbox 仓库中整理了若干实用的扩展类与视频源码示例，可供进阶参考。

贡献与许可

欢迎提交 Pull Request，建议在描述中说明改动动机与效果示例。本项目采用 MIT 许可证。