Fix: Manim "ffmpeg not found" Error | QuantumSketch
Manim's 'ffmpeg not found' error means FFmpeg isn't installed or on PATH. Install FFmpeg, open a new terminal, and run manim checkhealth to confirm.
Manim's "ffmpeg not found" error means FFmpeg isn't installed or isn't on your PATH. Manim renders frames, then calls FFmpeg to encode them into MP4 — install FFmpeg, open a new terminal, and re-render.
The fix by platform
Windows:
winget install Gyan.FFmpeg
macOS:
brew install ffmpeg
Linux (Debian/Ubuntu):
sudo apt install ffmpeg
Then open a new terminal and verify:
ffmpeg -version
manim checkhealth
Why it happens
pip install manim installs the Python package only. FFmpeg is a separate binary that turns Manim's rendered frames into a video and mixes audio. No FFmpeg on PATH → the error. Confirm detection with manim checkhealth.
The #1 cause of "I installed it but it still fails"
A stale terminal. The shell caches PATH at startup. If FFmpeg was added after you opened the terminal, that session can't see it. Close it, open a new one. In VS Code, restart the editor.
| Situation | Fix |
|---|---|
| Just installed FFmpeg | Open a new terminal |
| Windows: downloaded the zip | Add the bin folder to system PATH |
| Works in terminal, not VS Code | Restart VS Code |
| Still nothing | Reinstall, re-check ffmpeg -version |
Verify end to end
manim -pql test.py MyScene
If an MP4 opens, FFmpeg is wired correctly. Drafting tip: -ql keeps renders fast — see why Manim renders slowly.
Never touch FFmpeg again
QuantumSketch bundles FFmpeg, LaTeX, and Manim in the cloud — prompt in, MP4 out, no install. See Install Manim on Windows or macOS if you'd rather run it locally.
Written by Shihab Shahriar Antor · Shahriar Labs
FAQ
Q.Why does Manim need FFmpeg?
Manim renders your animation as a sequence of image frames, then calls FFmpeg to encode those frames into a single MP4 (or GIF, or MOV) video file. FFmpeg also handles mixing in any audio track. Without FFmpeg, Manim can compute frames but can't produce a playable video, so it raises an error or silently fails to output a file. FFmpeg is a separate program from the Manim Python package, which is why installing Manim with pip doesn't install FFmpeg — you add it yourself and make sure it's on PATH.
Q.I installed FFmpeg but Manim still can't find it — why?
Almost always a PATH issue. The terminal session you're running Manim in was started before FFmpeg was added to PATH, so it doesn't see the new entry. Close the terminal completely and open a new one, then run ffmpeg -version to confirm the shell can find it. On Windows, make sure you added FFmpeg's bin folder to the system PATH, not just downloaded the zip. If you use VS Code's integrated terminal, restart VS Code so it reloads the environment.