explaingit

mikachu/mpv

Analysis updated 2026-07-17 · repo last pushed 2026-07-04

CAudience · developerComplexity · 3/5ActiveLicenseSetup · moderate

TLDR

A free, open-source command-line media player that plays almost any audio or video file using your GPU for high-quality rendering. It targets users who want fine-grained control via keyboard shortcuts and scripts.

Mindmap

mindmap
  root((repo))
  What it does
    Plays any media format
    Command-line interface
    GPU video rendering
    Custom scripts support
  Tech stack
    C language
    GPU shaders
    Keyboard shortcuts
  Use cases
    Local movie library
    Tricky subtitle formats
    Auto skip intros
    Stream external sites
  Audience
    Text-interface users
    Tech-savvy users
    Legacy from MPlayer
  Releases
    Once or twice yearly
    Distro handles patches

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play almost any video or audio file from the command line with keyboard shortcuts.

USE CASE 2

Build custom scripts to auto-skip intro sequences or stream video from external sites.

USE CASE 3

Organize a local movie library with a lightweight player that handles tricky subtitle formats.

What is it built with?

CGPU shadersffmpeg

How does it compare?

mikachu/mpvacc4github/kdenlive-omnifadealichraghi/linux-audio-headers
Stars0
LanguageCCC
Last pushed2026-07-042024-01-08
MaintenanceActiveDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a reasonably capable GPU and modern CPU, older or low-power hardware needs specific settings enabled for smooth playback.

Free to use, modify, and distribute, including commercial use, as long as you keep the copyright notice.

In plain English

mpv is a free, open-source media player that runs from the command line. Instead of a traditional graphical interface with buttons and menus, you typically use it by typing commands or using keyboard shortcuts. It is designed to play almost any audio or video file you throw at it, handling a wide variety of media formats, video codecs, and subtitle types. Under the hood, the player relies heavily on your computer's graphics processor (GPU) to render and scale video smoothly. It uses programmable shaders for video rendering rather than relying on fixed-function hardware, which helps deliver high-quality playback. However, this means the software expects a reasonably capable GPU and modern CPU to run well. If you are running it on older or low-power hardware, the documentation suggests enabling specific settings to keep playback smooth. This tool is primarily aimed at people who are comfortable with text-based interfaces and want fine-grained control over how their media plays. A typical user might be someone organizing a local movie library who wants a lightweight player that handles tricky subtitle formats or unusual video files without trouble. Because it supports user-created scripts, tech-savvy users can also customize the player to automatically skip intro sequences or stream video from external websites. What is notable about the project is its release philosophy. New versions are only published once or twice a year, and the developers do not maintain older versions after a new one is released. Instead, they expect Linux distributions to handle their own bug fixes and patches for older releases. The software is also a descendant of an older, well-known media player project called MPlayer, carrying forward that legacy while modernizing the underlying video rendering technology.

Copy-paste prompts

Prompt 1
Write an mpv config file optimized for a low-power laptop GPU that keeps 1080p playback smooth.
Prompt 2
Create a Lua script for mpv that automatically skips the first 90 seconds of a video when playback starts.
Prompt 3
How do I set up mpv to handle external subtitle files and adjust their timing and size from the keyboard?

Frequently asked questions

What is mpv?

A free, open-source command-line media player that plays almost any audio or video file using your GPU for high-quality rendering. It targets users who want fine-grained control via keyboard shortcuts and scripts.

What language is mpv written in?

Mainly C. The stack also includes C, GPU shaders, ffmpeg.

Is mpv actively maintained?

Active — commit in last 30 days (last push 2026-07-04).

What license does mpv use?

Free to use, modify, and distribute, including commercial use, as long as you keep the copyright notice.

How hard is mpv to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mpv for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.