Skip to main content

Animation engine for explanatory math videos.

Project description

logo

CI Documentation Status MIT License Manim Subreddit Manim Discord

Manim is an animation engine for explanatory math videos. It's used to create precise animations programmatically, as seen in the videos at 3Blue1Brown.

NOTE: This repository is maintained by the Manim Community, and is not associated with Grant Sanderson or 3Blue1Brown in any way (though we are definitely indebted to him for providing his work to the world). If you want to study how Grant makes his videos, head over to his repository (3b1b/manim). This is a more frequently updated repository than that one, and is recommended if you want to use Manim for your own projects.

Table of Contents:

Installation

Manim has a few dependencies that need to be installed before it. Please visit the documentation and follow the instructions according to your operating system.

Usage

Here is an example manim script:

from manim import *

class SquareToCircle(Scene):
    def construct(self):
        circle = Circle()
        square = Square()
        square.flip(RIGHT)
        square.rotate(-3 * TAU / 8)
        circle.set_fill(PINK, opacity=0.5)

        self.play(ShowCreation(square))
        self.play(Transform(square, circle))
        self.play(FadeOut(square))

Save this code in a file called example.py. Now open your terminal in the folder where you saved the file and execute

manim example.py SquareToCircle -pl

You should see your video player pop up and play a simple scene where a square is transformed into a circle. You can find some more simple examples in the GitHub repository. Visit the official gallery for more advanced examples.

Command line arguments

The general usage of manim is as follows:

manim-illustration

The -p flag in the command above is for previewing, meaning the video file will automatically open when it is done rendering. The -l flag is for a faster rendering at a lower quality.

Some other useful flags include:

  • -s to skip to the end and just show the final frame.
  • -n <number> to skip ahead to the n'th animation of a scene.
  • -f show the file in the file browser.

For a thorough list of command line arguments, visit the documentation.

Documentation

Documentation is in progress at ReadTheDocs.

Help with Manim

If you need help installing or using Manim, please take a look at the Reddit Community or the Discord Community. For bug reports and feature requests, please open an issue.

Contributing

Is always welcome. In particular, there is a dire need for tests and documentation. For guidelines please see the documentation. This project uses Poetry for management. You need to have poetry installed and available in your environment. You can find more information about it in its Documentation

License

The software is double-licensed under the MIT license, with copyright by 3blue1brown LLC (see LICENSE), and copyright by Manim Community Developers (see LICENSE.community).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

manimce-0.1.0.tar.gz (196.0 kB view details)

Uploaded Source

Built Distribution

manimce-0.1.0-py3-none-any.whl (233.6 kB view details)

Uploaded Python 3

File details

Details for the file manimce-0.1.0.tar.gz.

File metadata

  • Download URL: manimce-0.1.0.tar.gz
  • Upload date:
  • Size: 196.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.2 CPython/3.8.6 Linux/5.9.1-arch1-1

File hashes

Hashes for manimce-0.1.0.tar.gz
Algorithm Hash digest
SHA256 402c0c91efe29375ba2a6306d48147b827922f34a3f5e3bef792829751dce550
MD5 59742a8bbd3177b0744df05e4eb19077
BLAKE2b-256 f9175b538d8350983c9a3baaaaa0345a0def774be463c909f61d56798a275089

See more details on using hashes here.

File details

Details for the file manimce-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: manimce-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 233.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.2 CPython/3.8.6 Linux/5.9.1-arch1-1

File hashes

Hashes for manimce-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2374388e09c24532cdda91152de4b63cc7632d5a4e2fe45cf274e4c1dc09b9fe
MD5 d26d9269d127fa03c5370b7a3b6a548f
BLAKE2b-256 570ac84ab3dc32c4e0ec58c0fa2f4338209b1b4a5e3483b621f3f2b5d0de0e60

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page