macOS

For the sake of simplicity, the following instructions assume that you have the popular package manager Homebrew installed. While you can certainly also install all dependencies without it, using Homebrew makes the process much easier.

If you want to use Homebrew but do not have it installed yet, please follow Homebrew’s installation instructions.

Note

For a while after Apple released its new ARM-based processors (the Apple Silicon chips like the “M1 chip”), the recommended way of installing Manim relied on Rosetta, Apple’s compatibility layer between Intel and ARM architectures. This is no longer necessary, Manim can (and is recommended to) be installed natively.

Required Dependencies

To install all required dependencies for installing Manim (namely: ffmpeg, Python, and some required Python packages), run:

brew install py3cairo ffmpeg

On Apple Silicon based machines (i.e., devices with the M1 chip or similar; if you are unsure which processor you have check by opening the Apple menu, select About This Mac and check the entry next to Chip), some additional dependencies are required, namely:

brew install pango scipy

After all required dependencies are installed, simply run:

pip3 install manim

to install Manim.

Note

A frequent source for installation problems is if pip3 does not point to the correct Python installation on your system. To check this, run pip3 -V: for macOS Intel, the path should start with /usr/local, and for Apple Silicon with /opt/homebrew. If this is not the case, you either forgot to modify your shell profile (.zprofile) during the installation of Homebrew, or did not reload your shell (e.g., by opening a new terminal) after doing so. It is also possible that some other software (like Pycharm) changed the PATH variable – to fix this, make sure that the Homebrew-related lines in your .zprofile are at the very end of the file.

Optional Dependencies

In order to make use of Manim’s interface to LaTeX for, e.g., rendering equations, LaTeX has to be installed as well. Note that this is an optional dependency: if you don’t intend to use LaTeX, you don’t have to install it.

For macOS, the recommended LaTeX distribution is MacTeX. You can install it by following the instructions from the link, or alternatively also via Homebrew by running:

brew install --cask mactex-no-gui

Warning

MacTeX is a full LaTeX distribution and will require more than 4GB of disk space. If this is an issue for you, consider installing a smaller distribution like BasicTeX.

Should you choose to work with some partial TeX distribution, the full list of LaTeX packages which Manim interacts with in some way (a subset might be sufficient for your particular application) is:

amsmath babel-english cbfonts-fd cm-super ctex doublestroke dvisvgm everysel
fontspec frcursive fundus-calligra gnu-freefont jknapltx latex-bin
mathastext microtype ms physics preview ragged2e relsize rsfs
setspace standalone tipa wasy wasysym xcolor xetex xkeyval

Working with Manim

At this point, you should have a working installation of Manim. Head over to our Quickstart Tutorial to learn how to make your own Manimations!