A collection of scripts I have written for mpv over the years. Small ones are kept in this repository, larger ones have their own. Please keep in mind that not all of these scripts are maintained, and some of these were experiments which didn't pan out. Nevertheless, feel free to submit issues if something breaks, and if you have any interesting script ideas feel free to make a suggestion in the discussions tab.
Sends commands to nircmd (windows only) on playback finish. Commands include sleep, hibernate, shutdown, lock. Full list is in the file
Uses nircmd (windows only) to change the resolution and refresh rate of the monitor to match the playing video. Saves the original monitor resolution and reverts changes on exit and when hotkey is pressed. Full description in file.
Creates an scrollable list of chapters to allow more granular chapter selection. Requires scroll-list
Sends an input command after a specified delay. I suggest using the newer delay-command.lua instead. This script is deprecated.
Automatically scans the directory of the currently loaded file and loads any valid cover art into mpv as additional video tracks. Has options for selecting what file names and types are considered valid.
Cycles through a series of commands on a keypress. Each iteration of the cycle can contain as many commands as one wants. Syntax details are at the top of the file.
Cycles through a list of profiles sent via a script message and prints the profile-desc to the OSD. More details at the top of the file
An extremely simple script which executes an input.conf command only after a set delay.
Automatically applies profiles when the mpv window is moved to a new display
A simple script designed for windows that saves the name of the monitor that mpv is using into
the display_name field of the shared_script_properties and user-data properties.
This means that one can use conditional auto profiles with the name of the monitor.
This is necessary on windows because the default display names that mpv uses
are in the form \\.\DISPLAY#, which are completely useless for setting persistent profiles
as the numbers can change between boots or display configurations.
This script uses the lsdvd commandline utility to allow users to view and select titles for DVDs from directly within mpv. The browser is interractive and allows for both playing the selected title, or appending it to the playlist. It is designed to be used stand-alone, or as an addon for file-browser. It also has automatic playlist support for DVDs.
Prints a message on the OSD if editions are found in the file, and temporarily switches the osd-playing-message to the editions-list property when switching. This makes it easier to tell the number and names while navigating editions.
A universal no-dependency file browser that uses mpv's OSD.
Changes some options when using the ftp protocol for better user experience
Automatically saves the current playlist on exit and allows the user to reload it next time they boot mpv
Switches to a music profile when an audio file is being played and switches back when a non-audio file is played
Automatically converts a onedrive share link into a direct path which mpv can play, Windows only.
Uses mpv-user-input to create an open file dialogue box.
A script to point the player towards an ordered chapters playlist for devices which don't have direct access to their file systems.
Prints a pause icon in the middle of the screen when mpv is paused
shuffles the playlist and moves the current file to the start of the playlist
Parses a script-opt and sends it as a command. Allows input commands to be sent via profiles.
An API that provides scripts with a universal interface for reading text files. This allows scripts to easily read network files over a variety of protocols.
A script for saving m3u playlists based on mpvs current internal playlist. Users can set the name and directory to save the file in the initial script message, or can enter custom strings in the osd.
This script requires mpv-user-input.
A lua module to easily allow the creation of interactive scrollable lists.
Allows in-player searching of keybinds, commands, properties, and options, and displays the results on the OSD.
Requires scroll-list and user-input.
Implements support for Matroska hard segment linking. This is not the same as ordered chapters, which mpv already supports natively.
Prints error messages onto the OSD
Allows you to configure advanced subtitle track selection based on the current audio track and the names and language of the subtitle tracks.
Changes some settings to work well with Syncplay. Currently designed to provide support for local playlists.
Allows you to apply a profile with a timeout, after which another profile is called to revert the changes. Works well with osc layout changes.
An API to allow scripts to request text input from the user over the OSD. The script is built around a modified version of mpv's console.lua, so supports almost all the same keybinds.
A script that allows the mpv user-data property to be set at launch and runtime using config files and script-opts.
This script allows users to set custom variables which can be used in commands and profiles.
A script that allows users to search and open youtube results from within mpv. Requires scroll-list, user-input, curl, and a youtube API key. Alternatively, an Invidious frontend can be used for searches without requiring an API key. See the file header for details.