Skip to content

FFmpeg Mac

Garon edited this page Feb 3, 2026 · 3 revisions

FFmpeg Install Help for Mac

If you drag a clip into Glimpse and see a message pop up that says something like:

"FFmpeg is required to import video files…"
– or –
"Audio decode failed…"

…it just means Glimpse can't find a helper program called FFmpeg on your Mac.

Think of FFmpeg as a translator that lets Glimpse read almost any video or audio format. FFmpeg is only used when importing files that can't be natively converted using Glimpse's built-in tools.

Below are two ways to get it installed.


Option 1 – The one-copy-paste way (uses Homebrew)

Homebrew is a free "app installer" that lives in your Terminal.

If you've never used it, open Terminal (spotlight-search "terminal") and paste this line:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

It will ask for your Mac password—that's normal.

When it finishes (it can take a minute or two), paste the next line:

brew install ffmpeg

After the text stops scrolling, quit Terminal, restart Glimpse, and try the import again.


Option 2 – The "download a file" way (no Homebrew needed)

  1. Go to https://ffmpeg.org/download.html and click the macOS build (look for a green button or "release" section).

  2. Unzip the downloaded folder.

  3. You'll see a file called ffmpeg. Copy it to a folder that's already on your PATH (common choices are /usr/local/bin or ~/bin).

    • Not sure what PATH means? The simplest trick is to put ffmpeg into /usr/local/bin.
    • If that folder doesn't exist yet, create it with:
     sudo mkdir -p /usr/local/bin

Then copy the file:

     sudo cp ~/Downloads/ffmpeg /usr/local/bin/
  1. Restart Glimpse and try importing your file.

Quick check

Open Terminal and type:

ffmpeg -version

If you see a wall of text starting with "ffmpeg version …", you're all set.

If you see "command not found", the file isn't in the right folder yet—go back to step 3 in Option 2.


Still not working?

  • Make sure you restart Glimpse after installing.
  • Run ffmpeg -version in the same Terminal window you use to launch Glimpse (if you open Glimpse from Terminal).
  • If you installed with Homebrew but Glimpse still complains, close and reopen Terminal once—sometimes the PATH needs a refresh.

If the error keeps appearing, open an issue and paste the exact message you see. We're here to help!

Getting Started

Features

Help

Clone this wiki locally