# mpv — Minimalist High-Performance Media Player

> mpv is a free, open-source command-line media player forked from MPlayer and mplayer2. It supports a wide range of video and audio formats, hardware decoding, and scripting via Lua and JavaScript, all with minimal resource usage.

## Install

Save in your project root:

# mpv — Minimalist High-Performance Media Player

## Quick Use
```bash
# Install
sudo apt install mpv        # Debian/Ubuntu
brew install mpv             # macOS
# Play a file
mpv video.mkv
# Stream a URL
mpv https://example.com/stream.m3u8
```

## Introduction
mpv is a media player focused on clean design, performance, and scriptability. Forked from MPlayer/mplayer2, it dropped legacy baggage in favor of modern APIs and a scriptable architecture. It is widely used as both a standalone player and an embedded playback engine in other applications.

## What mpv Does
- Plays virtually any audio and video format through FFmpeg/libav integration
- Supports hardware-accelerated decoding via VAAPI, VDPAU, VideoToolbox, and D3D11
- Provides high-quality video output with configurable shaders, color management, and interpolation
- Allows automation and extension through Lua and JavaScript scripting
- Serves as a library (libmpv) that other applications embed for media playback

## Architecture Overview
mpv uses FFmpeg for demuxing and decoding, then routes output through its own video and audio pipelines. The video output layer supports OpenGL, Vulkan, and platform-native APIs with a shader-based rendering chain. Configuration is file-based (mpv.conf) with per-directory and per-file overrides, and the OSD is rendered via libass.

## Self-Hosting & Configuration
- Place global config in ~/.config/mpv/mpv.conf for persistent settings
- Add custom keybindings in ~/.config/mpv/input.conf to override defaults
- Install user scripts from the mpv wiki (e.g., quality-menu, autoload) into ~/.config/mpv/scripts/
- Enable hardware decoding with --hwdec=auto for reduced CPU usage
- Use profiles in mpv.conf to switch between quality presets (e.g., [low-latency] for streaming)

## Key Features
- Extremely lightweight with no persistent background processes or GUI chrome
- Advanced subtitle rendering with full ASS/SSA support and on-the-fly style overrides
- Protocol support for HTTP, HTTPS, RTSP, and streaming playlists (HLS, DASH)
- OSC (on-screen controller) is optional and fully customizable via Lua
- libmpv API lets developers embed mpv in Electron, Qt, GTK, or any other UI toolkit

## Comparison with Similar Tools
- **VLC** — more beginner-friendly with a full GUI, but heavier on resources and less scriptable
- **MPlayer** — the original ancestor; mpv modernized its codebase and dropped broken legacy features
- **FFplay** — even more minimal but lacks mpv's rendering pipeline, shader support, and scripting
- **IINA** — macOS-only player built on libmpv with a native Cocoa interface

## FAQ
**Q: Does mpv have a GUI?**
A: mpv includes a minimal on-screen controller (OSC). For a full GUI, use frontends like IINA (macOS) or Celluloid (Linux).

**Q: Can mpv play YouTube videos?**
A: Yes, when paired with yt-dlp. Run: mpv https://youtube.com/watch?v=ID and mpv will invoke yt-dlp automatically if installed.

**Q: How do I enable hardware decoding?**
A: Add hwdec=auto to your mpv.conf or pass --hwdec=auto on the command line.

**Q: What is libmpv used for?**
A: libmpv is the embeddable library version of mpv. Applications like IINA, Celluloid, and Stremio use it for media playback.

## Sources
- https://github.com/mpv-player/mpv
- https://mpv.io/


---
Source: https://tokrepo.com/en/workflows/4b117530-3ecd-11f1-9bc6-00163e2b0d79
Author: AI Open Source