Clone this wiki locally
No. But there is the OSC (on-screen-controller), which lets you control playback with the mouse. Requires mpv to be compiled with Lua support.
There are some 3rd party GUI frontends listed here.
Tearing is a very annoying artifact that makes it look like the video has a horizontal line across the video. The video isn’t properly joining on that line. The line can be fixed or moving. Sometimes it’s not a line, but a bunch of blocks. It can be unnoticeable if there is no movement, but very apparent if the camera moves e.g. at low speed.
Tearing is generally not something a video player can do anything about. It depends on the hardware, drivers, the video output selected in mpv (VO), and possibly the desktop environment / compositor.
Changing the compositor settings can sometimes help with tearing.
Never seen it tearing.
Whether tearing happens with OpenGL may depend on the backend. Try various with
NAME is the name of the backend.
dxinterop seems to perform best generally, but it will crash randomly with some older buggy Intel drivers.
--vo=direct3d should never tear. (Maybe.)
Nvidia should generally not tear. Sometimes, it tears in windowed mode, but not in fullscreen (solution unknown). There are additional problems on multimonitor systems.
- Try enabling
- Try with and without a compositor.
Try disabling the composite extension in xorg.conf:
Section "Extensions" Option "Composite" "Disable" EndSection
- Set the performance mode to maximum performance. Energy saving often interferes with proper vo_opengl operation, and sometimes even appears to cause tearing.
If your Xorg-server is older than ABI version 23, or your kernel is older than version 4.5, or your nvidia driver is not up to date, then you will inevitably get tearing due to the lack of PRIME buffer synchronisation. You cannot fix this tearing with any of the other methods described on this page. Assume fetal position and cry, or switch to using your Intel GPU instead.
Intel tears out of the box. Intel users on Linux are going to have a pretty bad time.
Try enabling SNA and theUnfortunately, this can cause stability issues - GL applications sometimes randomly crash. Somewhere, there’s a claim that adding
i915.semaphores=1to your kernel parameters fixes the crashes.
- Try disabling SNA by using UXA (on older hardware).
--xv-adaptor=N, and try 0 or 1 for
N. This may fix tearing if the other methods fail, but keep in mind that using Xv with mpv is strongly discouraged.
--vo=vaapi. Although this is Intel’s native video output method, it seems to fix tearing only very rarely.
AMD users on Linux are going to have a pretty bad time.
- If you’re getting tearing in multi-monitor setups, it seems there’s nothing you can do about it. AMD drivers (apparently?) don’t vsync across multiple monitors at all, let alone well.
- You can possibly fix some tearing-related issues by using the
Tear Free Desktop, but this seems to degrade the display to 30 Hz operation and adds a lot of input latency.
- For AMD cards it’s generally a better idea to switch to the free radeon/mesa drivers and take the performance/feature hit, since the drivers provided by AMD are pretty unusable.
I am using NVIDIA G-Sync on Windows and running mpv in fullscreen mode reduces the frame rate of other displays
This is likely caused by the way G-Sync interacts with Windows’ compositor. Using
--opengl-backend=win should fix this because mpv gets an exclusive fullscreen window that way. The compositor unredirects exclusive fullscreen windows and is not forced to run at their frame rate.
The OSC requires Lua support. Install Lua (including development headers) and rebuild mpv.
If you didn’t build mpv yourself, ask the packager to enable Lua.
Also note that the OSC is invisible by default, but it should appear once you move the mouse over the mpv window.
Older ffmpeg versions didn’t support DASH properly, update to ffmpeg to git/HEAD.
Pretty much like anything else, just pass the playlist URL to mpv. Note that you need a link to the actual playlist (
https://www.youtube.com/playlist?list=...), NOT to a video in the playlist (
https://www.youtube.com/watch?v=...&list=...&index=...). You can get that link by clicking on the title of the playlist on the right.
mpv is a command line program and doesn’t provide an actual GUI. You need to start it with a media file. On Windows, you can create a file association with the
Open with… context menu. Also, if you start
explorer.exe, it will enter pseudo-gui mode. For Linux, a
mpv.desktop file is provided.
You can also start mpv with
mpv --player-operation-mode=pseudo-gui. You play files by dropping them on the window.
Check available format of video by youtube-dl:
youtube-dl --list-formats <link>or
youtube-dl -F <link>
youtube-dl -F https://www.youtube.com/watch?v=SYM-RJwSGQ8 [info] Available formats for SYM-RJwSGQ8: format code extension resolution note ... 251 webm audio only DASH audio 149k , opus @160k, 4.29MiB 135 mp4 854x480 480p 1159k , avc1.4d401e, 25fps, video only, 16.02MiB 247 webm 1280x720 720p 1372k , vp9, 25fps, video only, 20.12MiB 136 mp4 1280x720 720p 2318k , avc1.4d401f, 25fps, video only, 30.37MiB 248 webm 1920x1080 1080p 2402k , vp9, 25fps, video only, 35.54MiB 137 mp4 1920x1080 1080p 3770k , avc1.640028, 25fps, video only, 55.70MiB 22 mp4 1280x720 hd720 , avc1.64001F, mp4a.40.2@192k (best) ...Choice format and type
mpv --ytdl-format [format code] https://www.youtube.com/watch?v=SYM-RJwSGQ8For 1280x720:
mpv --ytdl-format 22 https://www.youtube.com/watch?v=SYM-RJwSGQ8You can mix different video+audio:
mpv --ytdl-format [video format code] + [audio format code] linkFor mp4 1080p video (3770k) and webm audio (149k, opus @160k):
mpv --ytdl-format 137+251 https://www.youtube.com/watch?v=SYM-RJwSGQ8
By default, volume is changed by scrolling horizontally. If you want to use vertical scrolling for that (rather than seeking), put this in your
MOUSE_BTN3 add volume 2 MOUSE_BTN4 add volume -2
Run mpv in input test mode:
mpv --input-test --force-window --idle
Generally FFmpeg, simply because it has more features.
Install mpv as an app with Homebrew:
$ brew install mpv --with-bundle $ brew linkapps mpv
dutito associate files with application:
$ brew install duti $ duti -s io.mpv api $ duti -s io.mpv mkv $ duti -s io.mpv mp4
With mpv 0.18.1, volume control was forced to softvol, and the
--softvol option was removed. PulseAudio volume control (as in changing the per-client volume in the server) is not used anymore. The following things change with this as perceived by users with default settings:
- changing volume in mpv now affects only the current mpv instance
- volume is not saved across all instances (though it will be saved for the current instance/media file if you use the watch-later feature)
- volume is not limited to 100% anymore
- you cannot use mpv volume controls to set the volume higher than your current PulseAudio volume settings
It is recommended that you use a separate, non-mpv key binding to control your global volume.
If you want the old behavior, you have to switch you key-bindings manually to the audio output volume controls:
- open your input.conf (see here for default location)
- add the following lines:
9 add ao-volume -2 0 add ao-volume 2
- or replace any occurrences of
- don’t forget that lines starting with
#are commented (the default input.conf has all entries commented)
- note that mpv 0.18.1 had a bug that made PulseAudio “stuck” if the step was
2- this has been fixed in later versions
- options like
--volumecan never influence the server value
- you can do the same with the mute key binding (
You can also grab all volume bindings from the default input.conf to change all
Note this this also works on other audio outputs and platforms. Which kind of volume
ao-volume controls depends entirely on the audio API. Some APIs make it the global system volume, some make it per-client or per-stream private volume.
For technically inclined people: there was also a branch adding change that would have allowed to change all key bindings with a single option, but it hasn’t proven popular so far: https://github.com/mpv-player/mpv/commit/7621a028bf555c9ed0430501bc6eac2fa204114c
In mpv 0.21.0 the default OSC layout was changed to bottombar, along with other settings that worked better with it.
lua-settings/osc.conf text file inside mpv’s configuration directory and use the following settings:
layout=box seekbarstyle=slider deadzonesize=0 minmousemove=3
scalewindowed=1as before with
If you were using those layouts already and want the scale back as it was before 0.22.0, calculate it with
𝑥/1.5 where 𝑥 is the old value. So if are looking for the equivalent to
scalewindowed=1, use these
The mpv youtube-dl wrapper script calls
youtube-dl -J on URLs that begin with http(s). This returns a direct media link from which mpv streams directly. Nothing is downloaded to disk.
See the manual for available options: https://mpv.io/manual/master/#options-ytdl
This is a limitation of the Windows platform. There are two so-called subsystems on Windows: the GUI subsystem and the CLI subsystem. A Windows executable can only use one of them. If a program uses the CLI subsystem, it can attach to the console, print messages there and receive input. However, such a program will always open a console window of its own if it is not already being run from one. A program using the GUI subsystem on the other hand will not attach to the console it is being called from, and control will immediately return to the command prompt. To work around that limitation, mpv has a separate executable, called mpv.com, which uses the CLI subsystem and redirects input and output for mpv.exe. Since Windows looks for executables with the .com suffix first (by default; defined by the %PATHEXT% variable), just typing mpv without a suffix on the command prompt will run mpv.com and you will get console output as expected.