mpv

Automated development build of the latest master branch.

• Version: v0.42.0-38-gbcde6b93c
• Commit: bcde6b93cca4d128d84e1a60d1a6db2cd81c889e
• Built: 2026-11-10 18:41:41 UTC

Windows

Full builds are static mingw-w64 builds with every optional feature, such as DVD and Blu-ray playback. Clang builds are smaller made with the Windows SDK and come with debug symbols, but does not include all optional features.

• x86_64 (full)
• x86_64 (Clang)
• arm64 (full)
• arm64 (Clang)
• i686 (GCC)
• x86_64 (Clang, debug symbols)
• arm64 (Clang, debug symbols)

libmpv (Windows)

libmpv-2.dll with import library and headers. GPL builds are GPLv3, mpv with all its GPL parts and FFmpeg with --enable-gpl --enable-version3. LGPL builds are LGPLv3, made with -Dgpl=false against the LGPL FFmpeg variant, for software that cannot link GPL.

• x86_64 (GPL)
• x86_64 (LGPL)
• arm64 (GPL)
• arm64 (LGPL)

macOS

• x86_64 (macOS 15)
• arm64 (macOS 15)
• arm64 (macOS 26)
• arm64 (macOS 27)

[!WARNING] These are untested development builds of the very latest master. They are not official releases. For stable builds see the latest release.

We are excited to announce the release of mpv 0.41.0.

Key highlights:

• The libplacebo based gpu-next is now the default, instead of gpu
• Vulkan hardware decoding is preferred over other APIs
• New context_menu.lua script for right-click context menus
• AAudio backend for modern, JNI-free audio output on Android
• Improved default color management for gpu-next, and handling on Wayland
• Color representation protocol support for Wayland
• Tablet input support for Wayland
• Clipboard writing support for Wayland and a clipboard backend for X11
• Ambient light support on Linux (using sysfs ALS)
• Built-in helpers to register mpv as a media app on Windows

This release requires FFmpeg 6.1 or newer and libplacebo 6.338.2 or newer.

Features

New

• clipboard-wayland: support clipboard writing
• wayland: add support for wp-color-representation-v1
• wayland: tablet input support
• vo_gpu_next: add support for blend-subtitles=video
• meson: add mpv-register and mpv-unregister helpers on Windows
• context_menu.lua: add this script
• select.lua: add edit-config-file and edit-input-conf
• osc.lua: add indicator for buffering/loading
• osdep/linux-als: support 'ambient-light' property on Linux
• clipboard-x11: add x11 clipboard backend
• ao/aaudio: implement native AAudio backend for Android

Changed

• vd_lavc: prefer Vulkan hwdec when available
• vd_lavc: prefer non-copy hwdec before falling back to -copy variant
• vo: move vo_mediacodec_embed to not be the default on Android
• sub/osd_libass: don't rerender OSD if not changed
• vo: prefer vo_gpu_next over vo_gpu by default
• vo_gpu_next: respect ICC profile color space over any metadata
• vo_gpu_next: linearize sRGB as a pure 2.2 power function
• meson: warn if building with SDL2 due to known problems
• osxbundle: make bundle category configurable and default to video
• ao_pipewire: avoid setting any media.role by default

Options and Commands

Added

• sub: add control for libass caching options (glyph-limit, bitmap-max-size)
• vo: add options to control background tile appearance (transparency)
• command: add default and forced flags to the track add commands
• vo_gpu_next: add options to control subtitle peak for HDR output
• video/out/d3d11: add d3d11 composition mode support
• vd_lavc: add --hwdec-threads
• stream_bluray: add --bluray-angle
• vo_gpu_next: add options to control output colorspace metadata more precisely
• sub: make --sub-fix-timing configurable
• vo_gpu_next: add --hdr-reference-white
• audio/out: add --audio-set-media-role

Changed

• options: revert --prefetch-playlist default back to 'no'
• vo_gpu_next: change --target-colorspace-hint to 'auto' by default
• options: handle runtime --wid change
• options: reduce swapchain-depth to 2 by default
• screenshot: add osd and scaled flags to screenshot commands

Fixes and Minor Enhancements

• vo_kitty: add auto-multiplexer-passthrough option
• vd_lavc: enable FFv1 hwaccel by default
• clipboard-wayland: prevent reading from hung up fd
• demux_mkv: fix compilation after deprecated definitions removal
• filters: handle flipping video if displaymatrix indicates so
• player/scripting: fix race condition when destroying clients
• {osd,msg}: use PU codepoints for escape codes instead of invalid UTF-8
• vo_dmabuf_wayland: only load needed hardware decoding drivers
• video/image_writer: tag accurate bit depth
• demux_lavf: fix unconstrained cache size with wrapped AVFrame packets
• libarchive: fix reading name of certain UTF-8 files
• sub/sd_lavc: fix decoding with libaribb24
• ao_avfoundation: fix memory leak
• osc.lua: fix volume icon not updating while paused
• context_wayland: implement target_csp for wayland
• vo_gpu: fix target colorspace for redrawn frames
• vo_dmabuf_wayland: don't set HDR metadata on SDR transfers
• vo_gpu_next: don't do partial updates on hint luminance
• sub/ass_mp: add missing paddi

We are excited to announce the release of mpv 0.40.0.

Key highlights:

• Console: Enhanced autocompletion and visual styling
• OSC: New selection menu accessible by right-clicking common buttons
• HDR is now natively supported when using direct rendering (DRM), as well as dmabuf-wayland on Linux
• Native clipboard access for scripts via new clipboard property
• New command menu, with common actions easily accessible
• Enhanced select.lua with new selection options for watch history, editions, DVD/Blu-Ray titles
• New positioning.lua script script for cursor-centric zooming and drag to pan
• Better stream support for Blu-ray, DVD and CDDA
• Track selection improvements and better metadata display
• Added osd-box / sub-box / box profiles to easily enable box styled OSD/OSC
• Windows support in umpv helper script

This release requires FFmpeg 6.1 or newer and libplacebo 6.338.2 or newer.

Features

New

• vf_d3d11vpp: add NVIDIA RTX Video HDR support
• context_drm_gl: add support for HDR metadata
• positioning.lua: add new script for video alignment and zooming
• umpv: add Windows support
• command: add clipboard property with native backends for Windows, macOS, and Wayland
• select.lua: add watch history, edition, DVD/Blu-Ray titles and more selection options
• input.conf: add cursor-centric zoom and drag-to-pan bindings
• wayland: add support for wp-color-management-v1 protocol
• console.lua: add persistent command history
• stats.lua: add timecode display
• options: add --playlist-exts and --archive-exts
• wayland_common: support IME usage via text-input-v3
• command: add multiple track metadata and properties
• vo_gpu_next: add chroma location and HDR metadata to shader parameters
• player/screenshot: support more formats for screenshot-raw command
• demux_mkv: add --demuxer-mkv-crop-compat option
• misc/language: parse hi/sdh/cc tags from external subtitle tracks
• wayland: support xdg-activation
• player: add mpv:// protocol

Changed

• meson: build libmpv by default
• command: enhance track and playlist display information
• input.conf: improve numpad key bindings
• osc.lua: add custom buttons support and improved mouse bindings
• console.lua: inherit OSD styles and colors
• options: default to --prefetch-playlist=yes
• osc.lua: add slimbottombar and slimtopbar layouts
• command: improve frame-step to go through multiple frames
• wayland: use wp-presentation v2 if available
• various: reorganize options into more logical groups
• vo_gpu_next: improve target colorspace handling
• options: disable --input-ime by default (enabled on demand)

Options and Commands

Added

• sd_ass: introduce sub-ass-prune-delay
• player: add an optional mute flag when framestepping
• command: add clipboard/text-primary property
• command: add current-clipboard-backend property
• command: add notify-property command
• options: add --script-opt alias for --script-opts-append
• options: add --osd-bar-marker-{size,style} options
• options: add --input-ime for improved text input
• options: add --video-recenter
• options: add --clipboard-backends
• options: add --wayland-internal-vsync
• options: add --sub-scale-signs

Changed

• options: rename --load-osd-console to --load-console
• player: improve track selection for multi-component languages
• options: improve frame-step command to handle multiple frames
• input.conf: make Alt+BS reset --video-align-{x,y}
• command: print track metadata when changing track
• command: print track-list with enhanced metadata

Deprecated

• options: deprecate --gamma-auto (use gamma-auto.lua script instead)
• options: deprecate undocumented --cdda-span-{a,b} options

Fixes and Minor Enhancements

• f_hwtransfer: ensure that we convert to full range rgb with scale_vaapi
• win32: fix window size restore after maximize state
• build: fix dynamic generation of mpv.desktop file protocols

We are excited to announce the release of mpv 0.39.0, with more than 5 months of development since the last version. This release brings numerous improvements and fixes across nearly all components.

Key highlights:

• A new select.lua script, allowing users to easily choose files from playlists, tracks, chapters, output devices, and more.
• A native replacement for autoload.lua has been implemented. See --autocreate-playlist in the manual.
• NVIDIA RTX and Intel VSR scaling are now supported via the d3d11va filter.
• Media controls are now supported on Windows.
• Track selection has been improved, especially for multi-component languages like fr-CA.
• A new fifth page has been added to stats.lua, displaying track information.
• Compatibility with dmabuf-wayland has been significantly enhanced.
• Multi-touch support has been introduced.

This release requires FFmpeg 6.1 or newer and libplacebo 6.338.2 or newer.

Features

New

• vf_d3d11vpp: add support for Intel VSR and NVIDIA RTX scaling modes
• demux: add --autocreate-playlist
• audio: add pitch-shifting feature
• win32: add Media Control support
• various: allow changing GPU API options at runtime
• vo_gpu_next: support --gamma-factor
• vf_vapoursynth: upgrade to VapourSynth API v4
• select.lua: add this script
• console.lua: implement a command parser to complete more things
• demux_mkv: demux Block Additional Mappings
• cocoa-cb: add support for macOS color space transformation (EDR/HDR)
• powershell-completion: add PowerShell command line completion
• input: implement VO dragging deadzone
• win32: support multitouch
• wayland_common: support multitouch
• demux/packet: add support for ITU T.35 metadata in Matroska
• demux: support VVC Matroska demux
• terminal-win: support mouse input events
• x11_common: detect wm support for _NET_WM_STATE_SKIP_TASKBAR

Changed

• loadfile: improve the format of terminal track information
• options: add secondary-{sid,sub-delay} to watch_later_options
• input: map Num 5 to distinct value when numlock is off
• input.conf: make Alt+BS reset panscan
• msg: don't use bold colors and instead use bright ones

Options and Commands

Added

• sub: add ass-video-aspect-override option
• input/keycodes: add KP_ADD/SUBTRACT/MULTIPLY/DIVIDE keycodes
• demux_playlist: use --directory-filter-types for --autocreate-playlist
• options: add --{video,audio,image}-exts
• player: don't decrement --ab-loop-count=N and add remaining-ab-loops
• player: don't decrement --loop-file=N and add remaining-file-loops
• sub: add (sub/osd)-border-style; renaming sub options
• input.conf: add zoom, pan, scale and rotate keybinds for numpad
• wayland: add a --wayland-present option
• mac/menu: add option to disable default shortcuts
• stats.lua: display file tags
• osc.lua: add option to use display fps for update interval
• osc.lua: add option to make rendering smoother
• opengl: add --egl-output-format, --egl-config-id
• vf_vapoursynth: add parameter to pass arbitrary string to script
• options: add --osd-playlist-entry
• {osc,stats}.lua: add 'auto' value to vidscale option
• input/cmd: add nonrepeatable prefix
• player: add option-info/<name>/expects-file
• command: add dolby-vision-profile and dolby-vision-level to track-list
• scripting: add mp.input.select()
• command: add normalize-path command
• OSC: implemented user configurable colors
• ao_wasapi: add --wasapi-exclusive-buffer option
• stats.lua: add option to disable scale with video size
• stats.lua: add option to control plot border width
• player/command: add track-list/N/decoder
• sd_ass: add sub-vsfilter-bidi-compat to enable vsfilter bidi compat
• {x11,w32}_common: implement --show-in-taskbar option

Changed

• sub: merge vsfilter-aspect and vsfilter-blur-compat options
• input.conf: swap the positions of values for ctrl+h binding
• video/csputils: remove space from choice option for