Release 0.41.0

2025-12-21 20:08:20 +01:00
1 parent 17cfad0b74
commit 41f6a64506
@@ -30,7 +30,72 @@ Interface changes
 ::
 --- mpv 0.42.0 ---
 --- mpv 0.41.0 ---
    - the value of `--tls-ca-file` is now expanded as a path
    - the value of `--tls-cert-file` is now expanded as a path
    - the value of `--tls-key-file` is now expanded as a path
    - the `--sub-sdh-enclosures` option is now a string list option
    - rename `console-selected_color` script-opt to `console-focused_color`
    - rename `console-selected_back_color` script-opt to `console-
      focused_back_color`
    - mediacodec_embed is no longer the default `vo` on Android. Set the option
      explicitly if you want to use it and are aware of the limitations.
    - change `--target-colorspace-hint` to `auto` by default. Auto mode will
      also enable hint for SDR formats if target metadata is reported by current
      output context.
    - change `--prefetch-playlist` default to `no`
    - add `--clipboard-xwayland` option
    - add `video-params/prim-*` properties
    - add `stats-plot_cache` script-opt
    - disable `stats-plot_{perfdata,vsync_ratio,vsync_jitter}` by default
    - add `scaled` and `osd` flags to screenshot commands
    - add `forced` flag to track add commands
    - add `default` flag to track add commands
    - add `console-monospace_font` script-opt
    - remove `console-font` script-opt
    - add `console-gap` script-opt
    - add `console-exact_match` script-opt
    - make `console-case_sensitive` only affect exact searches and change the to
      default to no on platforms other than Windows
    - add `commands-remember_input` script-opt
    - add `--wid=0` support for win32
    - add `--vo-kitty-auto-multiplexer-passthrough=<yes|no>`
    - add `--vf=format=transfer` alias
    - add `--vf=format=min-luma`
    - add `--vf=format=max-luma`
    - add `--vf=format=max-cll`
    - add `--vf=format=max-fall`
    - add `--treat-srgb-as-power22`
    - add `--sdr-adjust-gamma`
    - add `--target-colorspace-hint-strict` option
    - add `--target-colorspace-hint-mode` option
    - add `--sub-hdr-peak` option
    - add `--sub-fix-timing-threshold`
    - add `--sub-fix-timing-keep`
    - add `--register` and `--unregister`
    - add `--osd-prune-delay`
    - add `--osd-glyph-limit`
    - add `--osd-bitmap-max-size`
    - add `--sub-glyph-limit`
    - add `--sub-bitmap-max-size`
    - add `--osd-shaper`
    - add `--input-tablet-emulate-mouse` option
    - add `--image-subs-hdr-peak` option
    - add `--hwdec-threads`
    - add `--hdr-reference-white`
    - add `--d3d11-output-mode` enable use specific output mode for creating the
      D3D11 swapchain
    - add `--d3d11-composition-size=<WxH>` support for d3d11 composition mode
    - add `--border-background=blur`
    - add `--background-blur-radius`
    - add `--bluray-angle`
    - add `--background-tile-size` option
    - add `--background-tile-color-0` and `--background-tile-color-1` options
    - add --audio-set-media-role, disabled by default. This effectively changes
      the behavior for ao_pipewire
    - `encoding-profiles.conf` is no longer installed by default into the system
      configuration directory and is instead installed in the data directory
 --- mpv 0.40.0 ---
    - undeprecate list option suffixes that work with multiple items
    - add `-del` to string list and keyvalue list options
@@ -1 +0,0 @@
 add --audio-set-media-role, disabled by default. This effectively changes the behavior for ao_pipewire
@@ -1,2 +0,0 @@
 add `--background-tile-size` option
 add `--background-tile-color-0` and `--background-tile-color-1` options
@@ -1 +0,0 @@
 add `--bluray-angle`
@@ -1,2 +0,0 @@
 add `--border-background=blur`
 add `--background-blur-radius`
@@ -1 +0,0 @@
 add `commands-remember_input` script-opt
@@ -1,2 +0,0 @@
 add `--sub-fix-timing-threshold`
 add `--sub-fix-timing-keep`
@@ -1,2 +0,0 @@
 add `console-exact_match` script-opt
 make `console-case_sensitive` only affect exact searches and change the to default to no on platforms other than Windows
@@ -1,2 +0,0 @@
 rename `console-selected_color` script-opt to `console-focused_color`
 rename `console-selected_back_color` script-opt to `console-focused_back_color`
@@ -1,2 +0,0 @@
 add `console-monospace_font` script-opt
 remove `console-font` script-opt
@@ -1 +0,0 @@
 add `console-gap` script-opt
@@ -1 +0,0 @@
 add `--load-context-menu` option
@@ -1 +0,0 @@
 add `default` flag to track add commands
@@ -1 +0,0 @@
 `encoding-profiles.conf` is no longer installed by default into the system configuration directory and is instead installed in the data directory
@@ -1 +0,0 @@
 add `forced` flag to track add commands
@@ -1 +0,0 @@
 add `--hwdec-threads`
@@ -1 +0,0 @@
 add `--image-subs-hdr-peak` option
@@ -1 +0,0 @@
 add `--vo-kitty-auto-multiplexer-passthrough=<yes|no>`
@@ -1 +0,0 @@
 mediacodec_embed is no longer the default `vo` on Android, set the option explicitly if you want to use it and are aware of the limitations.
@@ -1 +0,0 @@
 Add `--register` and `--unregister`
@@ -1,6 +0,0 @@
 add `--osd-prune-delay`
 add `--osd-glyph-limit`
 add `--osd-bitmap-max-size`
 add `--sub-glyph-limit`
 add `--sub-bitmap-max-size`
 add `--osd-shaper`
@@ -1 +0,0 @@
 add `cue` to `--playlist-exts`' default value
@@ -1 +0,0 @@
 remove undocumented optional argument usage for `playlist-remove` command
@@ -1 +0,0 @@
 change `--prefetch-playlist` default to `no`
@@ -1 +0,0 @@
 add `scaled` and `osd` flags to screenshot commands
@@ -1 +0,0 @@
 add `--hdr-reference-white`
@@ -1,2 +0,0 @@
 add `stats-plot_cache` script-opt
 disable `stats-plot_{perfdata,vsync_ratio,vsync_jitter}` by default
@@ -1 +0,0 @@
 add `--sub-hdr-peak` option
@@ -1 +0,0 @@
 the `--sub-sdh-enclosures` option is now a string list option
@@ -1 +0,0 @@
 add `--input-tablet-emulate-mouse` option
@@ -1 +0,0 @@
 add `--target-colorspace-hint-mode` option
@@ -1 +0,0 @@
 add `--target-colorspace-hint-strict` option
@@ -1 +0,0 @@
 Change `--target-colorspace-hint` to `auto` by default. Auto mode will also enable hint for SDR formats if target metadata is reported by current output context.
@@ -1 +0,0 @@
 add `video-params/prim-*` properties
@@ -1,3 +0,0 @@
 the value of `--tls-ca-file` is now expanded as a path
 the value of `--tls-cert-file` is now expanded as a path
 the value of `--tls-key-file` is now expanded as a path
@@ -1,2 +0,0 @@
 add `--treat-srgb-as-power22`
 add `--sdr-adjust-gamma`
@@ -1,5 +0,0 @@
 add `--vf=format=transfer` alias
 add `--vf=format=min-luma`
 add `--vf=format=max-luma`
 add `--vf=format=max-cll`
 add `--vf=format=max-fall`
@@ -1,2 +0,0 @@
 add `--d3d11-output-mode` enable use specific output mode for creating the D3D11 swapchain.
 add `--d3d11-composition-size=<WxH>` support for d3d11 composition mode.
@@ -1 +0,0 @@
 add `--wid=0` support for win32
@@ -1,2 +0,0 @@
 add `x11` clipboard backend
 add `--clipboard-xwayland` option
@@ -1 +1 @@
-0.40.0-UNKNOWN
+0.41.0
@@ -1,22 +1,20 @@
-Release 0.40.0
+Release 0.41.0
 ==============
-We are excited to announce the release of mpv 0.40.0.
+We are excited to announce the release of mpv 0.41.0.
 Key highlights:
-* Console: Enhanced autocompletion and visual styling
+* The libplacebo based `gpu-next` is now the default, over `gpu`
-* OSC: New selection menu accessible by right-clicking common buttons
+* Vulkan hardware decoding is preferred over other APIs
-* HDR is now natively supported when using direct rendering (DRM),
+* New context_menu.lua script for right-click context menus
-  as well as dmabuf-wayland on Linux
+* AAudio backend for modern, HNI-free audio output on Android
-* Native clipboard access for scripts via new `clipboard` property
+* Improved default color management for gpu-next, and handling on Wayland
-* New command menu, with common actions easily accessible
+* Color representation protocol support for Wayland
-* Enhanced select.lua with new selection options for watch history, editions, DVD/Blu-Ray titles
+* Tablet input support for Wayland
-* New positioning.lua script script for cursor-centric zooming and drag to pan
+* Clipboard writing support for Wayland and a clipboard backend for X11
-* Better stream support for Blu-ray, DVD and CDDA
+* Ambient light support on Linux (using sysfs ALS)
-* Track selection improvements and better metadata display
+* Built-in helpers to register mpv as a media app on Windows
 * 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.
@@ -24,110 +22,118 @@ This release requires FFmpeg 6.1 or newer and libplacebo 6.338.2 or newer.
 ## New
- vf_d3d11vpp: add NVIDIA RTX Video HDR support
+- clipboard-wayland: support clipboard writing
- context_drm_gl: add support for HDR metadata
+- wayland: add support for wp-color-representation-v1
- positioning.lua: add new script for video alignment and zooming
+- wayland: tablet input support
- umpv: add Windows support
+- vo_gpu_next: add support for blend-subtitles=video
- command: add clipboard property with native backends for Windows, macOS, and Wayland
+- meson: add mpv-register and mpv-unregister helpers on Windows
- select.lua: add watch history, edition, DVD/Blu-Ray titles and more selection options
+- context_menu.lua: add this script
- input.conf: add cursor-centric zoom and drag-to-pan bindings
+- select.lua: add edit-config-file and edit-input-conf
- wayland: add support for wp-color-management-v1 protocol
+- osc.lua: add indicator for buffering/loading
- console.lua: add persistent command history
+- osdep/linux-als: support 'ambient-light' property on Linux
- stats.lua: add timecode display
+- clipboard-x11: add x11 clipboard backend
- options: add --playlist-exts and --archive-exts
+- ao/aaudio: implement native AAudio backend for Android
 - 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
+- vd_lavc: prefer Vulkan hwdec when available
- command: enhance track and playlist display information
+- vd_lavc: prefer non-copy hwdec before falling back to -copy variant
- input.conf: improve numpad key bindings
+- vo: move vo_mediacodec_embed to not be the default on Android
- osc.lua: add custom buttons support and improved mouse bindings
+- sub/osd_libass: don't rerender OSD if not changed
- console.lua: inherit OSD styles and colors
+- vo: prefer vo_gpu_next over vo_gpu by default
- options: default to --prefetch-playlist=yes
+- vo_gpu_next: respect ICC profile color space over any metadata
- osc.lua: add slimbottombar and slimtopbar layouts
+- vo_gpu_next: linearize sRGB as a pure 2.2 power function
- command: improve frame-step to go through multiple frames
+- meson: warn if building with SDL2 due to known problems
- wayland: use wp-presentation v2 if available
+- osxbundle: make bundle category configurable and default to video
- various: reorganize options into more logical groups
+- ao_pipewire: avoid setting any media.role by default
 - 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
+- sub: add control for libass caching options (glyph-limit, bitmap-max-size)
- player: add an optional mute flag when framestepping
+- vo: add options to control background tile appearance (transparency)
- command: add clipboard/text-primary property
+- command: add default and forced flags to the track add commands
- command: add current-clipboard-backend property
+- vo_gpu_next: add options to control subtitle peak for HDR output
- command: add notify-property command
+- video/out/d3d11: add d3d11 composition mode support
- options: add --script-opt alias for --script-opts-append
+- vd_lavc: add --hwdec-threads
- options: add --osd-bar-marker-{size,style} options
+- stream_bluray: add --bluray-angle
- options: add --input-ime for improved text input
+- vo_gpu_next: add options to control output colorspace metadata more precisely
- options: add --video-recenter
+- sub: make --sub-fix-timing configurable
- options: add --clipboard-backends
+- vo_gpu_next: add --hdr-reference-white
- options: add --wayland-internal-vsync
+- audio/out: add --audio-set-media-role
 - options: add --sub-scale-signs
 ## Changed
- options: rename --load-osd-console to --load-console
+- options: revert --prefetch-playlist default back to 'no'
- player: improve track selection for multi-component languages
+- vo_gpu_next: change --target-colorspace-hint to 'auto' by default
- options: improve frame-step command to handle multiple frames
+- options: handle runtime --wid change
- input.conf: make Alt+BS reset --video-align-{x,y}
+- options: reduce swapchain-depth to 2 by default
- command: print track metadata when changing track
+- screenshot: add osd and scaled flags to screenshot commands
 - 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
+- vo_kitty: add auto-multiplexer-passthrough option
- win32: fix window size restore after maximize state
+- vd_lavc: enable FFv1 hwaccel by default
- build: fix dynamic generation of mpv.desktop file protocols
+- clipboard-wayland: prevent reading from hung up fd
- player/sub: avoid pointlessly redecoding subs
+- demux_mkv: fix compilation after deprecated definitions removal
- x11: remove nvidia blacklist logic from --x11-present=auto
+- filters: handle flipping video if displaymatrix indicates so
- osc.lua: seek to the nearest chapter when right clicking the seekbar
+- player/scripting: fix race condition when destroying clients
- command: fix keybind command with sequence keys
+- {osd,msg}: use PU codepoints for escape codes instead of invalid UTF-8
- video/out/wayland_common: fix crash with multi-seat drag and drop
+- vo_dmabuf_wayland: only load needed hardware decoding drivers
- demux: reclaim demux_packets to reduce memory allocator pressure
+- video/image_writer: tag accurate bit depth
- demux_cue: only accept TRACK with AUDIO type
+- demux_lavf: fix unconstrained cache size with wrapped AVFrame packets
- player/loadfile: strip common filename part from external track title
+- libarchive: fix reading name of certain UTF-8 files
- build: remove unused dvdread dependency
+- sub/sd_lavc: fix decoding with libaribb24
- wayland: fix vertical resizing and scaling issues
+- ao_avfoundation: fix memory leak
- console.lua: improve completion and visual appearance
+- osc.lua: fix volume icon not updating while paused
- sub/osd: default to a semitransparent black back color
+- context_wayland: implement target_csp for wayland
- player: improve playlist handling with prefetch
+- vo_gpu: fix target colorspace for redrawn frames
- drm: parse EDID using libdisplay-info (which is now a required dependency)
+- vo_dmabuf_wayland: don't set HDR metadata on SDR transfers
- win32: fix window size restore after maximize state
+- vo_gpu_next: don't do partial updates on hint luminance
- hwdec_d3d11va: align image mapper dimensions to a multiple of 2
+- sub/ass_mp: add missing padding for ass packer
- wayland: fix DnD with focus follow mouse
+- stream_dvb: allow to enforce DVB-S/T for old zap format channels.conf
- player: store external filenames as normalized
+- demux_libarchive: fix reading archives with '%' in stream URL path
- player: properly handle secondary subtitles on the terminal
+- vo_gpu_next: allow UINT upload if no other format is supported
- demux_mkv: add support for chroma location
+- ytdl_hook.lua: fix incorrect default format used with yt-dlp
- vo_dmabuf_wayland: improve and fix format selection
+- vo_gpu_next: allow unsetting LUTs
- player: fix combination of --loop-playlist + --shuffle + --prefetch-playlist
+- stream_bluray: use bd_get_main_title() to get main title
 - vo_gpu_next: when tone-mapping, set better maxCLL value
 - stream_libarchive: seek source stream to 0 before probing
 - path-unix: support ~~desktop path expansion
 - ytdl_hook.lua: don't crash if playlist entries don't have an usable URL
 - mac/vulkan: fix frame not displayed when paused
 - mac/common: render first frame on init if possible
 - video/out/w32_common: support --wid=0
 - demux_mkv: map and expose hearing/visual impaired flags
 - player/misc: show percentage progress for --stream-dump
 - command: fix null dereference for invalid command in input-commands
 - cplugin: fix missing init of pfn_mpv_get_time_ns
 - vo_dmabuf_wayland: actually reuse OSD buffers
 - mp_image: add support for AVAlphaMode
 - vo_gpu_next: add --border-background=blur and --background-blur-radius
 - demux/cue: fix crash when there are no tracks
 - vf_format: add some basic HDR10 metadata
 - vo/context_android: fix surface tearing on resize
 - meson: remove redundant 'sdl2' option
 - mac/common: fix window position on multi monitor setups
 - vo_gpu_next: limit min_luma to 1000:1 contrast ratio in SDR mode
 - ao_pipewire: fix some incorrect channel mappings
 - wayland: correct geometry handling for rotated outputs
 - demux: clear packet pool when upper memory limit is lowered
 - mp_image: add ycgco-{re,ro} support
 - wayland: convert luminance values to libplacebo space
 - vo: trigger manual redraws at most at slightly over display fps
 - osxbundle: add new macOS 26 compatible App icon
 - wayland: support color-management-v1 version 2
 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`
+A complete changelog can be seen by running `git log v0.40.0..v0.41.0`
 in the git repository or by visiting
-<https://github.com/mpv-player/mpv/compare/v0.39.0...v0.40.0>.
+<https://github.com/mpv-player/mpv/compare/v0.40.0...v0.41.0>.
		`@@ -1 +0,0 @@`
			`add --audio-set-media-role, disabled by default. This effectively changes the behavior for ao_pipewire`
		`@@ -1,2 +0,0 @@`
			add `--background-tile-size` option
			add `--background-tile-color-0` and `--background-tile-color-1` options
		`@@ -1,2 +0,0 @@`
			add `--border-background=blur`
			add `--background-blur-radius`
		`@@ -1,2 +0,0 @@`
			add `--sub-fix-timing-threshold`
			add `--sub-fix-timing-keep`
		`@@ -1,2 +0,0 @@`
			add `console-exact_match` script-opt
			make `console-case_sensitive` only affect exact searches and change the to default to no on platforms other than Windows
		`@@ -1,2 +0,0 @@`
			rename `console-selected_color` script-opt to `console-focused_color`
			rename `console-selected_back_color` script-opt to `console-focused_back_color`
		`@@ -1,2 +0,0 @@`
			add `console-monospace_font` script-opt
			remove `console-font` script-opt
		`@@ -1 +0,0 @@`
			`encoding-profiles.conf` is no longer installed by default into the system configuration directory and is instead installed in the data directory
		`@@ -1 +0,0 @@`
			add `--vo-kitty-auto-multiplexer-passthrough=<yes\|no>`
		`@@ -1 +0,0 @@`
			mediacodec_embed is no longer the default `vo` on Android, set the option explicitly if you want to use it and are aware of the limitations.