mpv 0.40.0 has been released!

[sfan5]

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
• player/sub: avoid pointlessly redecoding subs
• x11: remove nvidia blacklist logic from --x11-present=auto
• osc.lua: seek to the nearest chapter when right clicking the seekbar
• command: fix keybind command with sequence keys
• video/out/wayland_common: fix crash with multi-seat drag and drop
• demux: reclaim demux_packets to reduce memory allocator pressure
• demux_cue: only accept TRACK with AUDIO type
• player/loadfile: strip common filename part from external track title
• build: remove unused dvdread dependency
• wayland: fix vertical resizing and scaling issues
• console.lua: improve completion and visual appearance
• sub/osd: default to a semitransparent black back color
• player: improve playlist handling with prefetch
• drm: parse EDID using libdisplay-info (which is now a required dependency)
• win32: fix window size restore after maximize state
• hwdec_d3d11va: align image mapper dimensions to a multiple of 2
• wayland: fix DnD with focus follow mouse
• player: store external filenames as normalized
• player: properly handle secondary subtitles on the terminal
• demux_mkv: add support for chroma location
• vo_dmabuf_wayland: improve and fix format selection
• player: fix combination of --loop-playlist + --shuffle + --prefetch-playlist

This listing is not complete. Check DOCS/client-api-changes.rst for a history
of changes to the client API, and DOCS/interface-changes.rst for a history
of changes to other user-visible interfaces.

A complete changelog can be seen by running git log v0.39.0..v0.40.0
in the git repository or by visiting v0.39.0...v0.40.0.

[HurricanePootis]

HDR is now natively supported when using direct rendering (DRM),
as well as dmabuf-wayland on Linux

So, I've been using HDR in the past by first installing vk-hdr-layer-kwin6-git, then setting mpv to use vo=gpu-next hwdec=auto gpu-api=vulkan gpu-context=vulkan-api target-colorspace-hint

Does this mean that I no longer have to use a Vulkan HDR layer to view HDR content on mpv?

[kasper93]

You still need --target-colorspace-hint. In fact for gpu-next with vulkan, nothing changes on mpv side. Except that layer is integrated into mesa instead of external.

[HurricanePootis]

Oh cool. Thanks for the info!

[llyyr]

Unrelated to mpv but you should probably remove vk-hdr-layer-kwin6-git once you have Mesa 25.1 installed.

[ccicnce113424]

What about NVIDIA?

[ghost]

I found this post while looking into getting HDR working with my setup. mesa is 25.1.1 and I'm running mpv without any graphical login session, i.e. I'm launching stuff via ssh.

This works for me at the moment:

vo = gpu-next
hwdec = auto
gpu-context = drm
target-colorspace-hint = yes
drm-connector = DP-10
drm-mode = 3840x2160@60.0
drm-format = xrgb2101010

The display then signals HDR operation is active.

I also tried these settings:

vo = gpu-next
gpu-context = displayvk
gpu-api = vulkan
hwdec = vulkan
target-colorspace-hint = yes
vulkan-display-display = 1
vulkan-display-mode = 0
vulkan-display-plane = 10

That's essentially the DRM config, i.e. it's the same display/connector and the same mode. However the display doesn't signal HDR. I suspect that mpv 0.40.0 doesn't yet support HDR with the displayvk context? Or am I just doing something wrong here?

[Solarunit]

Better stream support for Blu-ray, DVD and CDDA

seeking was improved too? #13345

[zhengqwe]

It seems yes.

[Solarunit]

very cool if true. It was like the biggest issue for me.

[Solarunit]

In some cases I still can see colorful artifacts when seeking, but in most cases it works nice in my testing, nice!

[Slawa79]

Why is there no player file? Why can't the player be downloaded from here, from GitHub???

[zhengqwe]

https://mpv.io/installation

[Slawa79]

I'm sorry, I made a mistake, confused it with the android version.

[laichiaheng]

Is there any difference in image quality with dmabuf-wayland and gpu-next?

[llyyr]

dmabuf-wayland is generally worse (or equivalent to scale=bilinear with gpu/gpu-next). Probably also worse in other ways too, it's meant to be a power efficient VO.

[kasper93]

dmabuf-wayland can be considered "passthrough" output. mpv doesn't do any processing, only color conversion if needed, but it should be avoided if possible. The implication is that more processing is done on compositor side, which is likely lower quality that what gpu-next offers. Especially the scaling and tonemapping.

[barraIhsan]

Native clipboard access for scripts via new clipboard property

So for now writing to clipboard is only supported on Windows right? as the docs stated. Would love to support mac and linux (wayland and x11 probably) soon. But for now the best approach I think it's just use their os' equivalent clipboard command (wl-copy, xclip, etc.)

[Solarunit]

Also congrats with the release! My favorite Video player for Linux! 👍

[Joshix-1]

Love your work!

the mpv:// protocol is a good idea, but i think the current implementation is flawed.

Putting mpv:// in front will likely result in invalid urls. That can be annoying when using stuff that parses urls.

For a browser extension I worked on we first did the same. Until someone realised that it's better to put the data in the hash. Like mpv://watch#.

[deuteros-gex]

Could you kindly explain how to use the current builtin mpv:// ?
I installed mpv for windows, and typed mpv://file://C:\01.mkv in the browser, the player wouldn't be launched.

[Solarunit]

I tried a bit mpv 0.40. Nice improvements with OSD menus! 👍

• is there a way to open subs/audio track menu via hotkey? Or set custom hotkey

[kasper93]

mpv is vim among media players.

[barraIhsan]

did you mean leader key on vim?
no, you can chain hotkey on mpv for some reason i think.
You can even do multiple like t-e-s-t.
But it will NOT work if you have any of the key assign (in that case is t, e, and s)

[guidocella]

I took g from vim key bindings of course. You can also think of it as "go".

[Solarunit]

or like tmux prefix key. Anyway I prefer to have a single key shortcuts for subs ans audio.

[barraIhsan]

I took g from vim key bindings of course. You can also think of it as "go".

owh yea, many thing are prefix with g like gj for going one wrapped line down, and g ctrl a to increment in a bulk etc. didn't notice it lmao

[Solarunit]

Speaking of OSC, I think it would be nice not to change its size when you minimize mpv window.

[guidocella]

--osd-scale-by-window=no or --script-opt=osc-vidscale=no.

[Solarunit]

good to know, thanks!

[Solarunit]

One more question. I noticed that OSD text size when I change volume in the top left corner became smaller. Is there a settings to change font size?

[guidocella]

https://mpv.io/manual/master/#options-osd-font-size

[Trudeau566]

[555555]
profile-cond=get("video-zoom") > 0.3
input-commands=script-binding align-to-cursor
Why can't I enable align-to-cursor with this configuration? I can use the shortcut key

[guidocella]

I don't know what you expect that to do, you're running the command not binding it to a key.

[Trudeau566]

I don't know what you expect that to do, you're running the command not binding it to a key.

I want to enable script-binding align-to-cursor when video-zoom > 0.3, but input-commands=script-binding align-to-cursor does not work.

[guidocella]

I assume this is with toggle_align_to_cursor?