whatisgithub

What is mpv-media-engine?

ddinh99/mpv-media-engine — explained in plain English

Analysis updated 2026-05-18

9GLSLAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A companion desktop app that adds a visual control panel with shader, HDR, and equalizer controls to the MPV video player.

Mindmap

mindmap
  root((MPV Media Engine))
    What it does
      Visual control panel for MPV
      Real time shader toggling
      Parametric audio equalizer
    Tech stack
      Flutter
      GLSL
      Windows
    Use cases
      Adjust video shaders live
      Tune a 7 band equalizer
      Tone map HDR to SDR
    Audience
      Home theater enthusiasts
      MPV power users
    Install
      Download release zip
      Build from source with Flutter

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Adjust MPV video shaders and scalers visually without editing config files

USE CASE 2

Fine tune a seven band audio equalizer while watching the frequency curve update

USE CASE 3

Convert HDR video for a standard screen or the reverse using tone mapping controls

USE CASE 4

Downmix 5.1 or 7.1 surround sound to stereo on the fly

What is it built with?

FlutterGLSLFFmpegWindows

How does it compare?

ddinh99/mpv-media-engineelisaliman/ghostty-shaderszalo/locuslucis
Stars9153
LanguageGLSLGLSLGLSL
Last pushed2023-07-11
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity2/51/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Building from source requires the Flutter SDK and a running MPV instance with IPC enabled, Windows only.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

MPV Media Engine is a desktop app that adds a visual control panel to MPV, a free video player, letting you adjust picture and sound settings while a video is playing instead of editing text configuration files. It runs as a separate window alongside MPV and sends changes to it instantly over a local connection, so it works well on a second monitor while the video itself stays clean and free of on-screen menus. On the video side, it lets you turn visual filters, called shaders, on and off to sharpen or upscale the picture, and it automatically groups filters that work well together based on the resolution of what you are watching. It includes controls for smoothing motion on high refresh rate screens, tuning how the picture gets resized, converting bright HDR video down for a normal screen or the other way around, adjusting brightness, contrast, and color saturation, and reducing color banding on lower quality video. It can also turn on GPU based video decoding to lower strain on your computer's processor, and it comes with a set of one click presets for things like anime, live action, and HDR content. On the audio side, it provides a seven band equalizer with sliders you can drag while watching the frequency curve update live, a dynamic volume leveling mode that keeps quiet dialogue audible without loud scenes becoming overwhelming, ready made equalizer curves modeled on popular headphone and speaker brands, and the ability to downmix surround sound audio tracks like 5.1 or 7.1 down to plain stereo. The app remembers your equalizer settings, active filters, and chosen presets between sessions, and it includes a debug view showing the raw messages passing between the app and MPV. It is built with Flutter and currently works on Windows. Most people should just download the ready made program from the releases page and run it, though it can also be built from source if you have the Flutter tools installed and a running copy of MPV with its remote control feature turned on. The project is released under the MIT license, which allows free use, including commercial use.

Copy-paste prompts

Prompt 1
Help me download and run MPV Media Engine alongside my MPV player on Windows
Prompt 2
Walk me through setting up a 7 band equalizer preset for my headphones
Prompt 3
Explain how to enable GPU hardware decoding for 4K video in this app
Prompt 4
Show me how to build MPV Media Engine from source using Flutter

Frequently asked questions

What is mpv-media-engine?

A companion desktop app that adds a visual control panel with shader, HDR, and equalizer controls to the MPV video player.

What language is mpv-media-engine written in?

Mainly GLSL. The stack also includes Flutter, GLSL, FFmpeg.

What license does mpv-media-engine use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is mpv-media-engine to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mpv-media-engine for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.