mpvconfig

April 25, 2026 · View on GitHub

2024-12-25_23-46-32_598_mpv

My personal mpv config.

Note

Releases of the modernx script are in a seperate repository - see here https://github.com/zydezu/ModernX/releases.

How to Use

Use git clone https://github.com/zydezu/mpvconfig mpv, and place it in the relevant directory. This will be typically located at \%APPDATA%\mpv\ on Windows and ~/.config/mpv/ on Linux/MacOS.

Linux Note

For the clipboard functionality use in copypaste.lua, you many need to install the xclip or wl-clipboard package, depending on your session type.

Flatpak Instructions (from https://github.com/zydezu/mpvconfig/issues/21)

Use mkdir -p ~/.var/app/io.mpv.Mpv/config to make the mpv configuration directory for the first time

cd ~/.var/app/io.mpv.Mpv/config

git clone https://github.com/zydezu/mpvconfig mpv to clone the config files as mpv/

flatpak override --user io.mpv.Mpv --filesystem=host, needed for mpv flatpak to access host filesystem, so screenshots and lyric downloads can be saved

See the Files section in mpv's manual for more information.

2025-07-05_15-15-16_411_ApplicationFrameHost For files with 5.1 or 7.1 surround sound, you may need to set Audio enhancements to Off in the windows sound settings to hear all the audio channels properly.

Script and description	Keybinds
autoloop loops files by default that are smaller than a set duration	None
autolyrics tries to download lyrics and display them for said file	Alt+m - Request lyrics from musixmatch then netease if that fails Alt+n - Request lyrics only from netease Alt+o - Set lyrics start point to the current timestamp (if lyrics need to be synced)
copypaste Copy and paste file paths, URLs and timestamps	Ctrl+c - Copy file path or URL to clipboard Ctrl+v - Paste file path or URL and play it o - Open file location or URL in browser
detectdualsubs Detects if there are two existing subtitles, one being an original script and the other being a translation (eg: English and Japanese subtitles) and displays them both on screen	Ctrl+x - Toggle dual subs on or off
loadaudiotracks Allows multiple audio tracks to be selected and played together	Ctrl+z - Toggle another audio track
modernx a modern OSC for mpv with many additional features	z - Cycle through audio tracks x - Cycle through subtitle tracks p - Pin or unpin the window Tab - Show chapter list Ctrl+s - Shuffle the current playlist For more: See repository
mpvcut allows clipping a segment of a video	z - Mark start segment z (again) - Clip the video Shift+z - Cancel the clip a - Change mode (copy, encode, compress)
screenshotfolder saves screenshots to a designated folder	s - Take a screenshot
selectformat allows you to change the quality of internet videos on the fly	Ctrl+f - Open format menu Use up and down to choose a resolution, and fold and unfold selections with the arrow keys to see more codec options
sponsorblock a fully-featured port of SponsorBlock for mpv	See repository
thumbfast show thumbnails when hovering the progress bar	None
input.conf an input configuration file	- - Decrease subtitle font size + - Increase subtitle font size Scroll wheel - Change volume