My MPV Config

This is my custom configuration for mpv, a powerful and customizable media player. It's optimized for a smooth playback, and a good default experience. Suitable for Anime watching.

You may want to tweak some options depending on your system, display, or personal preferences.

If you're experiencing issues, try Troubleshooting.

📋 Sources

Configuration based on these excellent guides and setups:

• MPV Manual
• mpv.conf Guide by mpv-player (GitHub)
• thumbfast.conf on GitHub (po5)
• sub-select Wiki on GitHub (CogentRedTester)

✅ Features

• Ignore hidden is disabled for autoload.
• Default OSC disabled, use ModernZ (More modern).
• High-quality video rendering with gpu-next and Vulkan.
• Hardware decoding enabled.
• HDR enabled.
• Automatic language and subtitle preferences (Japanese audio, English subs).
• WEBP loseless quality screenshots saved to ~/Pictures/Screenshots (Linux) or %USERPROFILE%\Pictures\Screenshots (Windows).
• Subtitle with matching audio disabled.
• Subtitle fix timing enabled.
• Custom key bindings for volume, frame-step.
• Hardware decoding enabled for thumbfast.
• Compatible with sub-select for better subtitle stream handling.

💡 Notes

• You may want to adjust alang, slang to your own preferences.
• I also use autoload is recommended to auto-add media files to the MPV playlists.
• sub-select is recommended to auto-pick the best subtitle track. It's especially helpful when dealing with multiple sub streams like signs & songs vs full subs.

🔧 Where to Put These

Place the following files in your mpv config folder:

• mpv/mpv.conf (Linux) or mpv\mpv.conf (Windows) → ~/.config/mpv (Linux) or %APPDATA%\mpv (Windows)
• mpv/input.conf (Linux) or mpv\input.conf (Windows) → ~/.config/mpv (Linux) or %APPDATA%\mpv (Windows)
• mpv/script-opts/thumbfast.conf (Linux) or mpv\script-opts\thumbfast.conf (Windows) → ~/.config/mpv/script-opts (Linux) or %APPDATA%\mpv\script-opts (Windows)
• mpv/script-opts/sub-select.json (Linux) or mpv\script-opts\sub-select.json (Windows) → ~/.config/mpv/script-opts (Linux) or %APPDATA%\mpv\script-opts (Windows)
• mpv/script-opts/autoload.conf (Linux) or mpv\script-opts\autoload.conf (Windows) → ~/.config/mpv/script-opts (Linux) or %APPDATA%\mpv\script-opts (Windows)

💻 My Specs

• Host: MSI Raider GE76 12UGS
• CPU: 12th Gen Intel(R) Core(TM) i7-12700H (20) @ 4.70 GHz
• GPU: NVIDIA Geforce RTX 3070 Ti Laptop GPU
• Memory: 31.10 GiB

⚙️ Troubleshooting

• Enable caching by undoing this commit, GitHub commit. (Helps freezing issues on NTFS). (Downside, uses More System Memory)
• Changing the filesystem. (We recommend EXT4 or BTRFS)