Play complex media files smoothly in the terminal with a free player
If you prefer playing movies and music with a single command in a black window rather than a full-screen graphical interface, this tool is suitable for you. mpv is a free command-line media player that supports various video, audio, and subtitle formats. It uses few system resources due to minimal graphical elements, while handling video rendering and scaling using shaders.
Playback methods based on hardware performance
mpv is developed assuming the latest operating systems and relatively high-performance CPUs and GPUs. Hardware decoding is disabled by default, and if the CPU struggles to process video decoding in real time, you must explicitly enable it using the --hwdec option. When using low-power GPUs or integrated graphics, screen tearing or stuttering may occur, so it is recommended to apply the --profile=fast option to maintain smooth playback. Video output is processed using shaders instead of the GPU's fixed-function hardware, so it is advisable to ensure your graphics drivers are up to date.
Build environment and essential dependencies
Creating a fully featured build requires the meson build system and development files for several external libraries. Core dependencies include gcc or clang, X development headers, audio output headers (alsa, pulseaudio), FFmpeg libraries, libplacebo, zlib, iconv, and libass. When building libass, which is required for subtitle rendering, harfbuzz is essential for accurate rendering of combined characters and non-English text. dav1d is required for AV1 decoding support, and nv-codec-headers must be installed to use NVIDIA hardware decoding on Linux.
Release cycle and maintenance scope
mpv releases based on development status one to two times a year, following a version number format of 0.X.0. The primary purpose of releases is to meet the requirements of Linux distributions, which are expected to apply their own patches to fix bugs. Versions prior to the latest release are not supported and are not maintained. No additional maintenance is provided for released versions, except in cases where security issues are discovered.
Items to check before use
This tool is not designed to run on old hardware or unsupported operating systems, and compatibility is not guaranteed. If it happens to work in an older environment, this is not an intended feature. The license is GPLv2 'or later' by default, and it can be built as LGPLv2.1 'or later' using the -Dgpl=false option. Bug reports and feature requests are handled through the GitHub issue tracker, and those that do not follow the template instructions may be ignored or closed.
