Built on uosc · Apple Liquid Glass design

Your mpv player,
dressed in liquid glass.

A modern, frosted-glass skin for the mpv media player — springy animations, real SVG icons, and a clean YouTube-style layout. Pure Lua. No build step. Just copy and play.

Download latest release Install guide
  • latest release
  • ~1 MB download
  • MIT licensed
  • Windows · macOS · Linux

Live demo

Watch it glide

Frosted controls, spring motion, and the elastic speedometer — playing in real time.

Features

Every pixel, reimagined as glass

The skin restyles the whole on-screen UI into frosted glass pebbles with spring motion and adaptive layouts.

  • Full-width glass control bar

    A frosted progress bar with chapter markers and drag-scrubbing, plus a YouTube-style button row — all wrapped in blurred glass pebbles.

  • Elastic speedometer

    Scroll the speed pebble and a circular gauge springs to life — the needle overshoots and settles like a real cluster, with gold tick flashes.

  • Volume, seek & play/pause OSDs

    Centered frosted HUDs — speaker + percentage for volume, a camera glyph for ±5s seeking, and a YouTube-style play/pause flash on every toggle.

  • Real SVG icon pipeline

    Every glyph is an actual .svg parsed into ASS at startup. Drop a file into assets/icons/ and it's picked up on next launch.

  • Dark & light themes

    Glass tuned for dark video by default, with a lighter variant for bright content. Toggle instantly during playback with Ctrl+T.

  • Small-window & portrait aware

    In narrow or reels-sized windows the bar reshapes itself — non-essential pebbles collapse first, the transport stays anchored, nothing overlaps.

  • Full keyboard control

    Arrow keys or WASD seek and change volume (hold to repeat), number keys and the numpad jump to any percentage of the file, and right-click toggles play/pause — each with its centered OSD.

Screenshots

See it in motion — and at rest

Click any shot to view it full size.

Releases

What's new, version by version

Every release and the features it shipped — newest first. Grab any version from the GitHub Releases page.

  1. v1.2.0

    Latest

    Chapter & playlist navigation

    • Chapter title on hover — hover the progress bar and the section under your cursor names itself, in a readable label just above the bar.
    • Jump-to-chapter pill — a frosted "Jump: <next chapter>" pill sits on the title line, right-aligned, whenever the controls are up; click it to skip to the next chapter.
    • Up-next playlist card — in the final stretch of a file with another video queued, the pill becomes "Next: <video>" and plays the next entry on click. Tune the window with liquid_glass_next_video_threshold.
    • Bolder chapter markers — thicker, alternating red/blue ticks with a contrasting outline, easy to spot over any video.
    Download v1.2.0 (.zip)

  2. v1.1.0

    Full keyboard control

    • Seek from the keyboard — ←/→ or A/D jump ±5 s; hold to keep seeking. Shows the centered Seek OSD.
    • Volume from the keyboard — ↑/↓ or W/S change volume by 5; hold to ramp. Shows the centered Volume OSD.
    • Jump to a position — number keys 0–9 and the numpad KP0–KP9 seek to that percentage of the file (0 = start … 9 = 90%).
    • Right-click to play/pause, with a YouTube-style centered Play/Pause OSD that flashes on every toggle.
    Download v1.1.0 (.zip)

  3. v1.0.0

    Initial release

    • Full-width glass control bar — frosted progress bar with chapter markers and drag-scrubbing, plus a YouTube-style button row in blurred glass pebbles.
    • Elastic speedometer — a circular gauge whose needle springs and overshoots, with gold tick flashes, on scroll over the speed pebble.
    • Volume & seek OSDs — centered frosted HUDs on scroll: speaker + percentage, and a camera glyph with progress for ±5 s seeking.
    • Real SVG icon pipeline — every glyph is an actual .svg parsed into ASS at startup; drop a file in to swap it.
    • Dark & light themes — tuned glass for each, toggled live with Ctrl+T.
    • Small-window & portrait-aware layout and a friendly idle screen when nothing is playing.
    Download v1.0.0 (.zip)

Install

Running in under a minute

No compiler, no dependencies, no build tools. If you already have mpv, you're 30 seconds away.

  1. 1

    Download & unzip the skin

    1. Click the button below to open the Releases page, then download the latest mpv-liquid-glass-vX.Y.Z.zip (about 1 MB).
    2. Find the downloaded .zip — usually in your Downloads folder.
    3. Windows: right-click the zip → Extract All… → Extract. macOS: just double-click it.
    4. You'll get a folder named mpv-liquid-glass. Leave this window open — you'll copy from it in Step 3.
    Get the release
  2. 2

    Open your mpv config folder

    This is the folder where mpv keeps its settings. Open it for your operating system — and if it doesn't exist yet, you'll create it.

    Windows

    1. Press Win + R together to open the Run box.
    2. Type or paste %APPDATA% and press Enter. File Explorer opens the Roaming folder.
    3. Look for a folder named mpv and double-click to open it.
    4. No mpv folder there? Right-click an empty area → New → Folder, name it exactly mpv, then open it.

    macOS

    1. Open Finder, then press Cmd + Shift + G (or menu Go → Go to Folder…).
    2. Paste ~/.config/mpv/ and press Return.
    3. If it doesn't exist, create the .config and mpv folders inside your home folder, then open mpv.

    Linux

    1. Open your file manager or a terminal and go to ~/.config/mpv/ .
    2. If it's not there, create it — in a terminal run mkdir -p ~/.config/mpv.
  3. 3

    Copy the skin in, then restart

    1. Go back to the unzipped mpv-liquid-glass folder from Step 1 and open it.
    2. Select everything inside it — the scripts, fonts, and script-opts folders.
      Windows: click inside the folder, press Ctrl + A to select all, then Ctrl + C to copy.
      macOS: use Cmd + A then Cmd + C.
    3. Switch to your mpv config folder from Step 2, click inside it, and paste with Ctrl + V (Cmd + V on macOS).
    4. If Windows asks to merge or replace files, choose “Replace the files in the destination” / Merge — it's safe to keep any existing mpv.conf.
    5. Fully close mpv and open it again. Play any video — the Liquid Glass skin loads automatically.

    Important: copy the folder's contents (the three folders), not the mpv-liquid-glass folder itself.

Prefer to try it first?

Run mpv against the bundled config without touching your existing setup:

mpv --config-dir=portable_config <your-video>

On GitHub? Star the repo

If you're a developer with a GitHub account, give the repo a star — it's the easiest way to follow future updates, new designs, and releases as they ship.

Star on GitHub

Open source & open to contributions

This skin is free and open source — and very much a work in progress. Got an idea for a new feature? Suggest it. Hit a bug or a glitch? Report it. Just open an issue on GitHub — feature requests are just as welcome as bug reports — or send a pull request if you'd like to build it yourself.

Suggest a feature Report a bug Browse open issues

Make mpv beautiful.

Free, open source, and a 30-second install. Give it a star if you like it.

Download latest release Star on GitHub