A collection of all my mpv scripts.
What are lua scripts? Mpv.io lua documentation
Where should I put them? Unix Windows
How do I use them? Use default keybinds or bind your own in input.conf.
You can find more mpv scripts here:
Some of my scripts require you to edit some settings in the head of lua files to work as intended(usually paths).
Some of my scripts use script-messages for control instead of script-bindings to allow more dynamic commands to be parsed from parameters. You can call script-messages from any other lua script with mp.command("script-message _name_ _arg1_ _arg2_"), mpv-repl by typing script-message _name_ _arg1_ _arg2_, my Menu script or just simply bind them to a key in input.conf H script-message addscrollingsub "hello world".
If you have problems with any of my scripts or have feature requests feel free to open an issue. Contributions are also welcome.
Show playlist in a readable, navigatable and editable format. Cool quirks like url title fetching, filename formatting, saving, loading, shuffling sorting and more included.
Navigate your local system and open directories or files, or add files to your playlist.
A super simple remote controller for mpv
0-dependency configurable command menu.
Take screenshots or convert images with waifu2x upscalling algorithm.
Force open next or previous file in the currently playing files directory.
Keeps track of your watched files locally and loads unseen files from a specified directory into a playlist on keybind.
Appends url from clipboard to playlist.
a script-binding appendURL
Save screenshots in customized directories based on given conditions such as filename pattern match. Gives a lot of freedom for the user for the expense of requiring some lua knowledge with patterns, strings and mpv lua api. Read the lua file settings for more details. If you need any help with this script you can open an issue.
KEY script-message custom-screenshot [subtitles|video|window] - take a custom screenshot
Cycles predefined audio devices. Created this because updating device name on many places was not convenient. Now I can just call script message with headphones/speakers from different places like for example context menu script or an alias startup command and only change them in one place between systems/setups. Set devices to match your system before using with help of mpv --audio-device=help. If you toggle only with key consider using a simple input config like ctrl+A cycle-values audio-device "auto" "openal/device1" "pulse/device2.analog-stereo" instead of this script.
ctrl+A script-binding cycleaudiodevice
argument below is index or nicename of device
KEY script-message setaudiodevice argument - set audio device on runtime
--script-opts=audio=argument - set audio device on startup
Loads a radio playlist/file on keybind with ability to save song names into a file. Requires idle or idle=once.
R script-binding radio-toggle - toggle radio on runtime
r script-binding mark-song
mpv --no-video --idle=once --script-opts=radio-autostart=yes - start radio on startup
Allows you to remove one or consecutive files after they have ended playing. Settings for different eof-reasons and default behaviour are inside lua settings variable. Use with toggling keybind or send command directly with script message.
ctrl+alt+x script-binding toggledeletefile
script-message trashfileonend true true - deletefile[true, false], oneonly[true, false]
mpv --script-opts=trashfileonend-deletefile=yes - open mpv with deletefile enabled
Experimental nicovideo style scrolling subtitles/messages. There seems to be some kind of memoryleak that crashes the script after some time. Also has some hardcoded limits and string transformations that you might want to change. Messages can be sent with script-message from mpv scripts or IPC socket from other sources.
H script-message addscrollingsub "hello world"
$ echo 'script-message addscrollingsub "hello world"' | socat - /tmp/mpvsocket
mp.command("script-message addscrollingsub \"hello world\"")
Do you want to create mpv-scripts with TypeScript? You can use this template to get started.
Scripts in this repo: appendUrl under ISC and rest UNLICENSE. Linked repositories contain their respective licenses.
