User Scripts

User Scripts

Here is a list of scripts that users of mpv have published, adding functionality that is not part of the core mpv player:

Lua

• autocrop - Automatically crop the video by using lavfi's cropdetect filter to detect black bars.

• autodeint- Automatically deinterlace the video by using lavfi's idet filter to detect interlaced content.

• autoload - Automatically load playlist entries before and after the currently playing file, by scanning the directory.

• autosub - Automatically download subtitles using subliminal.

• convert_script - Script to quickly convert and crop videos from within mpv, with a GUI.

• cycle-deinterlace-pullup - Cycle between deinterlacing, pullup (IVTC), and both filters off.

• drc-control- Cycle through DRC (dynamic range compression) modes during runtime.

• excerpt - Allows you to quickly create excerpts from media files, you just have to set begin and end markers.

• fpsadjust - Automatically adjust playback speed to synchronize the video to the display if possible (eg. by adjusting 23.976 Hz to 24 Hz for better compatibility with a 60 Hz display).

• last.fm scrobbler - Sends the information about playing tracks to last.fm, see http://www.last.fm/help/faq?category=99 for more info.

• ontop-playback - Disables the ontop property when pausing, and enables it again when unpausing the video, if it was disabled.

• pause-when-minimize - Pauses the player video when minimizing, and unpauses it when brought up again.

• skipchapters - Automatically skip chapters matching a given list of regular expressions (eg. "OP" or "Opening").

• streamcache - Provides for more network-glitch-robust caching of live streams by adjusting replay speed.

• xrandr - Automatically sets the display refresh rate to the one best suitable for the video played

• youtube-starttime - Seek to the given time if the URL contains a timestamp annotation (eg. #t=1m20s).

If you want to write your own Lua scripts, have a look at the documentation of mpv's Lua interface.

VapourSynth scripts

• mvtools - Use MVTools's BlockFPS function to perform motion interpolation on the video in realtime.

• nnedi3 - Use NNEDI3 to double the resolution of the video. This always performs a single doubling. Note that the vapoursynth-nnedi3 filter is so slow that this practically can't be used in realtime, so it's not much use in practice.

• flash3kyuu - Use flash3kyuu to deband the video, with reasonable (mildly grainy) default settings.

GLSL shaders

• deband (source-shader) - Debanding shader very similar to flash3kyuu_deband.

• banana (post-shaders) - Banana filter. (Also doubles as a grayscale filter if you modify it slightly)