MPV Media Player Guide
This guide demonstrates how i setup my MPV will all the Configs, Scripts & Keybindings.
Warning
This was setup on
Windows 11, so some changes might be necessary (Like File paths & CLI commands) to make it work on Linux/MacOS.Showcase
Script Breakdown
- autoload - This script automatically loads playlist entries before and after the currently played file.
- autosub - This script uses Subliminal to download subtitles.
- blackout - Turns the screen completely black and pauses on a button press.
- delete_file - This script is used to delete files.
- mpv-menu-plugin - Configurable context menu for mpv on Windows, with additional support for native file dialog and clipboard.
- ModernZ - A fork of ModernX, with built-in support for interactive menus & better UI customization.
- pause-when-minimize - This script pauses playback when minimizing the window, and resumes playback.
- playlistmanager - This script allows you to see and interact with your playlist in an intuitive way.
- thumbfast - High-performance on-the-fly thumbnailer script for mpv.
- mpv-pointer-event - Mouse/Touch input event detection for mpv.
- touch-gestures - Touch gestures for mpv.
- mpv-gallery-view (Playlist View) - Playlist grid view.
- mpv-gallery-view (Contact Sheet) - Contact sheet view.
Fonts
Preferred font for subtitles
OSC Fonts
- ModernZ/Material Design Iconic - Material Design Icons used for ModernZ OSC
- microsoft/fluentui-system-icons - A modified version by Github/Xurdejl
Installing (Windows)
Prerequisites mpv , git & python3 (pip)
Clone the repository into
%APPDATA%foldergit clone https://github.com/ThunderE75/mpv-scripts %APPDATA%\mpvDownload pip/Subliminal for autosub
pip install subliminal
Key Bindings
Miscellaneous Script Keybindings
| Keybinds | Description |
|---|---|
| b | blackout (black screen) |
| 0 ↔ 9 (on Keypad) | Seek to num*10% (YouTube-esque seek) |
Playlist Management
| Keybinds | Description |
|---|---|
| p | Peek current playlist |
| Ctrl ⌃ + → | Next File |
| Ctrl ⌃ + ← | Previous File |
| Shift ⇧ + Enter ⏎ | Show playlist manager console |
| Shift ⇧ + Alt ⎇ + s | Cycle Playlist Sort |
| Shift ⇧ + Alt ⎇ + h | Shuffle current playlist |
| c | Open contact sheet |
| g | Open grid playlist view |
Subtitle Keybinds
| Keybinds | Description |
|---|---|
| v | Toggle Subtitle |
| Ctrl ⌃ + Alt ⎇ + s | Download Subtitles |
| j | Cycle Subtitle |
| z | Reduce subtitle delay (1ms) |
| Shift ⇧ + z | Add subtitle delay (1ms) |
Bulk Delete Files
Files will be deleted only upon exit more info.
| Keybinds | Description |
|---|---|
| Shift ⇧ + Del ⌦ | Mark/Unmark file to be deleted |
| Alt ⎇ + Del ⌦ | Show the list of files marked for deletion |
| Ctrl ⌃ + Shift ⇧ + Del ⌦ | Clear the list of marked files (files will not be deleted) |
Common Default Keybinds
| Keybinds | Description |
|---|---|
| PgUp ⇞ or @ | Next Chapter |
| PgDn ⇟ or ! | Previous Chapter |
| a | Cycle Aspect Ratio |
| s | Screenshot View |
| Shift ⇧ + s | Screenshot Video (without Subtitle) |
Reference: ThunderE75/mpv