mpv-build-macOS

A set of scripts that help build mpv on macOS.

Tip

Prebuilt mpv.app can be downloaded from GitHub Actions.

Look for mpv.tar.gz artifact (requires macOS 26 and 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.

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.