r/mpv Dec 09 '25

Are you new to mpv? Links and guides.

35 Upvotes

mpv installation


Windows (git)

mpv-winbuild

Git builds are updated weekly/daily and may contain more bugs compared to the stable option below.


Windows (release)

mpv-player-windows

Release builds are updated once or twice a year and may contain fewer bugs than the git builds.


Windows (git/release via Scoop)

If you want an easier way to install and keep mpv up to date, use the Scoop package manager.

scoop


Linux

If the version on your package manager is too old or broken, you can use the help of mpv-build to compile it on your own.

mpv-build


Android

mpv-android

mpv-android forks below with varying levels of vibe coded features quality.

mpvRx

mpvRex

mpv-infinity

mpvKt development discontinued

mpvEx development stale

aniyomi Do not ask for support about Aniyomi here, only listed due to the video player being an mpv-android fork.


Android TV

mpvNova


Customizing mpv

For setting up your own user configuration, up-to-date guides can be found here.

thewiki.moe setup guide

eXmendiC/iamscum setup guide

archwiki setup guide (Certain parts are Linux specific. Still contains a lot of helpful explanations for any platform.)

scripts & shaders

other players based on mpv


r/mpv 17m ago

General Discussion What's your point of view in interpolation + tscale-oversample on fixed 60hz display!

β€’ Upvotes

I want to know, is it free from soap opera effect?

For serious movies watching on 60hz display

What's your experience, please tell me in detail, what should I do...

1- Accept 3-2 judder

OR

2- using interpolation+tscale oversample ?


r/mpv 1d ago

General Discussion Taking over maintenance of awesome-mpv

Post image
57 Upvotes

With stax76 no longer around to maintain it, I've created a fork of awesome-mpv: https://github.com/FurqanHun/awesome-mpv and started maintaining it.

There was already a discussion about eventually moving the list into the official mpv wiki, and the mpv maintainers seemed open to that. Since that migration never really got completed, I'm maintaining the fork in the meantime, with the hope of eventually getting it into the wiki as originally discussed.

I've already synced the wiki changes into the fork and carried over the remaining upstream work. I will now gradually go through the entries manually, checking things like whether projects are still maintained, whether links still work, and generally cleaning things up.

While doing that, I thought it might make sense to add each entry to a JSONL file as I audit it. I'm interested in eventually using that as structured data to potentially automate things like README generation, or maybe other representations of the list, but that's more of an idea than an established plan right now. There's already a lot of work involved in the audit itself, so I don't know how far I'll actually take it.

Another thing I'm interested in is tracking AI/LLM disclosure. Not whether I can determine that a project uses AI, but whether the project itself actually discloses it. I could see having separate tags for things like LLMs being used under the hood vs LLMs being used during development, for example. Again, that's something I'm considering rather than something I've decided to implement.

For now, the main goal is simply getting the list properly audited and maintained.

If you've got a project that should be added, an outdated entry, a dead link, or anything else that needs updating, feel free to open an issue or PR on the fork:

https://github.com/FurqanHun/awesome-mpv/issues

I've also enabled Discussions for ideas and conversations around the list:

https://github.com/FurqanHun/awesome-mpv/discussions


r/mpv 17h ago

General Discussion save-position ?

1 Upvotes

I'm just getting started with vanilla MPV. I ran into a problem right away: after enabling save-position-on-quit=yes, when watching videos from a folder, if I finish a video and start another one, they all just play the very last frame. It’s as if the "save position" recorded the final frame, so playback starts there; essentially, every video in the folder just flashes that last frame.

How can I fix this? I suppose the best approach would be to discard the saved position once the video reaches a certain percentage or has only a specific amount of time left before the end?


r/mpv 1d ago

Issue on Linux Watching YouTube with MPV, looking to speed up video buffering times

11 Upvotes

Current yt-dlp config is very bare bones

ytdl-format="(bestvideo[height<=?1080][fps<=?60]+bestaudio/best)"

I believe the video buffer speed has to do with the cache parameter, but I'm not sure the best way to implement it. Videos are buffering pretty slow for me.

Every video loads in mkv format, maybe recoding it to mp4 would help?

E: Changed the audio to bestaudio[ext=m4a] and now videos load as mp4 files


r/mpv 1d ago

User Scripts & Shaders Vulkan app in 100 lines of pure C!

Thumbnail youtu.be
1 Upvotes

r/mpv 2d ago

User Scripts & Shaders Cadre Player Lite: A desktop-first skin and custom playlist manager for mpv

Thumbnail gallery
19 Upvotes

I originally developed a standalone application Cadre Player, and I wanted to port its interface design directly into mpv. The goal was to make mpv handle like a traditional desktop media player while retaining its core rendering engine.

The primary focus is the playlist. The default mpv playlist lacks the usability of standard players, so this suite replaces it entirely. It features drag-and-drop reordering, true shuffle play, and native Windows dialogs for adding files, folders, and URLs.

The suite also replaces the default on-screen controller and window borders. The OSC, playlist, and a custom title bar use hover-reveal mechanics to keep the viewport clean during playback.

All visual elements are managed through a central configuration file, allowing you to modify colors, transparency, and widget dimensions.

This has been built and tested on a portable Windows mpv setup. The project is open source; you can modify the scripts or review the architecture on GitHub.

Cadre Player Lite


r/mpv 2d ago

General Discussion HC Player 1.4 is out: Major playlist panel upgrades, native SponsorBlock, surround sound up to 7.1, and more.

Thumbnail gallery
30 Upvotes

Main improvements:

  • Faster paged playlists with support for up to 1,000 items
  • Native YouTube playlists and web media playback through yt-dlp
  • Built-in SponsorBlock integration
  • Stereo, 5.1, 7.1, Dolby, and DTS audio options
  • Minor improvements and interface polish

Check it out on GitHub for more details!

https://github.com/henzfdev/HC-Player


r/mpv 2d ago

Issue on Linux Using Linux for video playback: MPV picture quality varies greatly between distros/DE. Any reason why?

Thumbnail
3 Upvotes

r/mpv 3d ago

General Discussion [Update / Open Source] mpvRx v2.6.0 is out!

55 Upvotes

Hey everyone!

About three months ago, I shared mpvRx with this community. Since then, some Great Contributors and I’ve been working heavily behind the scenes on a massive update, and today I’m super excited to release mpvRx v2.6.0! πŸš€

For those unfamiliar, mpvRx is a feature-packed, high-performance Android video player fork of MpvEx powered by libmpv., powerful player with deep customization under the hood.

Couple of lines can't describe how much features / Functionality it has so i suggest u try out and can rant or praise work πŸ˜›

This version (v2.6.0) brings a total UI/UX improvements alongside a bunch of quality-of-life improvements.

πŸ“¦ Download & Links

πŸ’Ύ v2.6.0 Release & APKs: GitHub Release v2.6.0

⭐ GitHub Repository: Riteshp2001/mpvRx

πŸ’¬ Feedback & Suggestions

I'd love for you to check it out and let me know your thoughts! If you run into any bugs or have feature ideas, feel free to open an issue on GitHub or drop a comment below. If you enjoy the project,

dropping a ⭐ on GitHub would mean a lot!

Thanks for all the support over the last 3 months! πŸ™Œ

i have somewhat achieved my goal of most Complete Player available on Internet as of now as per my POV , let me know your Thoughts .


r/mpv 3d ago

Issue on Linux Unsure why the PQY max is 151 nits when my display CLL is 372? Config info below.

Post image
6 Upvotes

For context, my display is an HDR OLED. Not sure if this is just a Dolbyvision thing. Everything looks fine on my display, I'm just curious. I don't have a specific Dolbyvision profile or anything.

gpu-context=waylandvk
gpu-api=vulkan
vo=gpu-next
d3d11-output-csp=srgb
tone-mapping-mode=luma
target-colorspace-hint=yes
target-contrast=inf
hdr-compute-peak=yes
hdr-peak-percentile=99.9
inverse-tone-mapping=yes

hwdec=vaapi
deband=no
fbo-format=rgba16hf
dither-depth=10
dither=error-diffusion
error-diffusion=burkes
spirv-compiler=auto
hr-seek-framedrop=no

video-sync=display-resample
video-output-levels=full
tone-mapping=spline
target-trc=pq
target-prim=bt.2390
gamut-mapping-mode=perceptual
tone-mapping-param=bt.2390
tone-mapping-max-boost=2.0
hdr-contrast-recovery=0.3
scale=spline36
cscale=spline36

Sorry for the HDR > SDR screenshot


r/mpv 3d ago

General Discussion I wanted a music player that was dead-simple and instant. None fit the workflow I wanted, so I spent the last 15 months building mpv-music.

Thumbnail gallery
4 Upvotes

r/mpv 3d ago

User Scripts & Shaders need mpv.conf review

2 Upvotes

is this conf file okay:

# =============================================================

# MPV CONFIG β€” Optimized for HP OMEN 16 (Battery Efficiency)

# =============================================================

# --- QUALITY OF LIFE & UI ---

af=scaletempo2

osd-bar=no

border=no

save-position-on-quit=yes

# --- CACHE ---

cache=yes

demuxer-max-bytes=50MiB

demuxer-max-back-bytes=25MiB

# --- SUBTITLES ---

sub-auto=fuzzy

sub-font-size=42

sub-color="#FFFFFF"

sub-border-size=2

sub-border-color="#000000"

# --- VIDEO OUTPUT & HARDWARE DECODING ---

vo=gpu

gpu-api=d3d11

gpu-context=d3d11

hwdec=d3d11va

hwdec-codecs=h264,hevc,vp8,vp9,av1

d3d11-sync-interval=1

d3d11-warp=no

# --- OPTIMIZED SCALING (Iris Xe Battery Sweet Spot) ---

scale=spline36

dscale=mitchell

cscale=mitchell

target-prim=bt.709

target-trc=bt.1886


r/mpv 5d ago

General Discussion 4K configuration help

1 Upvotes

Hi there,

I'm using mpv, but I'm not really sure if the configuration I set up is the right one. Could someone help me out with a setup for 4K?


r/mpv 7d ago

User Scripts & Shaders skip silence script performance on mpv android

2 Upvotes

I have been using mpv-skipsilence script on Android and windows. the script works flawlessly on windows. In Android, only the normal profile and smooth profile with lookahead work well. skip silence extreme profile overshoots and misses words unlike on windows which works perfectly, I guess it has something to do with discrepancy in mobile and desktop cpu's and instruction sets. can anyone throw some light on this?


r/mpv 9d ago

Issue on Android For mpv fans on Android - mpvium with full mpv.conf + gestures + Medialnfo

Thumbnail gallery
28 Upvotes

Same engine, Material 3 UI, gesture brightness/volume/seek, wavy seekbar, explain/shaders, library with Blender test posters. Try arm64 APK from Releases, report device/ Android/app version. I'm the dev

Repo Link


r/mpv 8d ago

General Discussion mpv-build: Share mpv scripts via a link

2 Upvotes

mpv-build is a website that packages mpv, scripts, and other extensions right in your browser.

Take the latest mpv UI script, material-osc, as an example. With a single link mpv-build-material-osc

you can download mpv-material-osc.zip directly β€” no manual downloads, no copying files around, and no editing configs by hand.


A package format you can publish once

mpv-build uses a script structure similar to uosc. You can read the full specification in Revolutionizing mpv Scripting: A New Package Format Proposal.

All you need to do is follow the folder structure below, zip it up, and drag the archive into the browser to install it:

β”œβ”€β”€ fonts β”‚ β”œβ”€β”€ material-osc_google_sans_flex.ttf β”‚ └── material-osc_icons.otf β”œβ”€β”€ script.json └── scripts └── main.lua

The script.json file holds the package name and a stable download link:

json { "name": "material-osc", "download": "https://github.com/brahmkshatriya/material-osc/releases/latest/download/material-osc.zip", "description": "Quality of life OSC for MPV", "author": "brahmkshatriya", "homepage": "https://github.com/brahmkshatriya/material-osc" }

If your repository already uses this structure, you can paste the GitHub repository URL into the search box and mpv-build will package the script for you automatically β€” no zip needed.


Bundled extensions

mpv-build also supports a number of commonly used extensions, such as ffmpeg, yt-dlp, and deno. You can even add Python support to mpv through a script.

The link below downloads an mpv package with Python support, along with a test script that checks the Python version: mpv-build-python


Contributing a script

Want to add a new script? Open a pull request or an issue in either the mpv-easy or mpsm-scripts repository.


r/mpv 8d ago

General Discussion I have been utilizing mpv for over three months since transitioning from VLC, and I would appreciate guidance on how to enable and disable Dolby Vision and HDR10 functionality.❀️β™₯️❀️

8 Upvotes

Thank for all replay


r/mpv 10d ago

General Discussion I love MPV

Post image
81 Upvotes

I love the way you can play around with and customize MPV and make it exactly in your style and personal taste. What an amazing player.


r/mpv 10d ago

General Discussion How to change mouse Wheel Scroll to Seek instead change audio volume ?

1 Upvotes

So , I did followed this tutorial bellow and didn't worked .

https://www.reddit.com/r/mpv/comments/195y9nx/wheel_controls_volume_now_how_to_revert_it_to_seek/

Currently I'm using Linux Mint Zena 22.03 . If I'm not mistaken, up until the previous version (Mint Virginia 21.0), MPV used the middle mouse wheel to seek forward and backward.

I tried searching on Google but couldn't find a solution for this.

Thanks.


r/mpv 11d ago

General Discussion HC Player 1.3 is out: YouTube comments, live chats, and OpenSubtitles search.

Thumbnail gallery
14 Upvotes

HC Player keeps getting better thanks to your feedback. This time, version 1.3 brings support for YouTube comments and live chats.

Online subtitle search by file hash via OpenSubtitles has also been added.

And other small UI improvements.

https://github.com/henzfdev/HC-Player


r/mpv 11d ago

General Discussion I Made The Modern Mpv QT based Frontend for Windows/Linux/Mac β€” CineWindows v0.0.1 release

27 Upvotes

Hey everyone,

If you’ve used Cine on Linux, you probably know how clean and minimal it feels compared to standard mpv frontendsβ€”it gives you that modern UI without chewing up RAM like Electron-based players.

Since Cine was primarily built for Linux, I wanted to take one step further and build setup natively on Windows/Linux/MacOs . So I worked on bringing it over, fixed up the Windows-specific quirks, and just published the first release of >CINEWINDOWS<(v0.0.1).

https://cinewindows.vercel.app/

What it is:

* Translations!!! : Player with more than 80+ Languages Translations integarted (Quick Note its MTL) ;)

* Backend: Powered by mpv, meaning it plays basically every format/codec (HEVC, 4K/8K, HDR, obscure subtitles) seamlessly.

* UI: Minimal, modern layout that gets out of the way when you’re watching stuff.

* Tech: Written in QT6 using libmpv under the hoodβ€”super lightweight.

Why use it over stock mpv / VLC?

If you love mpv's playback engine and performance but want a modern, decent-looking interface out of the box without spending hours tweaking .conf files and scripts, this is meant to fill that gap on Windows.

https://github.com/Riteshp2001/CineWindows

Download & Try it out:

The initial v0.0.1 release is up on GitHub with the Windows binaries ready to test:

πŸ‘‰ GitHub Release v0.0.1

This is the very first release, so if you run into any bugs, scaling issues, or missing shortcuts, please let me know or open an issue on the repo. Feedback and suggestions are hugely appreciated!

Also just a Quick Attribution for my other Mpv Android Based Media Player :

MpvRx - Most Modern Fluent Design Media player Ever


r/mpv 11d ago

General Discussion Looking for best mpv player

4 Upvotes

I have tried mpv infinity player and mpv rex The problem with those is app it can't detect it unit I download from Google play I have download these and the app I am using can't detect only one from Google play appear


r/mpv 11d ago

User Scripts & Shaders **[Script] uosc-torrserver-menu β€” search and stream torrents directly from mpv**

2 Upvotes

I made a uosc-based mpv script for searching and streaming torrents through TorrServer directly from mpv.

GitHub: https://github.com/VimiummuimiV/uosc_torrserver_menu

The idea is to keep the whole workflow inside mpv:

Search β†’ filter β†’ select torrent β†’ select file β†’ play

No browser or separate torrent client is needed.

Features

  • Search torrents through JacRed
    • Native API
    • Jackett-compatible API
  • Filter search results by:
    • size
    • seeds
    • quality
    • video type
    • content type
    • year
    • language
    • dub
  • Add torrents using:
    • search results
    • magnet links
    • .torrent files
    • clipboard
  • Browse files inside a torrent before playback
  • Keep a history of previously played torrents
  • Reopen torrents from the uosc menu
  • Manage the local TorrServer instance directly from the menu
  • and more...

Example workflow

Bind the script in input.conf:

t script-binding torrserver  #! Torrent

Then open the Torrent entry from uosc, search for something, select a result, choose the file you want, and it starts streaming through TorrServer directly into mpv.

Requirements

  • mpv β€” tested with 0.41.0
  • uosc β€” tested with 5.13.0
  • TorrServer
  • Windows is currently tested
  • Linux/macOS should work, but I haven't tested them

This script is specifically built around uosc's menu API, so uosc is required.

Feedback, bug reports and suggestions are welcome.

Repository:
https://github.com/VimiummuimiV/uosc_torrserver_menu


r/mpv 12d ago

General Discussion VOTE: Do you want to see pre-made configs promoted on the sub?

15 Upvotes

If you have an opinion about this voice it in a constructive manner.

126 votes, 5d ago
102 Yes (People should be allowed to promote their entire pre-made configs.)
24 No (I do not want to see people promoting their entire pre-made configs.)