GitPedia

Mpv config

My personal mpv config and user scripts. :)

From dexeonify·Updated June 2, 2026·View on GitHub·

My personal [mpv](https://github.com/mpv-player/mpv) config and user scripts :) The project is written primarily in Lua, first published in 2021. Key topics include: mpv, mpv-config, mpv-osc.

mpv-config

My personal mpv config and user scripts :)

Nothing special, not even any fancy shaders or anything, since I only have an
integrated GPU. This is mainly just for backup and keeping track of changes.

Fonts

Warning
Install my custom-made icon font modernx-osc-icon.ttf
for the OSC icons.

User scripts

  • auto-save-state.lua:
    Periodically saves "watch later" data during playback, rather than only
    saving on quit.

  • crop.lua:
    Crop the video by defining the target rectangle with the cursor.

  • file-browser.lua:
    Navigate through the file system entirely from within mpv and open/append
    files & folders.

  • modernx.lua:
    My own spin on MordenX, with added support
    of po5's thumbfast.lua (see below) and upstream fixes ported from from mpv's
    osc.lua.
    You can view the differences between the upstream/forks here.

  • playlistmanager.lua:
    Create and manage playlists intuitively. Uses playlistmanager-save-interactive.lua
    to manually name playlists on save.

  • reload.lua:
    Provides automatic reloading of videos that didn't have buffering progress
    for some time, keeping the current time position.

  • seek-to.lua:
    Seek to an absolute timestamp specified via keyboard input or
    pasted from clipboard.

  • SmartCopyPaste.lua:
    Add the capability to copy and paste while being smart and customizable.

  • thumbfast.lua:
    High-performance on-the-fly thumbnailer for mpv.

Note
Some of the scripts have been modified to suit my needs. You can see the
exact changes by looking at the commit history for each individual script.

Difference between upstream ModernX

<details> <summary>Expand</summary>

New

  • Add movesub feature
  • Move console when OSC is visible
  • Add script-opts to show OSC on file-loaded and seek
  • Add logarithmic volume control (processvolume in modern)
  • Add replay button at the end of playback (modern#21)
  • Add hover effect to icons
  • Add blur_intensity, osc_color, seekbarfg_color, seekbarbg_color and
    titlefont script-opts to customize OSC

Changes

  • Use Feather icons (outlined, rounded corners) instead of Material Icons
    (solid, sharp corners)
  • Use osc.lua's windows control bar
  • Change default font size for title, tooltip & timecode
  • No translations
  • No support for directional keyboard (ModernX#4)

Improvements

  • More frequent syncing from upstream osc.lua
  • Smarter OSC elements show/hide logic
  • Right-click seeks chapter closer to the clicked position
  • Window controls respect Fitts's law (mpv#9791)
  • Volume bar follow seekbar*_color

Bug fix

  • Working deadzone implementation
  • Fix timecode hitbox when milleseconds are shown (fixed in 583faf0)
</details>

References

Contributors

Showing top 1 contributor by commit count.

View all contributors on GitHub →

This article is auto-generated from dexeonify/mpv-config via the GitHub API.Last fetched: 6/14/2026