awesome-mpv/README.md

Awesome mpv

A curated list of projects related to the mpv media player.

Table of contents

• Media Player
  • Cross-platform
  • Windows
  • MacOS
  • Linux
• Build/Installation
• Support
• User Script
  • GUI
  • Playback
  • File Managment
  • On Screen Controller (OSC)
  • Subtitle
  • Learning
  • Streaming
  • Image
  • Video Editing
  • Social
  • Configuration
  • Script collection miscellaneous
  • Other
• Music Player
• Mobile Player
• Media Center
• Streaming
• Configuration
• Social
• Video Conversion
• Video Processing
• Video Editing
• Image Viewer
• External Tools
• Remote Control
• Tutorial
• Building
• Library
• Other

Media Player

Cross-platform

• mpv - 20.9k stars, based on C/Lua.
• MoonPlayer - 525 stars, based on C++/QT/QML.
• SMPlayer - 319 stars, based on C++/QT.
• mpc-qt - 144 stars, based on C++/QT.
• ImPlay - 22 stars, based on C++/imgui.
• MPV-EASY Player - 617 stars.
• Baka-MPlayer - Unmaintained, 375 stars, based on C++/QT.
• movie-monad - Unmaintained, 397 stars, based on Haskell/GTK.
• OvoPlayer - Unmaintained, 41 stars, based on Pascal.

Windows

• mpv.net - 1.7k stars, based on C#/WinForms/WPF.

MacOS

• IINA - 31.9k stars, based on Swift/Cocoa.

Linux

• Celluloid - 840 stars, based on C/GTK.
• Kawaii Player - Player/Library/Server, 523 stars, based on Python/QT.
• xt7-player-mpv 84 stars, based on Gambas/QT.
• mpvz - 38 stars, based on C++/QT/QML.
• Haruna - 17 stars, based on C++/QT/QML.
• Deepin Movie - Unmaintained, 60 stars, based on C++/QT.

Build/Installation

• Official installation instruction
• mpv-winbuild-cmake by shinchiro - Daily Windows builds of mpv and libmpv, 219 stars, based on CMake/C/Shell.
• mpv-winbuild by zhongfly - Daily Windows builds of mpv and libmpv, 81 stars, based on Shell.

Support

• https://www.reddit.com/r/mpv
• https://github.com/mpv-player/mpv/issues

User Script

• User scripts listed in the mpv wiki - This is the most important and most complete list of available mpv scripts.
• Users scripts on GitHub tagged with 'mpv-script'
• mpv-script-directory

GUI

Searchable Menu

Searchable menus (also known as command palette) are used to find key bindings and many other things like searching the playlist.

• mpv-search-page - On screen menu.
• search_menu - Menu based on Rofi or terminal based on fzf.
• M-x - On screen menu.
• mdmenu - Menu based on dmenu.

Custom on screen menu

• menu - On screen menu to launch custom commands, 33 stars.
• osm - On screen menu to launch custom commands.

Playback

• playlist-manager - Create and manage playlists, 348 stars.
• recent - Recently played menu, 35 stars.
• history - Writes filename and time to a log file.
• smart-volume - Records the relative volume per song in order to restore it in future sessions.

File Managment

• file-browser - On screen file browser.
• filenavigator - Navigate and open local files, 55 stars.
• delete-current-file - Instantly delete the file that is currently playing via keyboard shortcut, the file is moved to the recycle bin and removed from the playlist.
• file-rating - Writes a star rating to the filename of rated files.

On Screen Controller (OSC)

• mpv_thumbnail_script - Shows preview thumbnails in the seekbar, 575 stars.
• uosc - Minimalist proximity-based UI, 412 stars.
• ModernX - Modern OSC replacement, 188 stars.
• mpv-osc-tethys - OSC replacement with seekbar thumbnail preview, 94 stars.

Subtitle

• autosub - Automatic subtitle downloading, 200 stars.
• sub-select - Advanced conditional subtitle track selector, 40 stars.

Learning

• mpvacious - Add keybindings to create Anki flashcards for (language) learning, 286 stars.
• interSubs - Interactive subtitles, instantly translate selected word/sentence, 159 stars.
• immersive - Language learning script for looking up words generating Anki flashcards, 55 stars.
• sub-scripts - Automatically pause after each subtitle line and skipping intervals between subtitles, 44 stars.

Streaming

• sponsorblock - Script to skip sponsored segments of YouTube videos, 379 stars.
• quality-menu - Change the streamed video and audio quality (ytdl-format) on the fly, 39 stars.
• youtube-download - Download youtube audio and video with one key press, 37 stars.
• youtube-upnext - Play "up next"/recommended YouTube videos, 36 stars.
• streamsave - Save live streams without encoding, 30 stars.
• ytdlautoformat - Auto change ytdl-format for Youtube and Twitch, 29 stars.

Image

• thumbfast - High-performance on-the-fly thumbnailer for mpv, 141 stars.
• crop_script - Take cropped screenshots, 81 stars.
• gif-generator - Creates animated gifs using hotkeys, 33 stars.
• auto-mode - Use mpv as music player and image viewer.

Video Editing

• trim - Trim clips without transcoding, 65 stars.
• easycrop - Cropping videos with ease, 64 stars.
• videoclip - Easily create video and audio clips in a few keypresses, 49 stars.
• video-splice - Video cutting, 35 stars.

Social

• Discord RPC - Discord Rich Presence integration, 112 stars.

Configuration

• persist-properties - Keep selected property values (like volume) between player sessions, 55 stars.

Script collection miscellaneous

• occivink - 298 stars.
• Eisa01 - 211 stars.
• jonniek - 140 stars.
• CogentRedTester - 118 stars.
• detuur - 38 stars.
• stax76 - 26 stars.
• Seme4eg - 11 stars.
• dyphire - 7 stars.
• misc.lua

Other

• mpv-webm - WebM converter based on MoonScript.

Music Player

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

Mobile Player

• mpv-android - For Android, 1.1k stars, based on Kotlin.

Media Center

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

Streaming

• Macast - DLNA Media Renderer. You can push videos, pictures or musics from your mobile phone to your computer, 4.3k stars, based on Python/Web.
• jellyfin mpv shim - Jellyfin (Emby/Plex alternative) Client, 1k stars based on Python.
• Botflix/stream-cli - Command-line tool that combines scrapy and webtorrent for streaming movies, 376 stars, based on Python/TUI.
• ff2mpv - A Firefox/Chrome extension for playing URLs in mpv, 334 stars, based on PowerShel/Shell/Python/JavaScript.
• plex-mpv-shim - Cast media from Plex Mobile and Web apps to MPV, 279 stars, based on Python.
• play-with-mpv - Chrome extension for playing URLs in mpv, 278 stars, based on JavaScript/Python/Web.
• qtube - Linux YouTube frontend, 19 stars, 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, 116 stars, based on Golang.
• orion - Unmaintained cross platform Twitch.tv client, 309 stars, based on C++/QT/QML.

Configuration

• MPV_lazy - Full Windows configuration including scripts for Chinese users, 1k stars.
• Glow - Config File Generator for Windows, 237 stars.
• dyphire/mpv-config - Full Windows configuration including scripts for Chinese users, 67 stars.

Social

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

Video Conversion

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

Video Processing

• mpv-prescalers - Prescalers for mpv, as user shaders, 258 stars.

Video Editing

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

Image Viewer

• qimgv - Cross-platform, 1.5k stars, based on C++/QT.
• mpv-image-viewer - Configuration, scripts and tips for using mpv as an image viewer.
• auto-mode

External Tools

• https://add0n.com/external-application-button.html
• https://github.com/Flow-Launcher/Flow.Launcher
• https://github.com/stax76/Flow.Launcher.Plugin.Favorites
• https://github.com/stax76/OpenWithPlusPlus
• https://github.com/ikas-mc/ContextMenuForWindows11

Remote Control

• mpv-mpris - On Linux allows controlling mpv using standard media keys, 450 stars.
• simple-mpv-webui - 115 stars, based on Python/Lua/JavaScript/Web.
• mpv-remote-app - For Android, 68 stars, based on Java/Python.
• mpv-remote-app - For Android, 31 stars, based on Web/VUI/Ionic/Node.js.
• MPVMediaControl - Windows 10 System Media Transport Controls (SMTC), 26 stars.
• Classic remote control: 'One For All Contour URC1210' using Philips code 0556 together with 'FLIRC USB (gen2)'.

Tutorial

• How to Use MPV on Windows
• mpv: The Best Video Player for Language Learning

Building

• Helper scripts to compile mpv on Linux
• Compiling for Windows
• Building mpv and libmpv using wsl2 and Ubuntu
• Media Auto Build Suite (MABS)
• crosscompile-mingw-tedious

Library

• python-mpv - Python interface, 401 stars.
• mpv.js - Embeddable player for Electron/NW.js applications, 377 stars.

Other

• mpv-install - Sets up file associations for mpv on Windows, 379 stars.
• Memento - Cross-platform video player for studying Japanese, 240 stars, based on C++/QT.
• blitzloop - Linux karaoke software, 174 stars, based on Python/OpenGL.
• mpvQC - Cross-platform application for quality control of videos, 34 stars, based on Python/QT.
• vidify - Cross-platform app that detects playing songs on your device and plays their music videos anywhere. 114 stars, based on Python.
• Karaoke Mugen - Cross-platform karaoke management app, based on JavaScript/node.js/Web.