MPV is a free (as in freedom) media player for the command line. It supports a wide variety of media file formats, audio and video codecs, and subtitle types.
Overwrite ~/.config/mpv with contents of portable. Only non-default options have been set for both MPV and extension scripts.
Packages:
- mpv
- ffmpeg
- moltenvk (OSX only)
Update sources with new version (or retrieval date). Apply/update patches if they are still not resolved. Confirm all extensions and keybinds are working properly before updating.
See LUA Scripts and Shaders for additional extensions.
| Script | Version | Purpose |
|---|---|---|
| modernz.lua | 0.3.3 | Modern onsreen controls. |
| thumbfast.lua | 2026-08-06 | High-performance on-the-fly thumbnailer for mpv. |
| quality-menu.lua | 4.2.1 | Change streamed video/audio quality on the fly. |
| sponsorblock_minimal.lua | 2026-08-06 | Automatically skip sponsored ads for streams source project. |
| ytsub.lua | 2026-08-22 | Automatically load captions generated by youtube as subtitles. |
| SmartCopyPaste.lua | 3.2.1 | Paste URL's directly into MPV. |
| reload.lua | 2026-08-07 | Automatic (and manual) reload of stalled streams. |
| pause_indicator_lite.lua | 0.3.3 | Overlay pause/mute icons when toggled. |
| cycle-profile.lua | 2026-08-10 | Cycle through profiles with a single key. |
Install versions from source above, then apply patches in patches/.
| Patch | Pull Request | Purpose |
|---|---|---|
| SmartCopyPaste.lua.patch | 174 | Use native clipboard in MPV 0.40+. |
| SmartCopyPaste.conf.patch | 174 | Use native clipboard in MPV 0.40+. |
Remove patches when the associated pull request has been committed and a new version released.
# Keep empty player open for drag/drop, copy/paste testing.
mpv --force-window --idle
# Write detailed logs and console debugging output.
mpv --log-file=~/Desktop/mpv.log --force-window --idle
# Show keybind list.
mpv -input-keylist
# Test keybinds with console debugging output.
mpv --input-test --force-window --idle
``` bash
# show default options
mpv --list-options # https://github.com/mpv-player/mpv/blob/master/etc/mpv.conf| Repo | Inspirations |
|---|---|
| zabooby | Audio downmix profiles. |
| User recommended configs. |