Introduction to mpv

mpv is a free media player for the command line. It supports a wide variety of media file formats, audio and video codecs, and subtitle types.

This package is known to build and work properly using an LFS 12.1 platform.

Package Information

mpv Dependencies


ALSA, FFmpeg-6.1.1, libass-0.17.1, libplacebo-6.338.2, Mesa-24.0.1, and PulseAudio-17.0


Optional Input Drivers and Libraries

libdvdcss-1.4.3, libdvdread-6.1.3, libdvdnav-6.1.1, and libbluray

Optional Audio Output Drivers and Libraries

pipewire-1.0.3, SDL2-2.30.0, JACK, and OpenAL

Optional Video Output Drivers and Libraries

libcaca and SVGAlib

Optional (for documentation)


Installation of mpv

Install mpv by running the following commands:

mkdir build &&
cd    build &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -Dx11=enabled       \
            ..                  &&

This package does not come with a test suite.

Now, as the root user:

ninja install


This package installs icon files into the /usr/share/icons/hicolor hierarchy and desktop files into the /usr/share/applications hierarchy. You can improve system performance and memory usage by updating /usr/share/icons/hicolor/index.theme and /usr/share/applications/mimeinfo.cache. To perform the update you must have GTK+-3.24.41 installed (for the icon cache) and desktop-file-utils-0.27 (for the desktop cache) and issue the following commands as the root user:

gtk-update-icon-cache -qtf /usr/share/icons/hicolor &&
update-desktop-database -q

Command Explanations

-Dx11=enabled: allows linking to the X11 libraries.

-Ddvdnav=enabled: enables support for DVD playback.

-Dcdda=enabled: enables support for CD Audio.

-Dsdl2=enabled: enables the usage of SDL2 for audio and video output.

Configuring mpv

Config Files

/etc/mpv/* and ~/.config/mpv/*


Installed Programs: mpv
Installed Libraries: None
Installed Directories: /etc/mpv and /usr/share/doc/mpv

Short Descriptions


is the mpv video player