public-mirrors/3b1b-manim
1
0
Fork 0
mirror of https://github.com/3b1b/manim.git synced 2025-11-14 05:07:47 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Fix docker install instruction

Browse source 
Env Var used in the compose.yml is INPUT_DIR and OUTPUT_DIR

Clarify the meaning of both variables and output message.
Note on -p not working.
This commit is contained in:
Kolloom 2019-06-11 00:49:31 -05:00
parent 1322152391
commit 65c23d9e9f
1 changed files with 11 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
README.md
View file

@ -74,19 +74,24 @@ python3 -m manim example_scenes.py SquareToCircle -pl
### Using Docker ### Using Docker
Since it's a bit tricky to get all the dependencies set up just right, there is a Dockerfile and Compose file provided in this repo as well as [a premade image on Docker Hub](https://hub.docker.com/r/eulertour/manim/tags/). The Dockerfile contains instructions on how to build a manim image, while the Compose file contains instructions on how to run the image. Since it's a bit tricky to get all the dependencies set up just right, there is a Dockerfile and Compose file provided in this repo as well as [a premade image on Docker Hub](https://hub.docker.com/r/eulertour/manim/tags/). The Dockerfile contains instructions on how to build a manim image, while the Compose file contains instructions on how to run the image.
In order to do this with the Compose file, you must set the `INPUT_PATH` In order to do this with the Compose file, you must set the `INPUT_DIR`
environment variable to the directory containing your source code and the environment variable to the directory containing manim repository and the
`OUTPUT_DIRECTORY` environment variable to the directory where you want media `OUTPUT_DIR` environment variable to the directory where you want media to be written.
to be written.
1. [Install Docker](https://docs.docker.com) 1. [Install Docker](https://docs.docker.com)
2. [Install Docker Compose](https://docs.docker.com/compose/install/) 2. [Install Docker Compose](https://docs.docker.com/compose/install/)
3. Render an animation 3. Render an animation
```sh ```sh
INPUT_PATH=/path/to/dir/containing/source/code \ INPUT_DIR=/path/to/dir/containing/source/code \
OUTPUT_PATH=/path/to/dir/for/media \ OUTPUT_DIR=/path/to/output/ \
docker-compose run manim example_scenes.py SquareToCircle -l docker-compose run manim example_scenes.py SquareToCircle -l
``` ```
The command needs to be run as root if your username is not in the docker group.
After running the output will say files ready at `tmp/output/`, which is inside the container. Your OUTPUT_DIR is bind mounted to this `/tmp/output` so any changes made by the container to `/tmp/output` will be mirrored on your OUTPUT_DIR. `/media/` will be created in `OUTPUT_DIR`.
`-p` won't work as manim would look for video player in the container system, which it does not have.
The first time you execute the above command, Docker will pull the image from Docker Hub and cache it. Any subsequent runs until the image is evicted will use the cached image. The first time you execute the above command, Docker will pull the image from Docker Hub and cache it. Any subsequent runs until the image is evicted will use the cached image.
Note that the image doesn't have any development tools installed and can't preview animations. Its purpose is building and testing only. Note that the image doesn't have any development tools installed and can't preview animations. Its purpose is building and testing only.