README.md
April 24, 2026 ยท View on GitHub
Overview
Configuration files and scripts I use for mpv, tailored to a generally minimal and straightforward use case.
Notes
- Using
profile=high-quality- Use with a capable dedicated GPU, otherwise use
profile=fastor no profile (default) - You can view profile details with
mpv --show-profile=high-quality
- Use with a capable dedicated GPU, otherwise use
- Hardware decoding enabled
- Using
hwdec=d3d11va(Nvidia GPU, Windows) Usinggpu-api=vulkanandhwdec=nvdec(Nvidia GPU)- Slow startup issue: https://github.com/mpv-player/mpv/issues/13019
- AV1 Codec issue: https://github.com/mpv-player/mpv/issues/17517
- Not included in
auto-safeanymore: https://github.com/mpv-player/mpv/pull/17740
- Using
- Default keybinds are disabled:
input-default-bindings=no- Custom keybinds are set in input.conf
- Matroska ordered chapters is disabled:
ordered-chapters=no [Media]and[Slideshow]auto-profiles are system specific, use as reference or adjust- Some options are Windows OS specific, in use or value
Important
Latest mpv (git/master) is required.
Please review the files before use to understand their contents.
Configuration
- Main [mpv.conf]
- Key bindings [input.conf]
- Context menu [menu.conf]
Scripts
- BoxToWide (Source) [Config] 1
- ModernZ OSC (Source) [Config] 2
- Open-File (Open file dialog; Windows only) (Source) 3
- Pause Indicator Lite (Source) 4
- PiP-Lite (Picture-in-Picture) (Source) 5
- Sponsorblock-minimal (Source)
- Thumbfast (Source) [Config]
- Windows: If you get an error
cannot create mpv subprocessthis https://github.com/po5/thumbfast/issues/154#issuecomment-3437029385 shows how to fix it, which is basically reverting this commit po5/thumbfast@9deb073
- Windows: If you get an error
- ytdlAutoFormat (Source) [Config] 6
Note
Source links lead to the respective repositories of the original authors.
File Locations
- Windows:
%APPDATA%\mpv\orC:\users\USERNAME\AppData\Roaming\mpv\ - Linux:
~/.config/mpv/or/home/USERNAME/.config/mpv/ - Mac:
~/.config/mpv/or/Users/USERNAME/.config/mpv/
๐ mpv/
โ โโโ ๐ input.conf
| โโโ ๐ menu.conf
โ โโโ ๐ mpv.conf
โโโ ๐ fonts/
โ โโโ ๐ modernz-icons.ttf
โ โโโ ๐ Montserrat-Regular.ttf
โ โโโ ๐ Roboto-Regular.ttf
โโโ ๐ script-opts/
โ โโโ ๐ boxtowide.conf
โ โโโ ๐ modernz.conf
โ โโโ ๐ pause_indicator_lite.conf
โ โโโ ๐ pip_lite.conf
โ โโโ ๐ thumbfast.conf
โ โโโ ๐ ytdlautoformat.conf
โโโ ๐ scripts/
โโโ ๐ boxtowide.lua
โโโ ๐ modernz.lua
โโโ ๐ open-file.lua
โโโ ๐ pause_indicator_lite.lua
โโโ ๐ pip_lite.lua
โโโ ๐ sponsorblock_minimal.lua
โโโ ๐ thumbfast.lua
โโโ ๐ ytdlautoformat.lua
Note
More information about files locations can be found here
Footnotes
-
BoxToWideis a script written and maintained by me. โฉ -
ModernZis a fork maintained by me. โฉ -
Open-Fileis a fork maintained by me. โฉ -
Pause Indicator Liteis a script written and maintained by me. โฉ -
PiP-Lite (Picture-in-Picture)is a script written and maintained by me. โฉ -
ytdlAutoFormatis a script written and maintained by me. โฉ