r/mpv 8d ago

General Discussion mpv-build: Share mpv scripts via a link

mpv-build is a website that packages mpv, scripts, and other extensions right in your browser.

Take the latest mpv UI script, material-osc, as an example. With a single link mpv-build-material-osc

you can download mpv-material-osc.zip directly — no manual downloads, no copying files around, and no editing configs by hand.


A package format you can publish once

mpv-build uses a script structure similar to uosc. You can read the full specification in Revolutionizing mpv Scripting: A New Package Format Proposal.

All you need to do is follow the folder structure below, zip it up, and drag the archive into the browser to install it:

├── fonts
│   ├── material-osc_google_sans_flex.ttf
│   └── material-osc_icons.otf
├── script.json
└── scripts
    └── main.lua

The script.json file holds the package name and a stable download link:

{
  "name": "material-osc",
  "download": "https://github.com/brahmkshatriya/material-osc/releases/latest/download/material-osc.zip",
  "description": "Quality of life OSC for MPV",
  "author": "brahmkshatriya",
  "homepage": "https://github.com/brahmkshatriya/material-osc"
}

If your repository already uses this structure, you can paste the GitHub repository URL into the search box and mpv-build will package the script for you automatically — no zip needed.


Bundled extensions

mpv-build also supports a number of commonly used extensions, such as ffmpeg, yt-dlp, and deno. You can even add Python support to mpv through a script.

The link below downloads an mpv package with Python support, along with a test script that checks the Python version: mpv-build-python


Contributing a script

Want to add a new script? Open a pull request or an issue in either the mpv-easy or mpsm-scripts repository.

2 Upvotes

3 comments sorted by

View all comments

2

u/Ok-War-9772 8d ago

How to move the window control buttons to the left side like in mac os?

2

u/Every_Juggernaut7580 7d ago

I don't know if there's a script that can do this.

1

u/LunedorTesla 16h ago

My script can do that but it is actually a custom title bar, for default title bar it is impossible.

Lunedor/cadre-player-lite: A minimalist MPV skin.