mpv-build-macOS

A set of scripts that help build mpv on macOS.

Tip

Prebuilt mpv.app from GitHub Actions is available at nightly.link.

Download: mpv-macos-26-arm64.zip (macOS 26.0 & Apple M1 or newer)

Requirements

• Xcode.app
• Homebrew

Build and install

➡️ Make sure Xcode is ready:

xcodebuild -runFirstLaunch

➡️ Clone the repository:

git clone "https://github.com/m154k1/mpv-build-macOS.git"
cd mpv-build-macOS

➡️ Install build dependencies from Homebrew:

xargs brew install --formula < homebrew/build-deps.txt

➡️ Create an installation directory for local packages:

Note

If you want to use custom installation directory, set PREFIX environment variable instead.

sudo mkdir /opt/local
sudo chown "$USER":admin /opt/local
mkdir /opt/local/stow

➡️ Fetch sources:

./fetch all

➡️ Build mpv and its dependencies (select an option):

• Install mpv as CLI-only program:

  ./build-all

• Install CLI and create an app bundle (mpv.app):

  ./build-all --bundle

  The bundle will be placed in mpv.tar.gz.

➡️ Add /opt/local/bin (or $PREFIX/bin) to your $PATH.

Recommended settings

# ~/.config/mpv/mpv.conf
vo=gpu-next
hwdec=videotoolbox
macos-render-timer=feedback

Environment variables

• MVK_CONFIG_LOG_LEVEL=<value> - sets MoltenVK log level:

  • 0 - disabled
  • 1 - error
  • 2 - warning
  • 3 - verbose

• MTL_HUD_ENABLED=1 - enables the Metal Performance HUD.