How to fix the ffmpeg not found error with yt-dlp or youtube-dl

If yt-dlp or youtube-dl tells you ffmpeg is not found when you extract audio, the fix is to install ffmpeg. On a Mac, that’s one command: brew install ffmpeg.

yt-dlp is the actively maintained fork of youtube-dl. Use it for YouTube today: youtube-dl has not had a release since December 2021. The flags in this post work in both.

Here’s how I ran into it. I was using youtube-dl at the time.

I love fan noises while sleeping. My sleep quality totally changed for the better since I started.

I was downloading a fan noise audio track from YouTube to put in the Music app using youtube-dl, like this:

youtube-dl ciD52cwJGCs --extract-audio --audio-format mp3 --prefer-ffmpeg

But after downloading the file, I got the error

ERROR: ffprobe/avprobe and ffmpeg/avconv not found. Please install one.

yt-dlp words it differently: ffprobe and ffmpeg not found. Please install or provide the path using --ffmpeg-location. Same problem, same fix.

To solve this on my Mac I had to run

brew install ffmpeg

It took a while, then I ran the command again and since the file was already downloaded, it was a quick process to get the mp3.

Why does this happen?

yt-dlp on its own only downloads files. It doesn’t convert anything.

YouTube doesn’t serve plain mp3 files. The audio comes in formats like m4a or webm. When you ask for --extract-audio --audio-format mp3, the tool needs something to do the actual conversion, and that something is ffmpeg, a separate program that handles audio and video processing.

That’s why the download itself succeeded, and the error only showed up at the conversion step. A plain yt-dlp <video-id> without the audio extraction flags would have worked fine, but you’d get a video file, not an mp3.

The error message also mentions ffprobe. That’s a companion tool ffmpeg uses to inspect media files. You don’t need to install it separately: the ffmpeg package includes it.

Installing on other systems

On Ubuntu or Debian:

sudo apt install ffmpeg

Once installed, verify it’s available by running:

ffmpeg -version

If that prints version information, yt-dlp will find it too.

Still getting the error after installing?

One thing that can trip you up: ffmpeg must be in your PATH, because yt-dlp looks for it there.

If you installed it some other way, say by downloading a binary into a random folder, the error stays. You can point yt-dlp at the exact location with the --ffmpeg-location flag:

yt-dlp ciD52cwJGCs --extract-audio --audio-format mp3 --ffmpeg-location /opt/ffmpeg/bin

With Homebrew you don’t have to worry about this, since brew puts ffmpeg in your PATH automatically.

Want me to talk about your product? You can sponsor this site.