uosc

Minimalistic proximity based UI for MPV player.

All UI elements hide and show based on their proximity to cursor. Click on the preview above to see it in action.

Installation

uosc is a replacement for the built in osc, so that has to be disabled first.

In your mpv.conf:

osc=no     # required so that the 2 UIs don't fight each other
border=no  # if you disable window border, uosc will draw
           # its own proximity based window controls

Copy uosc.lua into scripts/ folder.

To configure uosc, create a script-opts/uosc.conf file, or download the one in this repository.

Options

All available options with their default values:

title=no                      # display window title (filename) in no-border mode
progressbar=yes               # show thin discrete progress at the bottom
progressbar_fullscreen=       # defaults to `progressbar`
progressbar_size=4            # progressbar size in pixels
progressbar_size_fullscreen=  # defaults to `progressbar_size`
seekbar_size=40               # seekbar size in pixels
seekbar_size_fullscreen=0     # defaults to `seekbar_size`
min_proximity=60              # element<>cursor proximity below which opacity equals 1
max_proximity=120             # element<>cursor proximity above which opacity equals 0
bar_opacity=0.8               # max opacity of progress and seek bars
bar_color_foreground=FFFFFF   # BBGGRR - BLUE GREEN RED hex code
bar_color_background=000000   # BBGGRR - BLUE GREEN RED hex code

Keybindings

By default, uosc doesn't create any keybinds, but provides commands to bind your preferred keys to. To add a keybind, open your input.conf file and add one on a new line.

For example, this will bind the p key to toggle progress bar:

p  script-binding uosc/toggleprogressbar

Commands

Available commands uosc listens on:

toggleprogressbar

Toggle the thin discrete progress bar.