dorkhub
show your thing

awesome-mpv

A curated list of awesome mpv resources.

stax76
★ 2.2k⑂ 54 forksCC0-1.0updated 5 months ago
awesomeawesome-listlibmpvmedia-playermpvmpv-configmpv-playermpv-script
git clone https://github.com/stax76/awesome-mpv.gitstax76/awesome-mpv
README.mdfork it — it’s yours

Awesome mpv Awesome

A curated list of awesome mpv resources.

Table of contents

Media Player

Cross-platform

Windows

MacOS

  • IINA - Based on Swift/Cocoa.

Linux

Android

  • android - Player for Android, based on Kotlin.
  • Kt - Player for Android, based on Kotlin.

Installation/Download

  • Official mpv installation instruction
  • shinchiro GitHub - Daily Windows builds of mpv and libmpv. This is the most popular choice on Windows.
  • shinchiro Sourceforge - Windows builds of mpv and libmpv. The advantage of this choice is that it has old builds for the case of new builds having issues.
  • zhongfly - Windows builds of mpv and libmpv. This choice is very similar to shinchiro GitHub, so it's also a recommendation.
  • Andarwinux - Daily Windows builds of mpv and libmpv including ARM64 architecture.
  • mitzsch - Windows builds of mpv and libmpv.
  • mpsm - mpsm is a mpv script manager, you can install scripts provided by mpsm-scripts, or install any script with added meta info via url.

Documentation

Support

User Script

The most complete/up-to-date list of user scripts can be found in the wiki, the advantage of the following list is that everything is categorized into popular sections, like Subtitles etc.

Menu

  • select - Menu script built into mpv.
  • command_palette - Searchable menu for bindings, playlist, chapters, profiles, all tracks, audio tracks, video tracks, subtitle tracks, secondary subtitle tracks, subtitle lines, commands, properties, options, audio devices, Blu-ray titles, stream quality, aspect ratio, recent files.
  • uosc - Popular OSC with menu.
  • M-x - Searchable and configurable menu to quickly find key bindings and commands.
  • search-page - Searchable and configurable menu to quickly find key bindings, commands, options and properties.
  • search-menu - Searchable and configurable menu to quickly find key bindings, commands, properties, audio/subtitle tracks and playlist entries.
  • mdmenu - Use dmenu (Linux launcher) for selecting audio/subtitle/chapters etc.
  • Tcl/Tk context-menu - Configurable context-menu based on Tcl/Tk (cross-platform).
  • contextmenu - Comprehensive context-menu forked from Tcl/Tk context menu.
  • menu - Configurable on screen menu to run custom commands.
  • osm - Configurable on screen menu to run custom commands.
  • mpvc-tui - Command-line and TUI for mpv.
  • menu - Configurable on screen context-menu.
  • menu-plugin - Win32 context menu, file dialog, clipboard support for mpv on Windows.
  • dyn_menu - Context Menu with support for defining the context menu in input.conf.
  • playlist-kdialog - Use KDE's KDialog or GTK's zenity to show current playlist or select playlist entry.
  • mpvselectmenu - Context-menu inspired by select.lua utilising mpv's input and console script functionality. Uses other scripts (see Requirements).

Playback

  • playlist-manager - Create and manage playlists.
  • trackselect - Select tracks based on their title.
  • chapterskip - Skip chapters based on their title.
  • createchapter - Temporarily mark the current playback position as a chapter so you can seek to it later. Also allows writing current chapters as XML.
  • chapters - Display chapters and allow you to jump to them with a mouse click. (Preview)
  • chapter-list - Interractive chapter-list menu.
  • chapter-make-read - Automatically read an load the namesake external chapter file with extension of CHP. Temporarily mark the current playback position as a chapter so you can seek to it later. Also allows writing current chapters as CHP or XML. Based on createchapter.
  • chapters-menu - List all chapters of current video, search and choose any.
  • betterchapters (update) - Loads the next or previous playlist entry if there are no more chapters in the seek direction.
  • chapters_for_mpv - Add, remove and edit chapters of the currently played media. Chapters you create can be saved into a separate text file and automatically loaded when you open the same media file again.
  • autochapters - Automatically finds chapters for your anime files.
  • chapter-converter - Converts chapter format between YouTube (e.g., "00:10 chapter title") and mpv (FFmpeg metadata).
  • sort_script - Sort directories and files.
  • fastforward - Fast-forward instead of skipping.
  • libunity - Show a nice progress bar on your Linux panel/dock.
  • segment-linking - Supports Matroska hard segment linking.
  • quack - Reduces audio volume temporarily after seeking.
  • control - Various features mainly for controlling playback.
  • groupwatch_sync - Automatically start and get back in sync with a group watch.
  • unseen-playlistmaker - Keeps track of your watched files from a directory, and on keypress enters playlist-mode to watch unseen files from that specified directory.
  • multiloop - Loop over multiple A-B points.
  • bluetooth-av-delay - Adds desired A-V delay automatically, if default audio sink is a bluetooth device.
  • skip-silence - Playback mode that automatically skips/speed up silent parts.
  • skipsilence - Increase playback speed during quiet parts of the file.
  • dvd-browser - Browse and load DVD titles.
  • plugin-myshows - Automatically marks a currently watched episode in MyShows.
  • writename - Write the currently playing filename/path to a file, optionally skipping/removing from current playlist and muting.
  • when-to-loop - Intelligently decide when mpv should loop, i.e. while shuffling or while playing a short file.
  • UndoRedo - Undo and Redo feature for mpv. If you seek/jump to a different time in the video, press undo [ctrl]+[z] to linearly undo the seeks/jumps in the video, and press redo [ctrl]+[y] to linearly return to previous undo positions. More details in the link above.
  • history - Writes date, time, playtime and filename to a log file: 10.09.2022 19:50 3 D:\Samples\Big Buck Bunny.mkv
  • history - Simple played media logger. Will generate a mpvhistory.log in the default mpv config folder (%APPDATA%/mpv/ or $HOME/.config/mpv/) in the format [$DATE $TIME] $PATH ($?MEDIA-TITLE). Only tested on Windows.
  • history - Autosave played media items in an SQLite database, restore last played position, select (with dmenu(1)) and play item from history.
  • excessive-history - Excessive played media logger. Logs file name, time, and which parts were played. Will generate a history.txt in the mpv config folder. Only tested on Windows.
  • history-bookmark - Create a history file to store the episode we watched last time. And let us easily jump to the video we watched last time.
  • recent - Recently (history) played menu.
  • recent-menu - Recently (history) played menu integrated with uosc.
  • memo - A recent files/history menu for mpv with optional uosc integration.
  • plugin-bookmark - Record your playing history for each folder.
  • bookmarker-menu - Menu to manage all your bookmarks.
  • bookmarks - Support add/delete/prev/next bookmarks, and persistence to sidecar JSON or config directory.
  • SimpleBookmark-1.0 - Bookmark with a [ctrl]+[b], then list and access your bookmarks with [b]. Assign your favorites to a keybind then access your favorites with that same keybind. Much more explained in the link above.
  • misc - When seeking display position and duration like so: 70:00 / 80:00
  • misc - Navigate in playlist to next/previous/first/last file.
  • misc - Jump to a random position in the playlist.
  • misc - Load or append files/URLs from clipboard.
  • misc - Cycle audio and subtitle tracks, include only languages you know.
  • misc - Show detailed media info on screen.
  • censor - Skip over parts of videos you don't want (others) to view
  • autoload - Automatically load playlist entries before and after the currently playing file, by scanning the directory. Obsolete: mpv now has a native --autocreate-playlist option.
  • heuristic-autoload - Automatically load files with similar names as the playing file into the playlist.
  • total_playtime - Shows total playtime of current playlist.
  • track-list - Interractive track-list menu.
  • trakt - Connects trakt.tv with mpv and automatically scrobbles movies/shows.
  • tree-profiles - Automatically apply profiles to certain directories or files.
  • timer - Allows the user to set a starting time and an ending time and see the time elapsed between those points with millisecond precision.
  • time - Shows the current time or the time at which playback will end.
  • stats - Display some statistics about the currently played file on-screen.
  • speed - adjusted timings - Recalculates osd-msg3 timecodes with speed != 1
  • speed-transition-Audio - Changes playback speed based on volume thresholds.
  • speed-transition - Increases playback speed if a subtitle will not be displayed soon. Resumes normal speed just before the subtitle shows up.
  • speed - Changing speed based on regex of filename/path.
  • speed - Always show current playback speed on the OSD.
  • SimpleHistory-1.0 - Powerful history features that logs videos that you opened into a log file along with the time you have reached on each video. Select, filter, and search from your history list, Optional resume by [ctrl]+[r] for all videos you have played. Much more explained in the link above.
  • SimpleUndo-3.2 - Simple undo feature. If you accidentally seek/jump to a different time in the video, press undo [ctrl]+[z] to return to your previous time and vice-versa. More details in the link above.
  • skipchapters - Automatically skip chapters matching a given list of regular expressions (eg. "OP" or "Opening").
  • skiptofade - Seeks forward until a black screen appears. Built to skip openings. Uses the lavfi blackdetect filter.
  • skiptosilence detuur - Skips to the next silence in the file.
  • skiptosilence dyphire - Skips to the next silence in the file.
  • save-playlist - This script saves your playlist to the working directory of the mpv process.
  • rewindPlaylist - keybind to rewind to the end of the previous playlist entry
  • seek-to - Seek to an absolute timestamp specified via keyboard input.
  • review - Allows to remove files viewed quickly from within mpv
  • reload - Sometimes you have unstable internet connection, or YouTube server dies, or your computer was sleeping for too long, or whatever. The thing is: you were watching something, you lost the connection, MPV doesn't want to play it further, you don't want to find the video again and then seek it to the moment you were watching.
  • reload - When an online video is stuck during buffering or got slow CDN source, restarting often helps. This script provides automatic reloading of videos that didn't have buffering progress for some time, keeping the current time position. It also adds Ctrl+r keybinding to reload video manually.
  • radio-title - Automatically fetch current playing title from webradio website when not provided by stream.
  • playlistnoplayback - If you enable the save play history and progress function, this lua script can solve the problem of automatically jumping to the previous playback progress when playing the next file when playing the playlist, that is, let the playlist always play the next file from the beginning every time. the limitations of this script, please see the comments section in the content.
  • playlist-view - Display and navigate the playlist in a grid view of thumbnails.
  • playlist-navigator - OSD display features easy navigation with scrolling and search to select files to play or remove from playlist.
  • permanent-pause-indicator - Displays a permanent indicator in the middle of the screen while mpv is paused. Preview
  • pause-indicator-lite - A simple script that displays an indicator on pause, with options to adjust icon, color, height, width, opacity and whether to toggle pause with a keybind or not.
  • pause-indicator - Displays a momentary icon that flashes in the middle of the screen, similar to YouTube.
  • nextfile - Force opens next or previous file in the currently playing files directory.
  • Change-OSD-Media-Title - Displays filename, percentage watched, current chapter, and number of frames dropped in the OSD media title and updates it whenever one of the values has changed.
  • bookmarker - Bookmark your favorite time on media files
  • List chapters - Shows chapters and their time at the bottom left corner. example
  • lats - The Low ATtention Span mpv script. Plays brief segments from random positions of one or more files, kinda like flipping through TV channels.
  • interactive-video - Script for watching interactive videos (such as Netflix's Black Mirror: Bandersnatch).
  • guess-media-title - Uses guessit to detect a media title by filename and set force-media-title variable. Useful for getting cleaner screenshot file names.
  • fastforward - Instead of skipping forward in media files, speed up the playback for a few seconds. Playback speed decays back to 1x after a few seconds. Tap rapidly or hold down to go faster.
  • evafast - Fast-forwarding and seeking on a single key, with quality of life features like slowing down a bit when subtitles are shown.
  • autoloop - Automatically loops files that are under a given duration (default 5 seconds).
  • autosave - Periodically saves "watch later" data during playback, rather than only saving on quit. Newer fork.
  • auto-save-state - Periodically saves progress with write-watch-later-config, and also cleans up the watch later data after the file is finished playing (so playlists may continue at the correct file).
  • lilskippa - Skip to black, skip to silence, skip to scene change.
  • mpv_segment_length - Displays the length of a segment/range from point A to point B.
  • print-playlist - Cleans the playlist formatting on the terminal.
  • SmartSkip - Automatically or manually skip opening, intro, outro, and preview, like never before. Jump to next file, previous file, and save your chapter changes! Much more explained in the link above.
  • btime - Shows a shorter time format when seeking: 0:15 / 3:10, 08:20 / 55:00, 0:00:05 / 1:30:14.
  • countdown - Display a countdown on OSD for the final seconds of the video (or music file).
  • mpv-slash-search - Simple and lightweight script that allows you to search for a file in the playlist and jump to the first match.
  • mpvclip-mpvival-mpvloop - Run MPV with options for loops and playback start and end times set according to a pattern or intervals of the total duration of a file.
  • loop-until - Loop the video until a specified amount of time. (e.g. loop a 30s wallpaper video to 30min)
  • generate-edl - Bookmark scenes in EDL files.
  • autoload-archive-hook - When playing a direct file from within an archive with e.g. archive://test.rar|/09.png, mpv doesn't fill the playlist. This script does so transparently. It also supports nested and remote archives.
  • LoopToFile - Functional script that allows you to generate playback loops and extract media fragments into new files. L∞p → file.ext.
  • abstime-osd - Show absolute time of the playing audio or video.(OSD).
  • mpv-PiP - Allow users to switch to borderless and top-level picture-in-picture mode with shortcut keys.

File

  • mpv-file-organizer - Automatically organizes media files into folders based on metadata tags.
  • file-browser - On screen file browser.
  • filenavigator - Navigate and open local files.
  • delete-current-file - Moves the current file instantly to the recycle bin.
  • delete-file - Delete files being played.
  • file-rating - Writes a star rating to the filename of the current file.
  • open-file-dialog - Launch a Windows open file dialog.
  • zenity-open-files - Use GTK's zenity to add files to playlist, subtitles to playing video or open URLs.
  • KDialog-open-files - Use KDE's KDialog to add files to playlist, subtitles to playing video or open URLs.
  • simple-loader - (Linux) Browse dirs and files on OSD, and launch them with mpv.
  • Serkio Tagger - Annotate videos with tags while you watch.
  • show-filename - Show the name of the current playing file.
  • rename - Rename files on the go directly from within MPV player window without leaving it.
  • limited-autoload - Auto-load files in a lazy way by limiting how many are loaded into playlist at once
  • locate-file - Locate current media file on your OS file browser
  • fuzzydir - Allows using wildcards for sub-file-paths and audio-file-paths.
  • separator - Copy or move video files you wanna keep.
  • open-in-explorer - Shows the currently playing file in Windows File Explorer.
  • open-dir - Opens the path of the current file in Windows File Explorer.

On Screen Controller

  • uosc - Popular OSC with menu.

  • osc-modern - Modern OSC replacement.

  • ModernX cyl0 - Modern OSC replacement.

  • ModernX zydezu - A fork of ModernX with many additional features and customization.

  • modern-x-compact - Compact version of modern-x.

  • ModernZ - A fork of ModernX designed to enhance functionality by adding more features, all while preserving the core standards of mpv's OSC.

  • uosc_history_menu - A history and bookmark management menu integrated with uosc.

  • tethys - OSC replacement with seekbar thumbnail preview.

  • dark-box - OSC replacement.

  • oscc - Dark-themed OSC.

  • thumbnail_script - Shows preview thumbnails in the seekbar.

  • thumbnail_script - Shows preview thumbnails in the seekbar.

  • thumbnail_script - Shows preview thumbnails in the seekbar.

  • sosc - An OSC supplement for OSC replacements. Provides the idle message and script messages from the original OSC.

  • progressbar - A minimalistic OSC replacement. It provides a small, unintrusive progress bar that persists at the bottom of the video window.

  • osd-bar - Always show osd progress bar, with the more beautiful color matching in the configuration file, you can make the osd progress bar display the current progress at the bottom of the window beautifully,this is a preview.

  • osc-style - Change the mpv OSC to a more beautiful and practical look, which is the osc theme feature, a variety of styles to choose from,this is a tutorial and a preview.

  • osc-show-hide - Toggles the on-screen controller with a hotkey.

  • osc-orange - An osc/ui replacement in dark theme.

  • mfpbar - A minimalistic progressbar and osc replacement.

  • mfpbar-drag - mfpbar with support for dragging the bar.

  • osc-simple - An OSC/UI replacement of white theme.

  • osc-modern-f - OSC script forked from mpv-osc-modern.

Input

  • gestures - Touchscreen and mouse gestures.
  • touch-gestures - Gestures for play/pause, speed, volume, seeking and next/previous playlist-item.
  • cheatsheet - Looking up keyboard shortcuts (bindings).
  • InputEvent - Enhanced input.conf with better, conflict-free, low-latency event mechanism.
  • zones - Handles commands depending on where the mouse pointer is at, mostly for mouse wheel handling.
  • russian-layout-bindings - As mpv does not support shortcuts independent of the keyboard layout (mpv-player/mpv#351), this script tries to workaround this issue for some limited cases with russian (йцукен) keyboard layout. Upon startup, it takes currently active bindings from input-bindings property and duplicates them for russian layout. You can adapt the script for your preferred layout, but it won't (of course) work for layouts sharing unicode characters with english.
  • repl - A REPL for input commands that is displayed on the video window.
  • pointer-event - Mutually exclusive, low latency mouse/touch input event detection. Executes configurable commands on single-click, double-click, long-click and dragging.
  • multisocket - Creates a numbered socket for each instance of mpv.
  • Sockets - creates one IPC sockets per mpv instance, instead of one socket for the last started instance. Supports: Linux, MacOS and Windows.
  • multi-command-if - Very powerful conditional logic and multiple action engine for your keybindings, without having to write a single line of code!
  • leader key - Adds leader key to your mpv. With prefixes and which-key functionality. demo
  • cycle-commands - Allows input.conf commands to be cycled through with keybinds.
  • cycle_messages - Cycle between custom OSD messages.
  • boss-key - Minimise and pause video at the same time. Windows/Linux. Eliminated the time lag in previous versions.
  • boss-key-wayland - Minimise and pause video at the same time in Linux through xdg-portals.
  • blackout - Couldn't find the "Boss key", but you don't want someone (or simply anyone) to see what you are watching?
  • blackout - A fast crossplatform boss-key, but without window minimization (and possible problems with some VO drivers).
  • audio-file-keys - Automatically apply key bindings when playing audio files.
  • auto-mode - Use mpv as video player, music player and image viewer, switch automatically between, video, audio and image mode.
  • mpv-omniGlass - Touchpad gestures for mpv.

Subtitle

  • assrt by AssrtOSS - Download subtitles from assrt.net.
  • sub-assrt by dyphire - Download Chinese subtitles from assrt.
  • autosub - Automatic subtitle downloading.
  • sub-select - Advanced conditional subtitle track selector.
  • autosubsync - Automatic subtitle synchronization script.
  • intersubs - Interactive subtitles.
  • sub-transition - Speed up the video if no subtitles are visible.
  • sub - Python script to automate downloading and loading subtitle from subscence.
  • tts-subs - Use voice synthesis to read subtitles out-loud.
  • trueautosub - Fork of autosub, automatically downloads subtitles if not present using subliminal. (osx/linux only)
  • subtitle-search - Script to search for a phrase inside an active .srt subtitle. Displays matched lines in OSD list, takes sub-delay into account and allows searching for Unicode text in utf8 subtitle files.
  • subselect Tk - Download subtitles with a GUI - select the one you want and automatically load them up in mpv. Supports searching for arbitrary names and different subtitle languages. Works on Windows and Linux, possibly macOS.
  • subit - Yet another script for downloading subtitles using subliminal. Supports better customization of options, such as easy language selection, authentication for providers that need it, and support for URLs.
  • sub_export - fork, updated. Extract selected subtitles from .mkv file.
  • sub-bilingual - Generate bilingual subtitles.
  • sub-bookmarks - Save current position and subtitles in .txt file.
  • sub-export - original, outdated
  • sub-pause - Automatically pause just before the end of each subtitle line. Also allows replaying the currently active line.
  • sub-playback - Add interactive move, i.e. automatically pause at the end of the fragment with option to continue playback or replay it again with or without subtitles.
  • sub-replay - Replay previous sentence.
  • sub-search - Search for phrase in subtitles and skip to it.
  • sub-sentences - Generate subtitles with sentences.
  • sub-skip - Automatically skip parts of a video that don't contain any subtitles. Does so by either fast-forwarding or seeking.
  • sub-transition - Speed up playback when no subtitles are visible.
  • sub - Select subtitle by id via input box (Windows)
  • save-sub-delay - This script saves the sub-delay quantity for each file. When next time the file is opened, sub-delay is automatically restored.
  • restore-subtitles - Saves selected subtitle tracks and visibility state to saved-subs.json file in config directory and restores them whenever file is loaded. Differs from watch-later-saved data in that it saves secondary subtitles too (and uses subtitle file paths instead of ids).
  • playphrase - Search and play phrases from movies and audiobooks.
  • copy-subtitle - Copies currently displayed subtitle line to clipboard.
  • libass_sub_selector - Visually select individual subtitles a la PotPlayer.
  • fix_sub_timing - Compute the correct speed/delay of subtitles by manually synching two points in time.
  • find_subtitles - (Down)load subtitles with subliminal.
  • dessubdb - Download automatically subtitles from the thesubdb.com using DESSubdb.
  • autosubsync - Automatically sync subtitles using ffsubsync.
  • autosub - Automatically download subtitles using subliminal.
  • Audio WebDAV & Sub WebDAV - Auto connection of external subtitles and sound, using the "WEBDAV" protocol. The connection is explicit due to explicitly specifying folders on the WebDAV server.
  • sub-not-forced-not-sdh - Prevents the selection of FORCED and SDH subtitles when you start playing a video.
  • autoselect-forced-sub - Automatically select forced subtitles in a different way.
  • subtitle-lines - List and search subtitle lines of the selected subtitle track.
  • auto-load-fonts - Auto load the font files in the fonts folder under the play file path.
  • rename-sub - Rename current subtitle file as the playing video.
  • whisper-subs - Generates subtitles at runtime with whisper.cpp on Linux.
  • ytsub - Load automatic captions from Youtube, can select language interactively or automatically.
  • dualsubs utils - Auto load dual subs; Auto reload dual subs; Swap primary/secondary subs position; Merge dual subs to one ASS sub.
  • srt-resegment - Resegment srt by synchronize plain text with whisper's word-level timestamps JSON.
  • subber - Write subtitles in mpv.
  • sub-fastwhisper - Generate SRT subtitles through voice transcription using faster-whisper.
  • llm-subtrans - Extract & translate subtitles with OpenAI API. Streaming & contextual.
  • subai - Translate and explain the currently displayed subtitle line into your preferred language. Helps learning a foreign language.

Learning

  • mpvacious - Add keybindings to create Anki flashcards for (language) learning.
  • interSubs - Interactive subtitles, instantly translate selected word/sentence.
  • immersive - Looking up words generating Anki flashcards.
  • migaku - Learn languages together with the Migaku browser extension.
  • Yomichampv - A simple solution for integration with Yomichan - a browser-based japanese dictionay.
  • subs2srs - Automatically add new card in Anki with audio, picture and text.
  • sub-voracious - Reading and listening practice.
  • rikai - Integrated Japanese dictionary and parser to translate by hovering over words. Works on Linux.
  • mpv2anki SenneH - A simple way to add notes to Anki with Audio, screenshots and/or subtitles, with few dependencies.
  • mpv2anki alyssabedard - (Different script with Windows, macOS and Linux support) A simple script to assist your language learning journey in any language by automatically capturing multimedia content from mpv to Anki.
  • lang-learner - Turn MPV into language learner tool. Includes: AB-loop current subtitle or auto loop each one, quick switch between lang you know and lang you are learning, forward to browser (dictionaries, translators), record for future extra learning, export to external script for integrations, and a bit more.
  • mpv-Subtitle-Definition - Instant, on-screen definitions for difficult or obscure words found in subtitles.

Music

  • coverart - Automatically loads external cover art for music files.
  • metadata-osd - Adds OSD showing song name, album name and other metadata.
  • lrc - Download synchronized lyrics of the currently playing song.

Audio

  • Open Sound Control - Open Sound Control listener.
  • visualizer - Various audio visualizations.
  • smart-volume - Replay gain alternative.
  • pitchcontrol - Adjusts audio pitch in half-tone steps.
  • volnorm - Client-server setup to provide EBU R.128 volume leveling to MPV, even if files stored on a server and played on multiple machines. (Works on Linux, probably all Unix-like; server in Perl).
  • firequalizer15 - Linear phase 15-bands equalizer.
  • drcbox - Dynamic Audio Normalizer filter with visual feedback.
  • dbvol - Replaces the default volume controls with a decibel (dB) scale instead of arbitrary percentages.
  • cycle-audio-device - Cycle through available audio devices with key binds.
  • channel mixer - A set of keybindings using a modifier (Shift or Ctrl) and the function keys (F8-F12) to can adjust the mixing level of surround channels on the fly.
  • audio-dupe - Runs a child process to play a second audio stream. Synced through named pipe.
  • audio-balance - Port of mpv's balance property to FFmpeg lavfi pan filter.
  • Audio WebDAV & Sub WebDAV - Auto connection of external subtitles and sound, using the "WEBDAV" protocol. The connection is explicit due to explicitly specifying folders on the WebDAV server.
  • adevice-list - Interractive audio-device list menu.
  • acompressor - Dynamic range compressor using acompressor ffmpeg filter with controls to dynamically adjust parameters.
  • switch-both-audio - Switch between playing one or two audio tracks simultaneously upon file load or with a hotkey.
  • cycle-adevice - Cycle through available audio devices.
  • Sofalizer - Simulates 7.1 surround sound to your headset. Get the sofa file from here
  • afilter - Script for easy access to certain audio compressors and HRTF sofalizer in mpv with option to whitelist filters based on type of media.
  • ff-silence - Fast forward through silences and quiet parts of audio, useful on videos where the speaker uses many long pauses.
  • aspeed.lua - Multi-stereo speed randomization & tri-color clocks. Applies arbitrary speed formula & has chipmunk mode for left-channel. Also has double-mute insta-toggle. Primary channel may be left or right. A filterchain applies to all speakers - each is its own mpv. Has many script-messages. For mpv v0.34→v0.38, SMPlayer, Windows, Linux, MacOS, Android, YouTube, mp4, mp3, jpg, etc. But no randomization for Android. (Example clock).

Streaming

  • jellyfin - Turns mpv into a Jellyfin client.
  • mpvDLNA - Browse and watch content hosted on DLNA servers.
  • selectformat - Select the format (quality) of internet videos.
  • sponsorblock_minimal - More simple version of the sponsorblock script.
  • sponsorblock - Script to skip sponsored segments of YouTube videos.
  • streamsave - Save live streams without encoding.
  • mpvf - Select youtube-dl format for streaming.
  • quality-menu - Change the streamed video and audio quality (ytdl-format) on the fly.
  • youtube-download - Download YouTube audio and video with one key press.
  • youtube-search - A script that allows users to search youtube and open results from within mpv. Requires a couple of extra API scripts, along with curl and a personal youtube API key.
  • youtube-search - Use zenity and youtube-dl to search YouTube. Linux only.
  • youtube-upnext - A menu for (auto) playing YouTube's "up next"/recommended videos, that show up on the right side on the website.
  • ytdlautoformat - Automatically adjusts ytdl-format (yt-dlp) for specified domains.
  • ytdl-preload - Precache the next entry in your playlist if it is a network source by downloading it to a temp file ahead of time. Updated to download all streams in parallel so you can watch it while it downloads.
  • youtube-queue - Implements the YouTube 'Add to Queue' functionality. Allows adding video urls to the queue from the clipboard, and provides a menu for interacting with the queue.
  • webtorrent-hook - Allows streaming torrents using webtorrent (same as mpv-peerflix-hook but using webtorrent instead). Webtorrent-cli can play in mpv with webtorrent --mpv, but this script allows using torrent identifiers as the file argument to mpv or pasting them into the current playlist using one of the pasting scripts listed here. It also supports additional functionality like automatic file cleanup and the ability to remember the last file played in the torrent. See the readme for more information. See here for a comparison with the other javascript webtorrent plugin. I recommend this plugin over my others (mpv-peerflix-hook and btfs-stream).
  • play-with - A web browser extension that can open a video stream on a web page with an external player.
  • confluence - Open magnet links using confluence HTTP service. Recommended to use modified script for TorrServer instead.
  • torrserver - Allows streaming torrents using TorrServer. Support magnet links and .torrent files
  • torrserver-hook - Allows for playback of media from the BitTorrent network using TorrServer.
  • btfs-hook - Allows streaming torrents using FUSE via btfs.
  • btfs-stream - Allows streaming torrents using btfs. As far as I can tell, it is much simpler than the above scripts (no long shell script execution) and much more configurable (the other scripts have no settings). This is much slower than using webtorrent though, so I recommend using webtorrent-hook instead.
  • streamcache - Provides for more network-glitch-robust caching of live streams by adjusting replay speed.
  • stopCache - stops the demuxer from downloading more if it is already past --end
  • spotify - Add current playing title to an user defined Spotify playlist.
  • sopcast - Adds support for sop:// urls.
  • show-stream-title - Show OSD stream/channel title when switching the IPTV channels from m3u playlist.
  • peerflix-hook - Allows streaming of magnet links using peerflix, similar to youtube-dl.
  • yledl - Watch videos from YLE Areena in mpv using yle-dl
  • peerflix-hook - Stream magnet links in mpv with peerflix.
  • acestream - Add AceStream protocol handler to mpv. Let the user open streams by dropping Acestream links into mpv GUI or by passing them as command line argument.
  • reduce_stream_cache - Reduces MPV cache for streams by increasing playback speed. Works with Twitch through Streamlink.
  • last.fm scrobbler - Sends the information about playing tracks to last.fm, see http://www.last.fm/help/faq?category=99 for more info.
  • http-ytproxy - Simple MitM http proxy to modify Range http headers. Can be used to speed up youtube videos.
  • torrserver-browser - This script lets you search and play torrents from Rutor via TorrServer directly in mpv, without using a browser or external applications. The search is bound to the f key inside mpv and uses a user input module to get text from the keyboard. The M key opens the main script UI, showing everything that has already been added to your TorrServer, with support for launching torrent files and magnet links without any additional Lua scripts.

Video

  • changerefresh - Automatically change the refresh rate of the current display to match the playing video (Windows).
  • autospeed - Adjusts the display refresh rate and video speed for almost 1:1 playback (Unix-like OSes, Xorg / X11).
  • autospeedwin - Adjusts the display refresh rate and video speed for almost 1:1 playback (Windows).
  • gpufreq - Displays the current and maximum GPU frequency as an osd message.
  • mvtools-script - vapoursynth-mvtools script.
  • store-shaders - Store current glsl-shaders config on first run, this config will then be restored by subsequent calls.
  • switch-shader - Provides a switch to disable/restore shaders and vf filters.
  • xrandr - Automatically sets the display refresh rate to the one best suitable for the video played
  • mpv-kscreen-doctor - Like the xrandr script automatically sets the display refresh rate to the one best suitable for the video played, works for KDE Plasma Wayland sessions.
  • vlcaspectratio - Implements a VLC style aspect ratio hotkey 'a' that stretches the video to different aspect ratios.
  • cycle-video-rotate - Allows you to perform video rotation which perfectly cycles through all 360 degrees without any glitches.
  • autocrop - Automatically crop the video by using lavfi's cropdetect filter to detect black bars.
  • vlccrop - Implements a VLC style crop hotkey 'c' that cycles through crop settings, useful for cropping letter-boxed or pillar-boxed content.
  • matroska-crop - Automatically crop video using the Matroska PixelCrop properties. Includes optional workaround for hardware decoding.
  • dynamic-crop - Dynamically crop the video by using lavfi's cropdetect filter to detect hard-coded black bars for Ultra Wide Screen (21:9) or any screen different from 16:9 (phone/old TV).
  • crop - Crop the video by defining the target rectangle with the cursor.
  • cropmode - Adds a keyboard-oriented mode for cropping, outputting the result in a format suitable for ffmpeg.
  • autocrop.lua - Modded version randomizes aspect ratio & crops black bars off videos & images while maintaining center in horizontal & vertical. Double-mute toggles the crop & auto_aspect. Has tolerance options, & varies limit (& start/end limits) with media-title. Can display all cropdetect or bbox metadata. Handles transparent input. For mpv v0.34→v0.38, SMPlayer, Windows, Linux, MacOS, Android, YouTube, mp4, mp3, jpg, etc. Example of auto_aspect btwn 16:9 & 4:3.
  • autocomplex.lua - Accurate stereo spectrum overlay, with volume bars. Has many options for showfreqs, showvolume, moving overlays, colormixes, normalizers, interpolation, etc. Easy to distinguish stereo from mono. Has many script-messages. For mpv v0.34→v0.38, SMPlayer, Windows, Linux, MacOS, Android, YouTube, mp4, mp3, etc. Example of dual-complex.
  • automask.lua - Applies filterchain to animated masked region with inversion (blinking) & invisibility. geq uses any formula. Smooth toggle with double-mute. Comes with 14 examples, including blinking monacle, binacles, pentagon, spinning triangle, scanning visors etc. Has many script-messages. For mpv v0.34→v0.38, SMPlayer, Windows, Linux, MacOS, Android, YouTube, mp4, mp3, jpg, etc. Example mask.
  • use-cpu - If the width of the video is greater than 3000 or the height of the video is greater than 2000, it will automatically switch back to using cpu decoding.
  • waveform - Displays a waveform of the video in real-time.
  • BoxToWide - A simple mpv script to change 4:3 aspect-ratio of video files/streams to 16:9 automatically.
  • frame_info - Show frame info, similar to ffdshow's OSD.
  • live-filters - Add, remove or toggle ffmpeg video filters during mpv playback.
  • histogram - Exposes a configurable way to overlay ffmpeg histograms in mpv. There is a substantial amount of config available.
  • filter-test - Test mpv/FFmpeg video filter(vf) strings with editable popup dialog.
  • cycle-denoise - Cycle between lavfi's denoise filters (press n)
  • autodeint - Automatically deinterlace the video by using lavfi's idet filter to detect interlaced content.
  • cycle-deinterlace-pullup - Cycle between deinterlacing, pullup (IVTC), and both filters off.
  • curvesman - Manipulate color curves filter of FFmpeg with hotkeys. Brighten up color, change color temperature/tone, hopefully more. Adjust yellow light tone to white light tone.
  • blur-edges - Replace black bars with a blurry copy of the video.
  • delogo - Remove channel logo from videos.
  • pickshader - Provides a ^R-esque interface for easily setting/appending to --glsl-shaders (this does not install shaders for you).
  • sview - Displays all loaded shaders in a clean format. It suppresses the default OSD message, allowing the custom list to be viewed by toggling it or when changing shaders.
  • if - A wayland VO patch and C plugin which forwards keyboard and mouse input to a headless compositor for playing 2D games with upscaling mpv user shaders.
  • hdr-mode - Automatically switches the display's SDR and HDR modes for HDR passthrough based on the content of the video being played.
  • mpv360 - Interactive 360° Video Viewer. With full camera control through mouse and keyboard inputs.
  • display-plugin - More display properties for mpv, support toggle Windows HDR.
  • Fast Catmull-Rom - Fast Catmull-Rom approximation using 5 samples by omitting corners.

Image

  • thumbfast - High-performance on-the-fly thumbnailer for mpv.
  • screenshot-to-clipboard - Takes a screenshot and saves it to the clipboard.
  • takeSsSequence - Take a sequence of equispaced screenshots.
  • clipshot - Screenshot the video (with subs, without subs or the whole window) and copy it to the clipboard. For Windows, Linux/BSD and MacOs
  • crop_script - Take cropped screenshots.
  • gif-generator - Creates animated gifs using hotkeys.
  • auto-mode - Use mpv as video player, music player and image viewer, switch automatically between, video, audio and image mode.
  • waifu2x - Take screenshot and convert images with waifu2x.
  • webp-generator - Creates animated webp using mpv hotkeys. (Windows only)
  • image-config - A configuration to use mpv as an image viewer.
  • gallery-dl_hook - Load online image galleries (imgur, etc) as playlists using gallery-dl.
  • gallery-dl-view - Load image galleries directly in mpv like gallery-dl_hook but with extra functionality like binding a key to download images, optionally only loading images that are new since the gallery was last opened, and more.
  • contact-sheet - Display thumbnails of the current file in the style of a contact sheet.
  • image-viewer - Configuration, scripts and tips for using mpv as an image viewer.
  • screenshot-mosaic - Create a mosaic/thumbnail image.
  • abs-screenshot - Uses Exiftool to get the "Date/Time Original" and saves a screenshot with the name being the actual time the video was taken.
  • sorted-screenshots - Sort screenshots based on the file they're screenshotted from and nested directories.
  • screenshotfolder - Place screenshots into folders for each video, along with timestamping them.
  • webp-avif-generator - Creates animated webp/avif using mpv A-B loop and FFmpeg. (Support Windows and Linux)
  • gallery-screenshots - In‑player tiled screenshot gallery that turns your screenshots into visual bookmarks for fast navigation. Click thumbnails to jump instantly. Export screenshots to contact sheets (PNG), CSV, and Excel table XLSX.

Video Editing

  • trim - Trim clips without transcoding.
  • easycrop - Cropping videos with ease.
  • videoclip - Create video and audio clips.
  • video-splice - Create a video out of cuts.
  • Pure - Get the file path, timestamps, and cropping coordinates for ffmpeg.
  • cut b1scoito - Video cutting/clipping/slicing script.
  • cut zydezu - Easily clip, compress and re-encode selected clips.
  • sub-cut - Extract a part of the video as audio or video with subtitles.
  • slicing - Cut uncompressed fragments of the video.
  • slicing_copying - Cut fragments of video in original format.
  • excerpt - Allows you to quickly create excerpts from media files, you just have to set begin and end markers.
  • clipper - Quickly trim videos using ffmpeg within mpv.

Social

  • cord - Discord integration for mpv, using the Game SDK instead of Discord RPC. Supports: MacOS and Windows. (Linux is not supported by Game SDK)
  • discordRPC - Discord Rich Presence integration.
  • discordRPC - Discord RPC integration for mpv using lua-discordRPC as base.
  • discord - A cross-platform Discord Rich Presence integration for mpv with no external dependencies. Consists of a Go binary for updating the presence and a Lua script for launching it.
  • mpv-rpc - Discord Rich Presence integration. Also displays cover art from MusicBrainz archive.
  • irc - Displays lines from an irc channel.
  • LoadDanmaku - Load local damaku files.
  • youtube-chat - Overlays YouTube chat on top of a video using yt-dlp.
  • twitch-chat-irc - Show Twitch chat messages as subtitles when watching Twitch LIVE.
  • twitch-chat - Show Twitch chat messages as subtitles when watching Twitch VOD with mpv.

Configuration

  • persist-properties - Keep selected property values (like volume) between player sessions.
  • remember-props - When a property changes, it saves it to restore on next start. Saved values are not file-specific. List of properties to save is configured in script-opts/remember-props.conf file.
  • config-saver - Saves current audio track, subtitle track, subtitle position, etc. for all videos in the folder.
  • cycle-through-existing - Cycle through existing video/audio/subtitle tracks, skipping the "none" option.
  • auto-keep-gui-open - Intelligently switches mpv's "keep-open" behavior based on whether you are running in video-mode or audio-only mode.
  • celebi - An optimized script to restore properties from past sessions. Alternative to persist-properties and remember-props scripts.
  • show-conf-osd - Display configuration files on the OSD.

Library

Other

  • webm - WebM converter based on MoonScript.
  • manager - Script and shader manager.
  • copyStuff - Copy to clipboard the filename or URL, full filename path, current video time, current displayed subtitle text, video duration/metadata.
  • copyTime - Copies the current time to the clipboard.
  • copy to music - Copies the current media file you're playing to a predefined directory, and plays the next entry in the playlist (Unix-like)
  • copy-paste-URL - Paste URLs directly from clipboard into mpv
  • copy-permalink - Copy mpv --time=<current-position> <path-playing> to clipboard. Useful for sharing when playing URLs.
  • copy-timestamp - Copies current timecode in HH:MM:SS.MS format to clipboard.
  • cp-paste-URL - Fork of copy-paste-URL with support for Linux.
  • SmartCopyPaste-3.0 - Powerful copy paste features. Paste URL or local videos directly to mpv. Copy URL or currently playing video in mpv player then paste to access at a later time. Add videos to playlist simply by pasting. Much more explained in the link above.
  • SmartCopyPaste-II-3.0 - Powerful copy paste and clipboard list features using a log file. Select, filter, and search from your clipboard list. Paste URL or local videos directly to mpv. Copy URL or currently playing video in mpv player then paste to access at a later time. Paste to access previously copied times of same video. Much more explained in the link above.
  • vr-reversal - View 3D side-by-side video as a 2D video, allows you to look around and zoom within the video, logs the head motions to a file for later rendering out to a 2D video with ffmpeg.
  • vo_battery - Choose the VO based on if the laptop is on battery or not.
  • tv-output - TV output handling - activate on mpv playback and deactivate on mpv shutdown.
  • misc - Execute Lua code from input.conf.
  • misc - Restart mpv restoring the properties path, time-pos, pause and volume.
  • i3-floating-centered - Show mpv window in the center of the display when it is in floating mode (i3wm)
  • ontop-window - Disables the ontop property when in fullscreen, and enables it again when in window mode, if it was disabled.
  • ontop-only-while-playing - Ontop is only active during video playback. Ontop is automatically disabled during idle, pause and is able to be dynamically disabled without having to restart unlike the previous script.
  • ontop-playback - Disables the ontop property when pausing, and enables it again when unpausing the video, if it was disabled. Change it only when the player is not in fullscreen to prevent screen flickering.
  • pause-when-minimize - Pauses the player video when minimizing, and unpauses it when brought up again.
  • deframe - Removes the frame of YouTube videos.
  • scale-win - Restore old "window-scale" behavior, so to make "add window-scale +/-" keybinds work again when any of the autofit-* options are defined.
  • quick-scale - Quickly scale the video player to a target size, with full control over target scale and max scale. Helps you effortlessly resize a video to fit on your desktop, or any other video dimensions you need!
  • profile-cycle - Cycle between your custom defined profiles while watching the video.
  • open-kinopoisk-page - Opens the kinopoisk page that corresponds to the currently playing media file.
  • open-imdb-page - Opens the IMDb page that corresponds to the currently playing media file.
  • open-anilist-page - Opens the Anilist page that corresponds to the currently playing (anime) file.
  • oled-screensaver - To prevent burn-ins on OLED TVs, this script fades-in a black screen after 15 seconds when paused in fullscreen.
  • notify-send - A simpler and more recent notifications script for libnotify-compatible (i.e. Unix-like) notifications daemons only. Supports cover art.
  • notify - Adds desktop notifications to the mpv media player, which show metadata like artist, album name and track name when the track changes.
  • notify - Converging point for all forks of rohieb's notify scrip.
  • osd-clock - Periodically shows OSD clock (many configurable options).
  • clock - Constantly show current time on the lower left corner of the video screen.
  • txt - Play text files using text-to-speech (TTS). (Works on Linux, MacOS).
  • pdf - View PDFs in mpv using ImageMagick. (for Linux, MacOS)
  • manga-reader - Script for using mpv as a manga reader.
  • redshift_toggle - Toggle redshift when loading a video file and when reaching the end of said file. Now also handles pause.
  • toggle-redshift-on-play - Toggle redshift when viewing videos with mpv.
  • toggle-redshift-on-play kill-restart-version - Toggle redshift when viewing videos with mpv.
  • inhibit_gnome - Prevent screen blanking on GNOME while content is playing
  • mpegts-truncate - Removes beginning of MPEG TS file up to current position without re-writing the whole file.
  • minesweeper - Minesweeper game.
  • local-language - Let the text displayed by osd become the language you are most familiar with, that is, language localization, such as 【volume: 100%】 becomes 【音量:100%】.
  • kde-do-not-disturb - Disable the notifications while mpv is running
  • kde-night-color - Disable Night Color while mpv is running.
  • gnome-inhibit - Prevent the screen from blanking under GNOME+Wayland while a video is playing.
  • notify - Now-playing-desktop notifications.
  • taskbar-buttons - (Windows) Adds thumbbar buttons.
  • xscreensaver - (Linux) Disables XScreensaver while video playback is active, a replacement for heartbeat-cmd.
  • xfce-genmonify - Update a xfce4-panel genmon plugin that is set up with genmonify to display the currently playing media file and elpapsed or remaining time in xfce4-panel.
  • force-window-profile - Applies the force-window profile when force-window is set (i.e. when starting mpv from the .desktop file)
  • exit-fullscreen - If you use --keep-open=yes, this script exits fullscreen mode when the playback reaches the end of file/playlist.
  • encode - Re-encode or remux part of the current video. Can also preserve some filters, such as "crop".
  • convert_script - Script to quickly convert and crop videos from within mpv, with a GUI.
  • composition guides - Overlay basic composition guides onto your video.
  • clipboard - Provides a set of generic commands to interact with the clipboard. Specifically it allows user to copy arbitrary text to the clipboard and provides the ability to paste the contents of the clipboard into other commands.
  • change-screen-by-aspect-ratio - Change the active fs-screen based on video's aspect ratio (for systems with monitors in landscape and portrait orientations).
  • mpvMatroska - mpvMatroska turns mpv into a Matroska player.
  • bstat - Calculates new user-data properties (req mpv v0.36) including avg-bitrate, rounded file-size, exact aspect ratio, etc. Output to terminal or OSD. Updates when a new file is loaded or on demand.
  • debug-plugin - A debug tool for mpv script developers, with GUI support for properties and console.
  • user-data-loader - Allows the user-data property to be set at launch using config files and changed using profiles and script-opts during runtime.
  • lua-repl - A Lua REPL in the console with autocompletion and pretty-printing of returned tables. It lets you test mpv's and Lua's API without writing a script.
  • main.lua - Loads other scripts, hooks in yt-dlp, displays title, has subtitle override, loops short files, sets options (with delay), & has detailed commentary. Has many script-messages. For mpv v0.34→v0.38, SMPlayer, Windows, Linux, MacOS, Android, YouTube, mp4, mp3, jpg, etc. But no yt-dlp for Android. Example title.
  • kodi hook - Allows Kodi streaming add-ons to work correctly when using mpv as an external player for Kodi by parsing and extracting protocol options from Kodi's custom URL format.
  • socket - Creates one IPC socket per mpv instance. Configurable. Socket name can be modified while playing.
  • trakt-scrobble - Connects trakt.tv with mpv and automatically scrobbles movies/shows.
  • anilist-updater - Automatically updates your AniList when reaching 80% completion based on the file name.
  • equalizer - Script for togglable parametric equalizer with EQ configuration similar to EqualizerAPO format present in a csv format. Script can be whitelisted based on whether the content is audio, video or a movie. Settings are located in equalizer.conf in ./script-opts folder and equalizer configuration in ./script-opts/equalizer folder.
  • lines-meme-generator - Allow users to take screenshots in MPV, crop them to keep only the bottom portion, and stitch them together into a long vertical image, just like a meme of lines.
  • notification-osd - XDG desktop notification OSD plugin for track changes or media key playback control while the window is unfocused. Supports cover art and video thumbnail of the current time position.
  • single-instance - Reuse the existing mpv window when opening new files rather than spawning a new window.

Music Player

  • Harmonoid - Cross-platform, based on Dart/Flutter.
  • Olivia - Linux cloud music player, based on C++/QT/Web.
  • vmn - Cross-platform CLI music player, based on C/TUI.

Media Center

  • Stremio - Cross-platform, based on C++/QT.

Streaming Tools

  • Macast - DLNA Media Renderer. You can push videos, pictures or musics from your mobile phone to your computer, based on Python/Web.
  • jellyfin mpv shim - Jellyfin (Emby/Plex alternative) Client, based on Python.
  • Botflix/stream-cli - Command-line tool that combines scrapy and webtorrent for streaming movies, based on Python/TUI.
  • webtorrent-mpv-hook - Adds a hook that allows mpv to stream torrents using webtorrent.
  • ff2mpv - A Firefox/Chrome extension for playing URLs in mpv, based on PowerShel/Shell/Python/JavaScript.
  • plex-mpv-shim - Cast media from Plex Mobile and Web apps to MPV, based on Python.
  • play-with-mpv - Chrome extension for playing URLs in mpv, based on JavaScript/Python/Web.
  • qtube - Linux YouTube frontend, based on Python/QT.
  • TubiTui - Cross-platform YouTube client based on Rust/TUI.
  • DLNAmpvRenderer - Windows DLNA/UPnP renderer based on Python.
  • Plaincast - Unmaintained Linux server that acts like a lightweight/headless Chromecast that only includes YouTube, based on Golang.
  • orion - Unmaintained cross platform Twitch.tv client, based on C++/QT/QML.

User Configuration

Social Tools

  • Syncplay - Synchronize playback on mpv/VLC/MPC on many computers and chat with friends. Cross-platform, based on Python.
  • KikoPlay - Cross-platform Danmu player, based on C++/QT.

Video Conversion

  • boram - Unmaintained cross-platform WebM converter, based on JavaScript/Web/Electron.
  • webm.py - Cross-platform command-line WebM converter, based on Python.

Shaders

  • Anime4K - A series of shaders designed to scale and enhance anime. Includes shaders for line sharpening, artefact removal, denoising, upscaling, and more.
  • LumaSharpenHook - A sharpen filter similar to using Unsharp Mask in Photoshop ported from SweetFX shader pack.
  • SSimDownscaler, SSimSuperRes, Krig, Adaptive Sharpen, etc. - * SSimDownscaler: Perceptually based downscaler. SSimSuperRes: The aim of this shader is to make corrections to the image upscaled by mpv built-in scaler (removes ringing artifacts, restores original sharpness, etc). Krig: Chroma scaler that uses luma information for high quality upscaling.
  • Noise - Simplistic filter that adds a tunable amount of uniform white noise to the output.
  • Film Grain v1** and **Film Grain v2 - Two configurable shaders for applying gaussian-weighted white noise to the image. v2 is a smoothed version of v1, which uses an extra gaussian blur pass to shift the grain frequency spectrum. Both versions can trivially be adapted to add film grain to other channels besides LUMA by just adding it to the list of hooks.
  • Antiringing - This is an antiringing filter that works by clamping to the local neighbourhood. Sort of inspired by the mpv built-in antiringing algorithm, but it's extended in such a way that it also works well for polar (EWA) filters, which the mpv built-in algorithm does not support at all.
  • nnedi3 and ravu - User shaders for prescaling.
  • acme-0.5x - Fastest 0.5x downscaler for mpv, useful for 4K video playback on FHD screen (bypass chroma upscaling and color conversion in 4K resolution).
  • lensfix - Fix radial distortion commonly found in wide angle action cameras.
  • hyperview - Dynamic stretching filter aiming to bring effects similar to GoPro SuperView.
  • FSRCNN - Prescaler based on layered convolutional networks.
  • un360 - Converts equirectangular 360 degree video to be watchable, at a fixed perspective.
  • Nonlinear stretch - Non-linear stretch scaling. use with --no-keepaspect.
  • FidelityFX CAS - AMD FidelityFX Contrast Adaptive Sharpening (CAS) provides a mixed ability to sharpen and optionally scale an image. The algorithm adjusts the amount of sharpening per pixel to target an even level of sharpness across the image. Areas of the input image that are already sharp are sharpened less, while areas that lack detail are sharpened more. This allows for higher overall natural visual sharpness with fewer artifacts.
  • FidelityFX FSR - AMD FidelityFX Super Resolution is a spatial upscaler: it works by taking the current anti-aliased frame and upscaling it to display resolution without relying on other data such as frame history or motion vectors. At the heart of FSR is a cutting-edge algorithm that detects and recreates high-resolution edges from the source image. Those high-resolution edges are a critical element required for turning the current frame into a “super resolution” image. FSR provides consistent upscaling quality regardless of whether the frame is in movement, which can provide quality advantages compared to other types of upscalers.
  • NVIDIA Image Scaling - NVIDIA Image Scaling is a spatial scaling and sharpening algorithm. The scaling algorithm uses a 6-tap scaling filter combined with 4 directional scaling and adaptive sharpening filters, which creates nice smooth images and sharp edges. In addition, an adaptive-directional sharpening-only algorithm is available. The directional scaling and sharpening algorithm is named NVScaler while the adaptive-directional-sharpening-only algorithm is named NVSharpen.
  • Post upscale unsharp masking - This is mpvs original image sharpening algorithm ported into the shader, in order to work only after upscaling is done.
  • nlmeans, hdeband, & more - nlmeans is a featureful implementation of the Non-local Means algorithm, it does both denoising and adaptive sharpening. hdeband is an implementation of a debanding algorithm that blurs homogeneous regions together.
  • Alt Scale - An alternative to mpv's built in scaling. It can be slightly faster than built in scaling with equivalent quality.
  • Unsharp mask and Gaussian blur - A 2 pass unsharp mask and a 2 pass gaussian blur. Similar to those in Photoshop, Image Magick, Gimp, etc.
  • 2D Image Resampling - 2D Image Resampling is a general resampling algorithm made for experimental / testing use.
  • hdr-toys - Componentized Rec.2100 to Rec.709 conversion shader.
  • Jinc - Jinc based image scaling. Similar to mpv's ewa or polar.
  • NLS-Next - A nonlinear stretch shader and helper script for MPV, featuring bi-directional stretching and multiple tunable options.
  • Pixel Clipper - Simple anti-ringing filter based on pixel clipping/clamping.
  • JointBilateral & FastBilateral - Chroma upsamplers that use the luma plane as a guide to achieve sharper transitions without introducing any ringing.
  • A-Pack - Shaders pack for quick Adjustment of (web) video: brightness/contrast curves (tooDark, tooBright, bShadows, bDim, etc.) and color (vibrance, skintones, Black&White). Runs on integrated graphics.
  • ArtCNN - Luma doublers trained on Manga109.
  • CuNNy - Cute and funny CNN-based upscaler optimized for anime.
  • AniSD ArtCNN - AniSD ArtCNN shader for standard definition anime content.
  • Ani4K v2 ArtCNN - Ani4K shader v2 targets modern anime, from high quality Bluray to crappy WEB releases, for upscaling to either 2K or 4K.
  • Snapdragon Game Super Resolution (GSR) v1 - Snapdragon Game Super Resolution (GSR) v1 is a single-pass spatial upscaling technique originally developed by Qualcomm for mobile devices. It integrates upscaling and edge sharpening into one GPU shader pass, leveraging a 12-tap Lanczos-like scaling filter and an adaptive sharpening filter.

VapourSynth Scripts

  • mvtools - Use MVTools's BlockFPS function to perform motion interpolation on the video in realtime.
  • nnedi3 - Use NNEDI3 to double the resolution of the video. This always performs a single doubling. Note that the vapoursynth-nnedi3 filter is so slow that this practically can't be used in realtime, so it's not much use in practice.

Video Editing Tools

  • vidcutter - Cross-platform video cutter/joiner, based on Python/QT.
  • tsv_edl.vim - Linux video editing with vim/spreadsheet/sed/python.

Image Viewer

  • qimgv - Cross-platform, based on C++/QT.

Launcher

Remote Control

  • mpv-mpris - On Linux allows controlling mpv using standard media keys.
  • lua-mpris - Adds mpris support to mpv.
  • simple-mpv-webui Based on Python/Lua/JavaScript/Web.
  • KDE Connect - Enabling communication between all your devices.
    • GSConnect - Implementation of KDE Connect for GNOME.
  • mpv-remote-app - For Android, based on Java/Python.
  • mpv-remote-app - For Android, based on Vue.js/Ionic/Node.js.
  • MPVMediaControl - Windows 10 System Media Transport Controls (SMTC).
  • Classic remote control used by stax76: 'One For All Contour URC1210' using Philips code 0556 together with 'FLIRC USB (gen2)'.

Building

Library

  • python - Python interface.
  • py - Another Python interface.
  • mpv.d.ts - TypeScript definition file (JavaScript).
  • script - TypeScript definitions for builtin mp modules and globals.
  • mpv.d.ts - Another TypeScript definitions for mpv JavaScript API.
  • promise - Promise polyfill for mpv JavaScript runtime.
  • node - Node.js interface (JavaScript).
  • js - Embeddable player for Electron/NW.js (JavaScript).
  • assdraw - mpv assdraw module for JavaScript.
  • object pascal - Embeddable player for Object Pascal.
  • ruby - Ruby interface.
  • easy - TS and React GUI toolkit for mpv script.
  • Kit - MPVKit is a collection of tools to use mpv in iOS, macOS, tvOS applications. It includes scripts to build mpv native libraries.

Other Tools

  • install - Sets up file associations for mpv on Windows.
  • Memento - Cross-platform video player for studying Japanese, based on C++/QT.
  • blitzloop - Linux karaoke software, based on Python/OpenGL.
  • mpvQC - Cross-platform application for quality control of videos, based on Python/QT.
  • vidify - Cross-platform app that detects playing songs on your device and plays their music videos anywhere, based on Python.
  • Karaoke Mugen - Cross-platform karaoke management app, based on JavaScript/node.js/Web.
  • gnome-shell-extension-caffeine - Prevent the display from turning off (Gnome doesn't support the idle-inhibit protocol on Wayland) and disable the 'night light' when a mpv window is in focus.

Other projects from me

A list of my other projects can be found here:

https://stax76.github.io/software-list

more like this

MTT-File-Manager-RUST

MTT File Manager is a Rust-based Windows file manager with tabbed navigation, rich media previews, deep system integrat…

Rust★ 51
@MTTamurex

cedarserver

An open-source show control system supporting synchronized multi-screen multimedia playback and lighting control.

JavaScript★ 57
@cedarproject

search

search projects, people, and tags