FFmpeg Mac

Quick Issues

• “FFmpeg is required to import video files…”
• “Not a valid audio file.”
• Install FFmpeg
• Quick check
• Still not working?

---

“FFmpeg is required to import video files…”

Glimpse can’t find FFmpeg.
FFmpeg is the helper that lets Glimpse read most video formats.

Fix: Install FFmpeg, then restart Glimpse.

---

“Not a valid audio file.”

The file isn’t actually audio (example: a .txt renamed to .mp3),
or it’s corrupt/unreadable.

Fix: re‑export the file as real audio

---

Install FFmpeg

Option 1 – The automatic way (uses Homebrew)

Open Terminal and paste:

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

When it finishes, paste:

brew install ffmpeg

Quit Terminal, restart Glimpse, and try again.

---

Option 2 – The “manual” way (no Homebrew needed)

1. Go to https://ffmpeg.org/download.html and grab a macOS build.
2. Unzip it.
3. Copy ffmpeg into a PATH folder (e.g. /usr/local/bin).

Create the folder if needed:

sudo mkdir -p /usr/local/bin

Copy the file:

sudo cp ~/Downloads/ffmpeg /usr/local/bin/

Restart Glimpse and try again.

---

Quick check

ffmpeg -version

If you see ffmpeg version …, you’re set.
If you see “command not found,” it isn’t on PATH yet.

---

Still not working?

• Restart Glimpse after installing.
• If you launch Glimpse from Terminal, run ffmpeg -version in that same Terminal.
• After Homebrew installs, close and reopen Terminal once.

Still stuck? Open an issue and paste the exact error message.