mpv icon
Windows · Linux · macOS · FreeBSD · Free
mpv 0.41
↓ Free Download

How to Use Mpv Command Line Player

Start with the command line: `mpv filename.mp4` and your video plays immediately, no bloat, no ads, no settings wizard.

The mpv 0.41 open source media player is built for users who want direct control over playback without a graphical clutter. You don't click menus to find options — you type them. It handles MP4, MKV, WebM, HEVC, VP9, and streams from YouTube or network sources. Whether you're on Windows 10, Linux Ubuntu, macOS, or FreeBSD, the same commands work everywhere.

Getting Started: Installation and Basic Launch

First, get mpv installed on your system. On Windows 10, download the portable or installer version from the official repository. Linux users typically grab it through their package manager (`apt install mpv` on Ubuntu). macOS users can use Homebrew. Once installed, open your terminal or command prompt.

The simplest way to use mpv command line player is to navigate to your video's folder and type:

`mpv video.mkv`

That's it. The player opens in fullscreen and starts playing. Press spacebar to pause, arrow keys to seek, and `q` to quit. No dialog boxes. No "Are you sure?" prompts.

Core Playback Controls and Shortcuts

You control everything from the keyboard. Here are the essentials:

  • Spacebar: Pause/resume
  • Left/Right arrows: Seek backward/forward (5 seconds default)
  • Up/Down arrows: Volume control
  • `>`/`<`: Next/previous in playlist
  • `f`: Toggle fullscreen
  • `s`: Take a screenshot (saved to current directory)
  • `j`: Cycle subtitle tracks
  • `t`: Toggle display of subtitle timing

Customize your keyboard shortcuts by editing the input.conf file in your config directory. This is where the lightweight video player philosophy shines — you define exactly which keys do what.

Streaming and Format Support

One strength of this open source media player: it streams natively. Play YouTube videos directly:

`mpv "https://www.youtube.com/watch?v=VIDEO_ID"`

Network streams work the same way. Want to play an FLAC audio file or a WebM video? It handles both. GPU decoding is enabled by default on most systems, which means HEVC and VP9 playback won't tank your CPU.

Configuration Without the Headache

Create a file named `mpv.conf` in your config directory. On Linux/macOS, that's `~/.config/mpv/mpv.conf`. On Windows, it's `%APPDATA%\mpv\mpv.conf`.

Here's a minimal setup:

```

profile=high-quality

vo=gpu

audio-display=no

sub-auto=fuzzy

```

This enables high-quality scaling, GPU video output, disables on-screen audio metadata, and auto-loads subtitle files with fuzzy matching (so `movie.mkv` finds `movie.srt` even if the names aren't identical).

Advanced Features: Scripts and Filters

How to use mpv command line player at its full power? Add scripts. The script support system lets you automate tasks. Want to pause playback when you alt-tab away? A script handles that. Need frame-by-frame stepping for analysis? Script.

Audio and video filters work from the command line too:

`mpv --af=bass=10 video.mp4` (boost bass)

`mpv --vf=scale=1920:1080 lowres.avi` (upscale video)

Combine filters with `--vf=filter1,filter2`. The color management options let you handle HDR and wide-gamut content correctly.

Pro Tip: Combine multiple files into a playlist without editing text files. Run `mpv *.mkv` in a folder, and it queues them in order. Press `>` to jump to the next file. Use `--shuffle` to randomize playback order.

Performance and Lightweight Design

This command line video tool uses a fraction of the RAM that VLC or other GUI players demand. On older hardware or ARM processors, it's noticeably faster. Minimal dependencies mean fewer crashes from bloated library dependencies.

The learning curve exists — you need to know your keyboard shortcuts and basic command syntax. But once you do, you'll work faster than any mouse-based player.