A machine-readable directory of scripts and other tools for mpv.
A machine-readable directory of scripts and other tools for mpv.
Mpv is a great free and open video player. It has interfaces to extend it with different types of scripts. There is a large number of those scripts, many of them of great use. A wiki page lists them, but browsing this is tedious and installing and updating scripts was not comfortable. Therefore, I created this directory as backend for a new plugin manager.
The main file of this project ist mpv_script_directory.json
. It contains all
the known tools with their metadata. The Information is encoded as JSON:
name
: The name of the toolurl
: The url of the projecttype
: The type of the tool:
javascript
lua script
user shader
vapourSynth scripts
C plugin
other
desc
: A short description of the toolos
: A List of the supported operating systems, an empty list isstars
: The number of stars the project's repository has on github/gitlabsharedrepo
: Boolean, True
if the tool shares a repository with other toolsinstall
: Install method, currently git
, url
and tar
are supported by mplugreceiving_url
: The url that is used to download the script.install_dir
: Name for local directory in that the script will be installed.scriptfiles
: List of files from source that should be installed in$MPV_HOME/scripts
).scriptoptfiles
: List of files from source that should be installed$MPV_HOME/script-opts
).shaderfiles
: List of files from source that should be installed in$MPV_HOME/shaders
).fontfiles
: List of files from source that should be installed in$MPV_HOME/fonts
).executeablefiles
: List of executeable files from source that should~/bin
).install-notes
: Text that will be displayed after install.scrapewiki.py
– in the future the directory should be updated directly andquerystars.py
checks the number of stars the project has, if itThe catalog was scraped and enriched by hand. The installation instructions have been added for the most prominent scripts but many others are still pending. If you want to use a plugin that isn't yet supported, please add the Information and open a PR.
There's a lot to do – please help!
screenshot
, deprecated
, superseededby
, …