mpv Player for Mac: Install, Configure and Use (2027)
Short answer: mpv is a free, open-source, minimal video player that also powers IINA. To get the mpv player on Mac, run brew install mpv and play files from Terminal, or use one of the builds listed on mpv.io. You configure it with a text file at ~/.config/mpv/mpv.conf. If you want mpv’s playback with menus and Finder integration, use IINA instead.
TL;DR
- What it is: a keyboard-driven player and playback engine. No preferences window, no library.
- Current version: mpv 0.42.0 (November 2026).
- Install:
brew install mpv(no app bundle), first-party test builds on GitHub, unofficial stolendata builds, or MacPorts. - Config:
~/.config/mpv/mpv.conf,input.confand ascriptsfolder. - Built on mpv: IINA uses it as its engine. Mediamber embeds libmpv for formats Apple can’t decode.
- Use raw mpv if you like text config and want the lightest possible player.
We make Mediamber, so weigh our take accordingly.
What is mpv?
mpv is an open-source media player that descends from MPlayer and mplayer2. It’s two things at once:
- A player. You run
mpv file.mkv, a window opens, and you control playback with the keyboard. There’s a small on-screen controller, but no menus to speak of and no settings window. - An engine. mpv is also available as libmpv, a library other apps embed to do their decoding and rendering. That’s how IINA and several other players work.
Under the hood mpv uses FFmpeg, so it plays almost every container and codec in common use: MKV, WebM, AVI, MP4, MOV, HEVC, AV1, VP9, FLAC, Opus, DTS and more, with excellent subtitle rendering through libass. It has a strong reputation for video quality, scaling and frame timing, which is why people who care about those things tend to end up on it.
How do I install mpv for Mac?
mpv’s own installation page lists four routes for macOS. Only one is first-party, and it’s aimed at testing.
| Route | What you get | Notes |
|---|---|---|
| Homebrew | mpv command, version 0.42.0 | No app bundle; easiest to keep updated |
| First-party CI builds | Latest development commit | Mainly for testing, may lack some features |
| stolendata builds | Prebuilt macOS download | Unofficial, third-party |
| MacPorts | mpv port | Unofficial, if you already use MacPorts |
Versions are as of November 2026.
The usual way, with Homebrew:
brew install mpv
mpv ~/Movies/example.mkv
Update it later with brew upgrade mpv. Because the formula has no .app, mpv won’t appear in Launchpad or Finder’s Open with menu. You can still drag a file from Finder onto the Terminal window after typing mpv to fill in its path.
If you download a build from a website and macOS refuses to open it, go to System Settings › Privacy & Security and use Open Anyway only if you trust the source.
How do you use mpv on a Mac?
Once a file is playing, everything is on the keyboard. The defaults worth learning first:
| Key | Action |
|---|---|
| Space | Pause and resume |
| ← / → | Seek back or forward 5 seconds |
| ↓ / ↑ | Seek back or forward 1 minute |
| 9 / 0 | Volume down or up |
| m | Mute |
| f | Full screen |
| [ / ] | Slower or faster playback |
| j | Next subtitle track |
| # | Next audio track |
| s | Screenshot |
| i | Stats overlay, including whether hardware decoding is on |
| q | Quit |
| Q | Quit and remember the position |
A few useful command-line forms:
mpv --fs film.mkv # start full screen
mpv --sub-file=film.en.srt film.mkv # load a specific subtitle file
mpv ~/Movies/Season\ 1/ # play a whole folder as a playlist
Where is mpv.conf on Mac?
On macOS, mpv reads its config from the same place as on Linux: ~/.config/mpv/. The mpv manual notes only two macOS differences: the watch-later folder is ~/.config/mpv/watch_later/ and the cache lives in ~/Library/Caches/io.mpv/.
The folder doesn’t exist until you make it:
mkdir -p ~/.config/mpv/scripts
touch ~/.config/mpv/mpv.conf
open -e ~/.config/mpv/mpv.conf
What goes where:
mpv.conf: settings, one per line, the same names as the command-line options without the leading--.input.conf: your own key bindings.scripts/: Lua or JavaScript scripts that add features, such as an alternative on-screen controller.
A small, sensible starting mpv.conf for a Mac:
# Use Apple's hardware decoders where the chip supports the codec
hwdec=auto-safe
# Remember where you stopped in every file
save-position-on-quit=yes
# Don't close the window at the end of a file
keep-open=yes
# Prefer English subtitles and audio when a file has several tracks
slang=en,eng
alang=en,eng
# Load subtitle files whose names roughly match the video
sub-auto=fuzzy
Change the language codes to suit you. Restart mpv after editing; it reads the file at launch.
Which apps are built on mpv?
You may already be using mpv without knowing it.
- IINA is the best-known Mac front-end for mpv. It keeps mpv’s decoding and adds a native interface, preferences, trackpad gestures, picture-in-picture and plugins. Our IINA for Mac review covers it in depth, and IINA vs VLC compares it with the other big free player.
- Mediamber, which we make, embeds an LGPL build of libmpv. It uses Apple’s AVFoundation for files macOS supports natively, such as MP4 and MOV with H.264 or HEVC, and hands everything else to libmpv: MKV, AVI, WebM, AV1 on Macs without AV1 hardware, and ASS or PGS subtitles. That split keeps power use low for Apple formats and still plays the rest.
Mediamber is a different kind of app from mpv. It indexes the folders and drives you choose in place, never copying or moving files, and shows them as a Watch home screen with resume, Movies, TV, Music, a Timeline of every photo and video by month, and a Storage treemap. It needs macOS 14 or later, doesn’t stream to TVs or phones, and won’t play copy-protected discs or iTunes purchases. Free to browse and play after a 7-day trial; Pro is a $4.99 one-time purchase that also unlocks FavTray Pro on one Mac. See Mediamber.
mpv vs IINA vs VLC: which should you use?
Prices and versions are as of November 2026.
| mpv 0.42.0 | IINA 1.5.1 | VLC 3.0.24 | |
|---|---|---|---|
| Interface | Keyboard, text config | Native Mac app | Older cross-platform UI |
| Formats | Very wide (FFmpeg) | Same as mpv | Very wide |
| Finder default | Only with an app build | Yes | Yes |
| Settings | mpv.conf | Preferences window plus mpv options | Large preferences window |
| Oldest macOS | Depends on the build | 12 (11 on Intel) | OS X 10.7.5 |
| Price | Free | Free | Free |
All three play the hard formats that QuickTime can’t, which is the usual reason people install them. See play MKV on Mac and AVI player for Mac for the details of those formats.
Can mpv play music and online video?
Yes to both, with caveats. mpv plays audio files, FLAC included, and mpv --no-video ~/Music/Album/ plays a folder as a playlist in Terminal. There’s no library, album art browser or tag editing, so it’s a quick way to listen, not a music app.
mpv can also open many URLs directly. For sites such as YouTube it relies on yt-dlp, which you install separately (brew install yt-dlp). Only play content you have the right to watch.
Who should use raw mpv?
mpv on its own suits you if:
- You’re comfortable in Terminal and like keeping settings in a text file you can copy between machines.
- You care about video quality options, such as scalers, debanding or colour management, and want direct access to them.
- You want the lightest possible player with nothing running in the background.
- You use scripts to add exactly the features you want and nothing else.
It probably doesn’t suit you if:
- You open videos by double-clicking them in Finder. Use IINA.
- You want a preferences window to change subtitle size or audio language. Use IINA or VLC.
- You want to browse a collection of films, shows and home videos with posters and resume. Use a library app such as Infuse, Kodi or Mediamber.
Bottom line
The mpv player for Mac is the cleanest way to get top-quality playback of almost any file: brew install mpv, add a few lines to ~/.config/mpv/mpv.conf, and learn a dozen keys. Most people, though, are happier with mpv inside a front-end. IINA gives you the same engine as a proper Mac app, and Mediamber uses libmpv as the fallback engine inside a library of your own media. For a wider view of the options, see our best video player for Mac roundup.
Frequently Asked Questions
Is mpv available for Mac?
Yes. mpv runs on macOS, including Apple silicon. The simplest install is brew install mpv, which gives you the mpv command in Terminal but no app bundle. mpv.io also lists first-party test builds on GitHub, unofficial builds from stolendata and a MacPorts port. As of November 2026 the current release is mpv 0.42.0.
Where is mpv.conf on Mac?
On macOS, mpv reads its settings from ~/.config/mpv/mpv.conf in your home folder. The folder doesn't exist until you create it. Key bindings go in ~/.config/mpv/input.conf and Lua or JavaScript scripts in ~/.config/mpv/scripts/. Saved playback positions are kept in ~/.config/mpv/watch_later/.
Is mpv better than IINA?
They play the same files, because IINA is built on mpv. mpv is lighter and configured entirely with text files and the keyboard. IINA adds a Mac interface, a preferences window, trackpad gestures and picture-in-picture. Choose mpv if you like config files; choose IINA if you want menus and Finder integration.
How do I make mpv the default video player on Mac?
Finder's Open with menu needs an app bundle, and the Homebrew mpv formula doesn't include one, so a Homebrew install can't be set as the default. Use a build that comes as an app, or install IINA, which uses the same engine and can be set as the default with Get Info, Open with, Change All.
Does mpv use hardware decoding on Apple silicon?
It can. Add hwdec=auto-safe to mpv.conf, or pass --hwdec=auto-safe on the command line, and mpv uses VideoToolbox for codecs your Mac's chip decodes in hardware, such as H.264 and HEVC, and AV1 on M3 and later. Press i during playback to see whether hardware decoding is active.