dbrookman/build-mpv_silicon.sh

Preparations

Before you can build mpv & mpv.app on an Apple silicon Mac, there's a couple of required dependencies you'll need to install if you haven't already:

Go to System Preferences > Software Update. If there's anything there to update, do it.
If you don't have the Xcode Command Line Tools installed, run xcode-select --install and select Install on the prompt that appears.
If you don't have Homebrew installed, follow the instructions here.
If you don't have all of mpv's dependencies installed, run brew install --build-from-source --only-dependencies mpv && brew install libplacebo.

You'll also need a local copy of the mpv repo, which you can get by running git clone https://github.com/mpv-player/mpv.

You can now run the attached script to build mpv & mpv.app on an Apple silicon Mac yourself. Just make sure to run it from the root directory of the cloned repo.

Static Build

If you want to bundle a static build of mpv.app, perform these steps following the ones above.

Run brew install dylibbundler.
Run the script from the root directory of the cloned repo, but append --static to the command, like ./build-mpv_silicon.sh --static.

Updating

Going forward, you can update your local copy of the repo by running the following commands from its root directory:

git reset --hard
git clean --force -d -x
git pull origin master

ElhemEnohpi · 2024-03-20T11:29:15Z

@miku1958 Yes, it's nice having gpu-next, now I can watch Dolby Vision videos with mpv!

But you don't have to install the whole Vulkan SDK, which is relatively large. You only need the MoltenVK runtime. As noted in the third comment above yours, it can be installed easily from Homebrew. Just do:

brew install molten-vk

Maybe it can be added to the script...

miku1958 · 2024-03-20T11:31:41Z

@ElhemEnohpi Got it thanks

tano70 · 2024-04-10T16:34:52Z

no work today in my MacbookPro M3 when i ran "brew upgrade" and installed mpv 0.37.0.2 from 0.37.0.1 and ffmpeg 7.0 from 6.1.1.7
any solution?

ttforsd · 2024-04-15T20:34:18Z

no work today in my MacbookPro M3 when i ran "brew upgrade" and installed mpv 0.37.0.2 from 0.37.0.1 and ffmpeg 7.0 from 6.1.1.7 any solution?

Same issue on m1 air

ddiaconu21 · 2024-07-23T19:41:32Z

Anyone came across this error?

doriandiaconu@Dorians-MacBook-Pro mpv % ./script.sh --static
+ meson setup build
The Meson build system
Version: 1.5.0
Source dir: /Users/doriandiaconu/mpv
Build dir: /Users/doriandiaconu/mpv/build
Build type: native build
Project name: mpv
Project version: 0.38.0-UNKNOWN
C compiler for the host machine: cc (clang 16.0.0 "Apple clang version 16.0.0 (clang-1600.0.23.1)")
C linker for the host machine: cc ld64 1115.7.2
Host machine cpu family: aarch64
Host machine cpu: aarch64
Program python3 found: YES (/opt/homebrew/bin/python3)
Did not find pkg-config by name 'pkg-config'
Found pkg-config: NO
Did not find CMake 'cmake'
Found CMake: NO
Run-time dependency libavcodec found: NO (tried framework)

meson.build:22:13: ERROR: Dependency lookup for libavcodec with method 'pkgconfig' failed: Pkg-config for machine host machine not found. Giving up.

A full log can be found at /Users/doriandiaconu/mpv/build/meson-logs/meson-log.txt

NathanielH-snek · 2024-07-23T19:55:58Z

Perhaps someone (perhaps myself) could just host a repo with mpv builds? I’m surprised that hasn’t been done yet already actually

nwparker · 2024-07-23T20:09:16Z

Perhaps someone (perhaps myself) could just host a repo with mpv builds? I’m surprised that hasn’t been done yet already actually

That'd be nice.
If you build it on GitHub, I wonder if you could use macos-14 runner since it appears it uses the M1

nwparker · 2024-07-23T20:09:40Z

Anyone came across this error?

doriandiaconu@Dorians-MacBook-Pro mpv % ./script.sh --static
+ meson setup build
The Meson build system
Version: 1.5.0
Source dir: /Users/doriandiaconu/mpv
Build dir: /Users/doriandiaconu/mpv/build
Build type: native build
Project name: mpv
Project version: 0.38.0-UNKNOWN
C compiler for the host machine: cc (clang 16.0.0 "Apple clang version 16.0.0 (clang-1600.0.23.1)")
C linker for the host machine: cc ld64 1115.7.2
Host machine cpu family: aarch64
Host machine cpu: aarch64
Program python3 found: YES (/opt/homebrew/bin/python3)
Did not find pkg-config by name 'pkg-config'
Found pkg-config: NO
Did not find CMake 'cmake'
Found CMake: NO
Run-time dependency libavcodec found: NO (tried framework)

meson.build:22:13: ERROR: Dependency lookup for libavcodec with method 'pkgconfig' failed: Pkg-config for machine host machine not found. Giving up.

A full log can be found at /Users/doriandiaconu/mpv/build/meson-logs/meson-log.txt

Install dependencies. In this case, pkg-config

ddiaconu21 · 2024-07-23T20:30:02Z

pkg-config

Thank you, but it's still not working. Same issues...

doriandiaconu@Dorians-MacBook-Pro mpv % ./script.sh --static   
+ meson setup build
The Meson build system
Version: 1.5.0
Source dir: /Users/doriandiaconu/mpv
Build dir: /Users/doriandiaconu/mpv/build
Build type: native build
Project name: mpv
Project version: 0.38.0-UNKNOWN
C compiler for the host machine: cc (clang 16.0.0 "Apple clang version 16.0.0 (clang-1600.0.23.1)")
C linker for the host machine: cc ld64 1115.7.2
Host machine cpu family: aarch64
Host machine cpu: aarch64
Program python3 found: YES (/opt/homebrew/bin/python3)
Found pkg-config: YES (/opt/homebrew/bin/pkg-config) 0.29.2
Did not find CMake 'cmake'
Found CMake: NO
Run-time dependency libavcodec found: NO (tried pkgconfig and framework)

meson.build:22:13: ERROR: Dependency "libavcodec" not found, tried pkgconfig and framework

A full log can be found at /Users/doriandiaconu/mpv/build/meson-logs/meson-log.txt
doriandiaconu@Dorians-MacBook-Pro mpv % brew install pkg-config
Warning: pkg-config 0.29.2_3 is already installed and up-to-date.
To reinstall 0.29.2_3, run:
  brew reinstall pkg-config

nwparker · 2024-07-23T21:15:22Z

pkg-config

Thank you, but it's still not working. Same issues...

doriandiaconu@Dorians-MacBook-Pro mpv % ./script.sh --static   
+ meson setup build
The Meson build system
Version: 1.5.0
Source dir: /Users/doriandiaconu/mpv
Build dir: /Users/doriandiaconu/mpv/build
Build type: native build
Project name: mpv
Project version: 0.38.0-UNKNOWN
C compiler for the host machine: cc (clang 16.0.0 "Apple clang version 16.0.0 (clang-1600.0.23.1)")
C linker for the host machine: cc ld64 1115.7.2
Host machine cpu family: aarch64
Host machine cpu: aarch64
Program python3 found: YES (/opt/homebrew/bin/python3)
Found pkg-config: YES (/opt/homebrew/bin/pkg-config) 0.29.2
Did not find CMake 'cmake'
Found CMake: NO
Run-time dependency libavcodec found: NO (tried pkgconfig and framework)

meson.build:22:13: ERROR: Dependency "libavcodec" not found, tried pkgconfig and framework

A full log can be found at /Users/doriandiaconu/mpv/build/meson-logs/meson-log.txt
doriandiaconu@Dorians-MacBook-Pro mpv % brew install pkg-config
Warning: pkg-config 0.29.2_3 is already installed and up-to-date.
To reinstall 0.29.2_3, run:
  brew reinstall pkg-config

The message here is pretty clear, libavcodec is not found. Try installing that. In general, follow the above instructions and install all dependencies.
Take no offense, but I suggest you try ChatGPT for assistance as these all seem straightforward enough issues

Akczht · 2024-07-24T04:58:54Z

you have not installed most of the dependencies, in this case ffmpeg, check that all the requires dependencies are properly installed, check here

pxia · 2024-07-24T18:10:19Z

I also created a script for this: https://github.com/pxia/mpv-macos-build

tano70 · 2024-07-26T08:14:06Z

Ho anche creato uno script per questo: https://github.com/pxia/mpv-macos-build

Has anyone tried this script on Mac OS 14.5 and can tell me if it works?

pxia · 2024-07-27T07:50:17Z

@tano70 yes i've built it myself on 14.5

kotique123 · 2024-08-16T02:31:24Z

Works perfectly on Sonoma 14.6.1

hvirta · 2024-09-09T16:42:24Z

Note that the mpv project itself provides automatic "test builds" of mpv for various systems and architectures, including an ARM build for macOS. They can be found here: https://github.com/mpv-player/mpv/actions/workflows/build.yml?query=event:push+branch:master
and are also linked on the project's website here: https://mpv.io/installation/

In my own limited experience the ARM build appears quite stable, even with gpu-next enabled.

joeynotjoe · 2024-09-12T17:47:28Z

@hvirta awesome, thanks for the heads up!

tano70 · 2024-09-17T19:09:50Z

@tano70sì, l'ho costruito io stesso su 14.5

thanks!

alphagumibear · 2024-09-25T08:13:15Z

Hi, can anyone tell me how I would uninstall if I followed the instructions in the main post? is it simply deleting the mpv folder or is there more to it? Thanks

joshkerr · 2024-09-30T14:22:11Z

This worked fine for me on MacOS 15.0.

ElhemEnohpi · 2024-09-30T16:25:52Z

@hvirta - thanks, good to know after so many years we can finally download an Apple Silicon binary, including the application bundle, instead of having to go through all this to compile it! It's working well for me, so far. Btw., the direct link to the latest nightly build, as given at https://mpv.io/installation/ is:

https://nightly.link/mpv-player/mpv/workflows/build/master

@alphagumibear - about uninstalling - apart from the mpv folder, the instructions in the main post involve installing Homebrew, and a number of packages within it. If you want to completely remove Homebrew and all the packages, see: Homebrew/install: 📥 Homebrew (un)installer

Otherwise, you'll probably want to remove libplacebo, the mpv formula's dependencies, and possibly dylibbundler and molten-vk, using the brew uninstall [packagename] command. Uninstalling the mpv dependencies is a bit tricky though, because brew uninstall mpv will just tell you that it's not installed. There may be a better way to do it, but I ended up just doing brew install mpv (which downloaded and installed a lot of things) and then brew uninstall mpv. That removed all the unused dependencies.

alphagumibear · 2024-10-01T18:25:03Z

@hvirta - thanks, good to know after so many years we can finally download an Apple Silicon binary, including the application bundle, instead of having to go through all this to compile it! It's working well for me, so far. Btw., the direct link to the latest nightly build, as given at https://mpv.io/installation/ is:

https://nightly.link/mpv-player/mpv/workflows/build/master

@alphagumibear - about uninstalling - apart from the mpv folder, the instructions in the main post involve installing Homebrew, and a number of packages within it. If you want to completely remove Homebrew and all the packages, see: Homebrew/install: 📥 Homebrew (un)installer

Otherwise, you'll probably want to remove libplacebo, the mpv formula's dependencies, and possibly dylibbundler and molten-vk, using the brew uninstall [packagename] command. Uninstalling the mpv dependencies is a bit tricky though, because brew uninstall mpv will just tell you that it's not installed. There may be a better way to do it, but I ended up just doing brew install mpv (which downloaded and installed a lot of things) and then brew uninstall mpv. That removed all the unused dependencies.

thank you for your response Elhem!

giacomorebonato · 2024-10-18T16:01:14Z

I don't see the OSC anymore and I can't enable it. Do you know what I might miss?

amnah · 2024-11-14T05:30:12Z

I don't see the OSC anymore and I can't enable it. Do you know what I might miss?

it looks like they changed the dependencies with the latest v0.39.0 release. you'll need to rerun step 4 of the instructions:

brew install --build-from-source --only-dependencies mpv && brew install libplacebo

(this will install the new mujs and luajit dependencies)

giacomorebonato · 2024-11-24T15:21:33Z

I needed to install lua and the osc is now back. Thanks!

carys-cc · 2025-05-11T00:31:10Z

With help from AI, enabled libarchive support

#!/usr/bin/env bash

# Builds mpv & mpv.app on Apple silicon Macs with libarchive support.
# Run this script from the root directory of the mpv repo.

# if anything fails, gtfo
set -ex

# Make sure pkg-config is installed
if ! command -v pkg-config &>/dev/null; then
    echo "Installing pkg-config..."
    brew install pkg-config
fi

# Check if libarchive is installed, install if not
if ! brew list libarchive &>/dev/null; then
    echo "Installing libarchive dependency..."
    brew install libarchive
fi

# Get libarchive location from Homebrew
LIBARCHIVE_PREFIX=$(brew --prefix libarchive)
echo "libarchive is installed at: $LIBARCHIVE_PREFIX"

# Setup environment variables so pkg-config can find libarchive
export PKG_CONFIG_PATH="$LIBARCHIVE_PREFIX/lib/pkgconfig:$PKG_CONFIG_PATH"
export LDFLAGS="-L$LIBARCHIVE_PREFIX/lib $LDFLAGS"
export CPPFLAGS="-I$LIBARCHIVE_PREFIX/include $CPPFLAGS"

# Verify pkg-config can find libarchive
if pkg-config --exists libarchive; then
    echo "pkg-config found libarchive:"
    pkg-config --modversion libarchive
    echo "libarchive CFLAGS: $(pkg-config --cflags libarchive)"
    echo "libarchive LIBS: $(pkg-config --libs libarchive)"
else
    echo "ERROR: pkg-config cannot find libarchive"
    echo "Available pkgconfig files in $LIBARCHIVE_PREFIX/lib/pkgconfig:"
    ls -la $LIBARCHIVE_PREFIX/lib/pkgconfig
    exit 1
fi

# Clean previous build if it exists
rm -rf build

# Configure with libarchive support and explicitly specify the path
meson setup build \
    -Dlibarchive=enabled \
    -Dpkg_config_path="$LIBARCHIVE_PREFIX/lib/pkgconfig"

meson compile -C build

# test the binary we just built
./build/mpv --version

./TOOLS/osxbundle.py --skip-deps build/mpv
if [[ $1 == "--static" ]]; then
    dylibbundler --bundle-deps --dest-dir build/mpv.app/Contents/MacOS/lib/ --install-path @executable_path/lib/ --fix-file build/mpv.app/Contents/MacOS/mpv
    # test the app binary to make sure all the dylibs made it okay
    ./build/mpv.app/Contents/MacOS/mpv --version
fi

tano70 · 2025-08-31T09:03:15Z

Ho anche creato uno script per questo: https://github.com/pxia/mpv-macos-build

Your script still works well. I recompiled mpv a few days ago since updates for ffmpeg (version 8) and mpv itself were released, and the version I had previously compiled was no longer suitable as it didn't recognize the new libraries. Do you have any news about an update to the compilation script, or can we still rely on it?

pxia · 2025-08-31T09:44:55Z

@tano70 I believe they solved it already, you can build mpv from git head or wait for 0.41

tano70 · 2025-08-31T09:49:28Z

What do you mean by "compiling mpv from git head?", or "waiting for version 0.41" of your script?

pxia · 2025-08-31T10:12:33Z

change the mpv repo in my script to their git head

	#!/usr/bin/env bash

	# Builds mpv & mpv.app on Apple silicon Macs.
	# Run this script from the root directory of the mpv repo.

	# if anything fails, gtfo
	set -ex

	meson setup build
	meson compile -C build
	# test the binary we just built
	./build/mpv --version

	./TOOLS/osxbundle.py --skip-deps build/mpv
	if [[ $1 == "--static" ]]; then
	dylibbundler --bundle-deps --dest-dir build/mpv.app/Contents/MacOS/lib/ --install-path @executable_path/lib/ --fix-file build/mpv.app/Contents/MacOS/mpv
	# test the app binary to make sure all the dylibs made it okay
	./build/mpv.app/Contents/MacOS/mpv --version
	fi

dbrookman/build-mpv_silicon.sh

Preparations

Static Build

Updating

ElhemEnohpi commented Mar 20, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

miku1958 commented Mar 20, 2024

Uh oh!

tano70 commented Apr 10, 2024

Uh oh!

ttforsd commented Apr 15, 2024

Uh oh!

ddiaconu21 commented Jul 23, 2024

Uh oh!

NathanielH-snek commented Jul 23, 2024

Uh oh!

nwparker commented Jul 23, 2024

Uh oh!

nwparker commented Jul 23, 2024

Uh oh!

ddiaconu21 commented Jul 23, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nwparker commented Jul 23, 2024

Uh oh!

Akczht commented Jul 24, 2024

Uh oh!

pxia commented Jul 24, 2024

Uh oh!

tano70 commented Jul 26, 2024

Uh oh!

pxia commented Jul 27, 2024

Uh oh!

kotique123 commented Aug 16, 2024

Uh oh!

hvirta commented Sep 9, 2024

Uh oh!

joeynotjoe commented Sep 12, 2024

Uh oh!

tano70 commented Sep 17, 2024

Uh oh!

alphagumibear commented Sep 25, 2024

Uh oh!

joshkerr commented Sep 30, 2024

Uh oh!

ElhemEnohpi commented Sep 30, 2024

Uh oh!

alphagumibear commented Oct 1, 2024

Uh oh!

giacomorebonato commented Oct 18, 2024

Uh oh!

amnah commented Nov 14, 2024

Uh oh!

giacomorebonato commented Nov 24, 2024

Uh oh!

carys-cc commented May 11, 2025

Uh oh!

tano70 commented Aug 31, 2025

Uh oh!

pxia commented Aug 31, 2025

Uh oh!

tano70 commented Aug 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pxia commented Aug 31, 2025

Uh oh!

ElhemEnohpi commented Mar 20, 2024 •

edited

Loading

ddiaconu21 commented Jul 23, 2024 •

edited

Loading

tano70 commented Aug 31, 2025 •

edited

Loading