KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

mpv-build-macOS

★ 40 Open GitHub ↗

A set of scripts that help build mpv on macOS.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mpv-build-macOS

[![Build & Upload Artifact](https://github.com/m154k1/mpv-build-macOS/actions/workflows/build.yml/badge.svg)](https://github.com/m154k1/mpv-build-macOS/actions/workflows/build.yml)
[![Lint](https://github.com/m154k1/mpv-build-macOS/actions/workflows/lint.yml/badge.svg)](https://github.com/m154k1/mpv-build-macOS/actions/workflows/lint.yml)

A set of scripts that help build [mpv](https://mpv.io) on macOS.

> [!TIP]
> Prebuilt mpv.app can be downloaded from [GitHub Actions](https://github.com/m154k1/mpv-build-macOS/actions/workflows/build.yml).
>
> Look for `mpv.tar.gz` artifact (requires macOS 26 and Apple M1 or newer).

### Requirements

- [Xcode.app](https://developer.apple.com/xcode/)
- [Homebrew](https://brew.sh)

### Build and install

:arrow_right: Make sure Xcode is ready:

```sh
xcodebuild -runFirstLaunch
```

:arrow_right: Clone the repository:

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

:arrow_right: Install dependencies from Homebrew:

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

:arrow_right: Create an installation directory for local packages:

> [!NOTE]
> If you want to use custom installation directory,
> set `PREFIX` environment variable instead.

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

:arrow_right: Fetch sources:

```sh
./fetch all
```

:arrow_right: Build mpv and its dependencies (select an option):

- Install mpv as CLI-only program:

```sh
  ./build-all
  ```

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

```sh
  ./build-all --bundle
  ```

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

:arrow_right: 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].

[Metal Performance HUD]: https://developer.apple.com/documentation/xcode/monitoring-your-metal-apps-graphics-performance

mpv-build-macOS

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README