This release requires FFmpeg 4.4 or newer and libplacebo 6.338.0 or newer.

This is the first release to unconditionally require libplacebo, but note that the new improved renderer (vo_gpu_next) is not yet the default.

Features

New

• ao_oss: add SPDIF passthrough support
• hwtransfer: implement support for HW->HW format conversions
• stream/dvbin: add support for delivery system ISDB-T
• audio/chmap: support up to 64 channels (including 22.2 layout)
• libmpv: add mpv_time_ns()
• vo_gpu, vo_gpu_next: add Vulkan support for macOS
• meson: make libplacebo a required dependency
• hwdec: support videotoolbox hwdec with libplacebo

Changed

• msg: print warning and error messages to stderr
• options: restore old default subtitle selection behavior
• input.conf: swap wheel up/down with wheel left/right

Removed

• waf: remove waf as a build system
• osc.lua: remove toggle for forced only subpictures (appeared as [F])
• mac: remove runtime checks and compatibility for macOS older than 10.15
• cocoa: remove deprecated OpenGL cocoa backend

Options and Commands

Added

• vo_gpu_next: add --hdr-peak-percentile
• player: add --term-remaining-playtime option
• x11: add --x11-wid-title option
• vo_gpu_next: add --libplacebo-opts
• player: add --subs-match-os-language option (replaces 'auto' option)
• vo: add --video-crop
• win32: add --window-corners, --window-affinity, --title-bar, --backdrop-type
• sub: add --sub-stretch-durations option

Changed

• builtin.conf: add --hdr-peak-percentile=99.995 to gpu-hq profile
• player: add 'always' option to --subs-fallback-forced
• demux_playlist: default to --directory-mode=lazy
• builtin.conf: add --allow-delayed-peak-detect=no to gpu-hq profile
• vo_gpu, vo_gpu_next: support --icc-3dlut-size=auto
• demux: prepend some cache options with --demuxer-
• builtin.conf: modernize internal profiles for higher quality rendering by default, rename 'gpu-hq' profile to 'high-quality', add 'fast' profile
• vo_gpu, vo_gpu_next: default to dscale=hermite
• builtin.conf: remove deprecated 'opengl-hq' profile
• options: remove a bunch of old option fallbacks/deprecated ones
• vo_gpu: allow --deband-iterations to be 0
• stream_cdda: deprecate --cdda-toc-bias and always check for offsets
• options: disable --allow-delayed-peak-detect by default
• options: adjust default of --watch-later-options

Deprecated

• command: deprecate shared-script-properties
• demux_cue: deprecate --demuxer-cue-codepage for --metadata-codepage

Removed

• player: remove special 'auto' option from alang/slang/vlang (previous default)
• vo_gpu: remove --tone-mapping-mode
• vo_gpu: remove --scale-wblur, --scale-cutoff etc.
• vo_gpu: remove --scaler-lut-size
• m_option: drop support for -del for list options

Fixes and Minor Enhancements

• build: remove unneeded libdl requirement for vaapi
• zimg: fix abort on subsampled input with odd heights
• video_writer: fix gamma for YUV screenshots
• player/video: fix possible crash when changing lavfi-complex
• ad_spdif: fix segfault due to early deallocation
• ao_pipewire: fix race conditon with setting the media role
• draw_bmp: fix overflowing coordinates in mark_rcs
• ao_sndio: use sio_flush() to improve controls responsiveness
• vo_vdpau: fix hwdec for this vo
• vo_gpu, vo_gpu_next: fix setting an empty dscale
• vd_lavc: repeatedly attempt to fallback if hwdec fails in reinit
• options: fix relative time parsing on negative input
• win32: signal DPI changes correctly
• mp_image: properly infer color levels for some pixfmts
• vo_gpu_next: add ability to use named hook params
• vo_gpu_next: take into account PAR when taking screenshots
• ao_audiotrack: support more channel layouts
• osc.lua: support speed-independent time-remaining display
• sub: fix switching tracks while paused
• audio: fix clipping with gapless audio enabled
• player/video: avoid spamming logs with EOF
• player/command: detect aspect ratio name and show it in stats.lua
• wayland: keyboard input fixes
• demux_playlist: remove len restriction on headerless m3u
• win32: fix display resolution calculation on mulitple monitors
• vo_gpu_next: multiple adjustments and fixes to interpolation
• loadfile: avoid infinite playlist loading loops
• context_drm_egl: don't free EGL properties if they are null
• x11: require xrandr 1.4, remove xinerama support
• drm_common: skip cards that don't have connected outputs
• win32_common: fixes minimized window being focused on launch
• ao/jack: set device_buffer to JACK buffer size
• meson: rename all features with underscores
• input: add new keys: Back, Tools, ZoomIn, ZoomOut
• win32: don't ignore --screen and --fs-screen
• input: add missing keypad key defines and Windows multimedia keys
• player: use audio pts corresponding to playing audio on EOF
• command: add sub-ass-extradata property
• vo_dmabuf_wayland: unmap osd surface when not needed
• player: always write redirect entries for resuming playback
• stats.lua: reorganize how video params are displayed
• stats.lua: display HDR metadata
• osc.lua: add scrolling to the seekbar
• demux_lavf: prefer track durations over container durations to determine total
• vo: vulkan: allow picking devices by UUID
• video: allow overriding container crop if it is present
• vo_gpu, vo_gpu_next, screenshot: support applying crop for screenshots
• sd_lavc: account for floating point inaccuracy, fix sub PTS
• stream: accept dav:// and davs:// urls
• filter_kernels: refine some constants
• filter_kernels: add ewa_lanczos4sharpest
• osc.lua: add scrolling to audio/sub buttons
• demux_mkv: support cropping and rotation
• vo_dmabuf_wayland: support 90 degree rotations
• filter_kernels: add hermite filter
• vo: avoid unnecessary redraws when the OSD shows
• scripting: support DLL cplugins
• af_scaletempo2: various bug fixes
• sdl_gamepad: fix button detection on modern controllers
• vo_dmabuf_wayland: support osd rendering when there's no video
• demux_playlist: add --directory-mode=auto
• vo_gpu_next: use proper color for subtitles
• win32: add an option to change window affinity and control title bar state
• win32: reduce top border thickness to imitate DWM invisible borders
• wayland: remove gnome-specific idle-inhibit warning
• win32: pass window handle to the window-id property
• osc.lua: fix calculation for slider's min-max average
• recorder: fix a couple of memory leaks
• af_scaletempo2: raise max playback rate to 8.0
• osc.lua: move the idle logo behind other overlays
• hwdec_drmprime: add nv16 support
• various: change internal timing code to work in nanoseconds instead of microseconds
• vo: increase display refresh rate estimation limit from 99 Hz to 400 Hz
• external_files: base cover-art-whitelist on cover-art-auto-exts
• path: don't override cache and state paths with --config-dir
• codec_tags: map some more image mimetypes
• af/vf-command: add ability to target a specific lavfi filter
• win32: prevent white window flash on startup
• demux_playlist: use --metacode-codepage when parsing playlist files
• video: revert racey change that led to stutter and deadlocking
• console.lua: various improvements
• command: add playlist-next-playlist and playlist-prev-playlist
• ytdl_hook.lua: set metadata with single tracks
• defaults.lua: add a disabled parameter to timer constructors
• terminal-unix: race condition fixes
• af_scaletempo2: better defaults
• hwtransfer: handle hwcontexts that don't implement frame constraints
• stream_cdda: remove fallback for ancient libcdio versions
• osdep: drop support for C11 without atomics
• dvbin: do a big cleanup on code style and functions
• ytdl_hook.lua: parse the separate cookies field
• sub: update subtitles if current track is an image
• javascript: use --js-memory-report option instead of MPV_LEAK_REPORT
• ao_coreaudio: signal buffer underruns
• ytdl_hook.lua: support thumbnails
• demux: make hysteresis-secs respect cache-secs
• mp_image: pass rotation correctly to/from AVFrame correctly
• various: add new internal mp_thread abstraction and use it
• drm: use present_sync mechanism for presentation feedback
• vo_gpu: apply ICC profile and dithering only to window screenshots
• audio: introduce ao_read_data_nonblocking() and use it in relevant backends
• wayland: obey initial size hints set by the compositor
• command: export storage aspect ratio (sar) properties
• vo: delay vsync samples by at least 10 refreshes to improve convergence time
• vo_sdl: fix broken mouse wheel multiplier
• vo_gpu_next: simplify cache code and don't re-save when unmodified

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.36.0..v0.37.0 in the git repository or by visiting https://github.com/mpv-player/mpv/compare/v0.36.0...v0.37.0.

This release requires FFmpeg 4.4 or newer.

This is the last release to contain the waf build system. Meson is the primary and actively supported build system while waf is considered deprecated.

Features

New

• player: add window-id property
• vo_kitty: introduce modern sixel alternative
• wayland: add wp-fractional-scale-v1 support
• player/command: add user-data property (replacement for shared-script-properties)
• vo_gpu_next: support mapping HDR10+ dynamic metadata
• vo_gpu_next: allow screenshots in native colorspace
• vo_gpu_next: parse Dolby Vision metadata for dynamic scene brightness
• video: allow csp equalizer adjustments with floating point precision
• command: add platform property
• demux_mkv: support ARIB captions
• hwdec_vulkan: add support for Vulkan-based hardware decoding
• player: better handling of forced-only subtitles and a toggle in the OSC
• vo_dmabuf_wayland: add osd support

Changed

• TOOLS/umpv: prefer $XDG_RUNTIME_DIR
• ffmpeg: increase minimum required version to 4.4
• player: choose speed of smallest acceptable factor for display sync
• player: don't force saving start in watch-later-options
• build: officially deprecate waf
• vf_sub: undeprecate
• player: set playlist title to media title if not set already
• player: use and respect XDG_STATE_HOME and XDG_CACHE_HOME by default
• wayland: bump required version to 1.20 and wayland-protocols to 1.25
• ao_pipewire: require at least libpipewire 0.3.48
• vo: hwdec: prioritise drmprime over drmprime_overlay
• vo_gpu/vo_gpu_next: enable gpu shader and icc cache by default

Removed

• drm: remove support for legacy (non-atomic) API
• stream/dvb: drop support for DVB API before Linux 3.7
• hwdec_cuda: drop support for PL_HANDLE_WIN32_KMT (Windows 7 only)
• vo_dmabuf_wayland: drop linux-dmabuf-v2 support

Options and Commands

Added

• player: add --force-render option
• demux: add --demuxer-hysteresis-secs option to save power with caching
• ao_pipewire: allow usage of global volume control via --pipewire-volume-mode
• vo_gpu_next: add --tone-mapping-visualize
• sub: add --sub-fonts-dir and --osd-fonts-dir options
• player: add --auto-window-resize
• console.lua: add a script-opt for the border size
• player: add --drag-and-drop option
• vo_gpu_next: add --corner-rounding option
• player: add more precise sub fallback options --subs-fallback and --subs-fallback-forced
• player: add --input-cursor-passthrough option
• TOOLS/lua/autoload: allow extending ext sets from script-opts
• demux_playlist: add --directory-mode option to control recursive directory loading
• vo_gpu_next: add --target-contrast and --hdr-contrast-recovery/smoothness

Changed

• vd_lavc: add "auto" choice for --vd-lavc-dr and make it the default (notably this change was also backported to v0.35.1)
• wayland: add auto choice to --wayland-configure-bounds
• image_writer: change --screenshot-tag-colorspace default to yes
• vo_gpu_next: expose --tone-mapping=st2094-40 and st2094-10
• wayland: make --wayland-edge-pixels-pointer default to 16
• options: enable scripts related opts also with cplugins
• player/screenshot: add filename return field
• options: set --subs-with-matching-audio to off by default
• options: default --slang to auto, which uses the settings of the user's OS
• vd_lavc: allow user to specify a priority list in --hwdec
• vd_lavc: map hwdec=yes to hwdec=auto-safe and change ctrl+h to use auto-safe

Deprecated

• drm: deprecate --drm-atomic (now always enabled)

Removed

• vo_gpu_next: remove --tone-mapping-crosstalk

Fixes and Minor Enhancements

• ao_pipewire: log version and other useful debug info
• wayland: error out if essential protocol support is missing
• wayland: add support for content-type protocol
• wayland: also log refresh rate on surface entrance
• vo_gpu_next: fix undefined behavior on alpha-first formats
• meson: prepend MPV_CONFDIR path with prefix
• meson: unbreak dl check on BSDs without libdl
• lcms: fix crash with lcms2-related options if lcms is disabled
• meson: fix stdatomic detection on bsd
• osc: don't spam window-controls bindings on every render
• wayland: check for resize/move in touch event first
• ao_coreaudio: use device's nominal sample rate for latency properties
• hwdec_drmprime: support yuv420p format
• ao_pipewire: properly clean up resources
• vo/{sixel,tct}: use the alternate buffer to restore terminal
• vo_sixel: add option to skip clear while drawing
• filter_kernels: fix kaiser
• hwdec/d3d11va: fix a possible memory leak
• external_files: set log level for potential files to trace
• external_files: recognize webp files as cover art
• vo_opengl: do not blindly reject all Microsoft's OpenGL implementations
• ao_coreaudio: use AudioUnitReset as ao_driver.reset to prevent long restart
• hwdec_drmprime: fix memory leak
• vo: hwdec: fix libdrm-related memory leak
• draw_bmp: ensure last slice width is less than total width
• demux: boost read EBU R128 gain values to ReplayGain's reference level
• version.py: bump copyright year
• TOOLS/umpv: support shell-quotes in $MPV
• vulkan: fix build error for 32bit builds with clang
• TOOLS/lua/autoload: improve and optimize the natural sorting
• vo_wlshm: properly support video panscan
• vo_dmabuf_wayland: support panscan and panning
• ra_d3d11: fix incorrect type
• meson: also search for rst2html with .py extension
• audio: fix crash during uninit with ao_lavc
• wayland: only warn about GNOME when actually missing idle inhibit support
• mp_image: fix XYZ primaries default
• msg: preserve early messages when log-file is set in mpv.conf
• x11: fix issue with xpresent timing feedback
• meson: reuse libmpv objects for cplayer to save 50% of compile steps
• player/client: support observing sub-properties
• m_property: implement new deletion operation on properties
• vo_lavc: set frame rate on encoder to fix non-conforming outputs
• player/video: don't resync audio if video is an image
• stream: accept webdav:// and webdavs:// urls
• video/image_writer: avoid stripping colorspace info when writing image
• stats.lua: display HDR peak in nits
• image_pool: fix memory leak with frames
• options: transition from OPT_FLAG to OPT_BOOL
• vd_lavc: sort hwdecs without hwdevices last for autoprobing
• ytdl_hook: don't overwrite force-media-title
• lua: use user-data for interop between osc.lua and console.lua
• vo: fix race condition with redraw requests
• various: more fixes to ensure correct playback of XYZ colorspace
• ytdl_hook: fix fragment-related issue that broke YouTube DASH playback
• command: expose hls-bitrate and program-id as track-list subproperties
• ao_pipewire: use realtime scheduling for data thread
• auto_profiles: check for non-existent properties
• d3d11: retry device creation without debug, if SDK is not available
• win32: follow Windows settings and update dark mode state
• ytdl_hook.lua: fix clip start and end
• hwdec_drmprime: support custom rpi4_8 and rpi4_10 formats
• sub: fix UPDATE_SUB_HARD for converted and external subtitles
• charset_conv: fix memory corruption in mp_iconv_to_utf8
• options: read config file as stream
• wayland: improve guessing when mpv is focused
• player: always try to detect subtitle language from file name
• vo: fix mp_frame_perf thread safety
• lua: read_options: find script-opts prefix at index 1 exactly
• path: handle URLs consistently in mp_basename
• ao_wasapi: remove infinite loop hack in AOCONTROL_UPDATE_STREAM_TITLE
• ao_wasapi: use client name instead of hardcoded string
• vd_lavc: fix crash if hwdec devices fail to create
• vo_drm: fix null dereference and using closed fd
• image_writer: respect jpeg-quality when using ffmpeg for writing
• image_writer: add support for AVIF
• TOOLS/lua/autoload: avoid unnecessary playlist manipulation, performance
• various: correctly ignore cache files with --no-config
• terminal-unix: better error detection logic
• json: raise parse depth to 50 for the sake of utils.parse_json()
• player: delete watch_later file only after successful load
• wayland: fix memory leak with multiple monitors
• vd_lavc: prefer d3d11va-copy over dxva2-copy
• vd_lavc: fix hwdec for videos with less than less than 3 frames
• wayland: add support for suspended toplevel state
• draw_bmp: ensure last slice is less than total width (again)
• console.lua: sort the output from the help command
• vd_lavc: try other hwdecs when falling back after an hwdec failure
• sd_ass: don't reconfigure ass on every frame (performance regression)
• sd_ass: fix converted subtitles having too-wide borders
• loadfile: compute audio language for sub selection when using lavfi-complex
• wayland: fix modifier keys in certain situations
• vd_lavc: corrections towards hwdec and swdec fallback
• zimg: fix broken sig_peak (HDR) handling
• screenshot: implement screenshot window in sw for most VOs
• osc: don't add margins to osc-deadzonesize
• vo_vaapi: fix segfault in draw_osd
• vo_dmabuf_wayland: correctly handle force-window
• ao_pipewire: fix error with pipewire 0.3.75 or later

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.35.0..v0.36.0 in the git repository or by visiting https://github.com/mpv-player/mpv/compare/v0.35.0...v0.36.0.

Bug fix release for the 0.35 branch.

Fixes and Minor Enhancements

• ao_pipewire: log version and other useful debug info
• wayland: error out if essential protocol support is missing
• wayland: also log refresh rate on surface entrance
• vo_gpu_next: fix undefined behavior on alpha-first formats
• meson: prepend MPV_CONFDIR path with prefix
• meson: unbreak dl check on BSDs without libdl
• lcms: fix crash with lcms2-related options if lcms is disabled
• meson: fix stdatomic detection on bsd
• osc: don't spam window-controls bindings on every render
• wayland: check for resize/move in touch event first
• ao_coreaudio: use device's nominal sample rate for latency properties
• ao_pipewire: properly clean up resources
• filter_kernels: fix kaiser
• hwdec/d3d11va: fix a possible memory leak
• external_files: set log level for potential files to trace
• vo_opengl: do not blindly reject all Microsoft's OpenGL implementations
• ao_coreaudio: use AudioUnitReset as ao_driver.reset to prevent long restart
• hwdec_drmprime: fix memory leak
• vo: hwdec: fix libdrm-related memory leak
• draw_bmp: ensure last slice width is less than total width
• wayland: dispatch and wait for compositor events in uninit
• demux: boost read EBU R128 gain values to ReplayGain's reference level
• version.py/version.sh: bump copyright year
• vulkan: fix build error for 32bit builds with clang
• vo_wlshm: cleanup on failure
• ra_d3d11: fix incorrect type
• meson: also search for rst2html with .py extension
• audio: fix crash during uninit with ao_lavc
• mp_image: fix XYZ primaries default
• vd_lavc: add "auto" choice for vd-lavc-dr
• vo: implement VO_DR_FLAG_HOST_CACHED
• x11: fix issue with xpresent timing feedback

This release requires FFmpeg 4.0 or newer.

For packagers: Note that mpv's build system is only supported on Python 3. If you use the bootstrap.py script it will take care of this, otherwise you need to explicitly invoke the build system using python3 waf.

This release adds the Meson build system as an alternative to waf. It is supposed to be feature-complete but please report any issues you encounter.

Features

Added

• vo_gpu_next: add new libplacebo-based renderer
• build: add meson build support
• vo_gpu_next: forward Dolby Vision metadata to libplacebo
• ao_pipewire: add PipeWire audio backend
• ao_sndio: readd this audio output again
• vo_gpu_next: apply film grain if such metadata is present
• drm: context_drm_egl: add support for enabling VRR
• demux: add support for R128 replaygain tags
• x11: support X Present extension
• af_rubberband: add support for new engine in rubberband 3.0.0
• hwdec/drmprime: add drmprime hwdec-interop (commonly found on SoCs)
• various: support binding functions keys beyond F12
• audio: support hotplug events for multiple AOs
• sub: use Unicode linebreaking for non-ASS subs and OSD
• vo_gpu: hwdec: add Android hwdec utilizing AImageReader
• vo_dmabuf_wayland: add wayland VO displaying dmabuf buffers (vaapi or drm hwdec only)
• lua/console: add history deduplication

Changed

• filters: re-add vavpp hardware deinterlacing auto-filter (for --deinterlace)
• swresample: don't forcibly clip audio on every conversion
• ytdl_hook: always set HTTP headers to fix yt-dlp on certain sites

Removed

• libmpv: remove opengl_cb API and other deprecated symbols
• lua: remove deprecated mp.suspend(), resume() and resume_all()
• build: raise minimum libplacebo version requirement to v4.157.0

Options and Commands

Added

• vo_gpu_next: add --target-colorspace-hint to facilitate HDR passthrough
• vo_gpu_next: new tone mapping options 'auto', 'spline', 'bt.2446a' and add --tone-mapping-crosstalk, --inverse-tone-mapping
• vo_gpu: add --gamut-mapping-mode and --tone-mapping-mode
• options: add 'always' choice to --stop-screensaver
• options: add --osd-playing-msg-duration
• player: add --cover-art-whitelist option
• x11: add --x11-present option

Changed

• ao_openal: enable --openal-direct-channels by default
• options: only apply --sub-visibility to primary subtitles
• options: make --cover-art-auto=exact the default
• vo_gpu/hwdec: rename and introduce legacy names for some interops

Deprecated

• vo_gpu: deprecate --gamma-factor and --gamma-auto

Removed

• vo_gpu: remove --gamut-clipping, --gamut-warning, --tone-mapping-desaturate and --tone-mapping-desaturate-exponent (replacements available)
• vulkan: remove --vulkan-disable-events

Fixes and Minor Enhancements

• context_drm_egl: use gbm_surface_create_with_modifiers
• context_drm_egl: add support for BGR surface formats
• vo_gpu: vulkan: open DRM render fd when using VK_KHR_display
• client API: use symbol visibility attributes
• vo_gpu: hwdec_vaapi: add dma-buf modifiers support
• wayland: fix various issues that could lead to jitter
• osc: fix cache displaying 60s in some cases
• player: make --keep-open=always work with --loop-playlist
• opengl: support driver debug message under OpenGL ES
• vo_gpu: opengl: fixes for OpenGL ES version and extension handling
• f_decoder_wrapper: support frame rotation metadata (used by JPEG)
• wscript: switch shaderc checks to pkgconfig
• vd_lavc: enable hwdec for prores by default
• vo_gpu: add HOOKED_gather for custom shaders
• wayland, x11: sanitize window title for valid UTF-8
• win32: apply geometry position to content instead of window
• filter_kernels: add cosine window
• vo_gpu: hwdec_vaapi: don't probe formats for irrelevant endpoints
• vo_gpu: hwdec: load hwdec interops on-demand by default
• stats.lua: graphs: fix bad rendering due to division by 0
• hwdec: warn on unsupported --hwdec option value
• x11: fix --screen-name option
• x11: avoid wasteful rendering when possible
• video/image_writer: add JPEG XL support
• stream_lavf: enable ipfs, ipns and rist protocol support
• osc.lua: fix crash when calling osc-tracklist while idle
• player: add jxl, tiff, tif to list of image extensions
• various: switch to new AVChannelLayout structure
• lua: command_native_async: always run callback asynchronously (edge case)
• context_x11egl: remove supposed transparency workaround
• vo_gpu: fix 3DLUT precision
• drm: avoid drmModeAtomicCommit races by blocking
• drm_common: skip cards that don't support KMS for autodetection
• hwdec/dmabuf_interop_gl: support basic multi-plane formats
• misc/random: switch to internal xoshiro rng implementation
• ytdl_hook: improve track detection
• ad_lavc: strip non-normalized floats
• mpv.metainfo.xml: add XDG appstream metadata manifest
• mac: avoid unnecessary unsafe conversions; fixes crash in debug builds
• af_scaletempo2: fix crash when the number of channels increases
• wayland: correctly handle non-CLOCK_MONOTONIC clocks
• x11: fix --on-all-workspaces option
• sd_ass: improve handling of subtitles with unknown duration
• hwdec/vaapi: improve probing of supported sw formats
• demux_mf: enable support for QOI, PHM and HDR images
• demux_mkv: add AVS2 and AVS3 to tag list
• TOOLS/lua/autoload: fix incorrect duplicate file loading behavior
• demux/codec_tags: support more WAVEFORMATEXTENSIBLE tags
• sd_ass: never mangle colours on RGB video

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.34.0..v0.35.0 in the git repository or by visiting https://github.com/mpv-player/mpv/compare/v0.34.0...v0.35.0

Bug fix release for the 0.34 branch.

Fixes and Minor Enhancements

• player: fix autofit/geometry related segfault
• ao_oss: add missing PATH_DEV_MIXER define
• egl_helpers: fix context creation if GLES 3 is not available
• audio: stop corrupting audio on underreads
• wayland: fix a potential segfault on surface enter
• vo_gpu: opengl: fix wrong glMemoryBarrier call
• vo_gpu: opengl: create context at version 4.4 again
• af_lavcac3enc: fix memory leak on no-op
• subprocess: unblock/reset signals before running child process
• wayland: avoid doing unneccesary window resizes

This release requires FFmpeg 4.0 or newer.

For packagers: Note that mpv's build system is only supported on Python 3. If you use the bootstrap.py script it will take care of this, otherwise you need to explicitly invoke the build system using python3 waf.

Features

Added

• player: allow vo to be switched at runtime
• input.conf syntax: support custom quotes in `XstringX` form & single quotes
• ao_oss: readd OSSv4 audio output, default on *BSD
• player: load cover art with the media filename
• vo_gpu: vulkan: implement a VkDisplayKHR backed context
• osc: seekbar hover/drag: display target chapter at the OSC title
• stats.lua: add page 4 with a list of active key bindings
• sub: add --sub-filter-jsre (JS regex)
• vo_rpi: restore fullscreen handling
• vo_tct: add resize capability
• ytdl_hook.lua: search for yt-dlp by default (preferred over youtube-dl)

Changed

• vo_sixel: many fixes and improvements
• filters: switch from scaletempo to scaletempo2, used for speed option
• audio/vo_pulse: fix various edge cases and issues
• stats.lua: move internal performance info from page 4 to page 0
• command: don't hardcode command lists to be repeatable

Removed

• mac: drop build support for swift versions earlier than 4.1
• vo_gpu: drop support for libplacebo older than v3.104.0

Options and Commands

Added

• vo_sixel: add --vo-sixel-exit-clear
• player: add --screen-name and --fs-screen-name
• player/command: add albumart argument to video-add
• command: add pid (process id), display-width and display-height properties
• sub: add secondary-sub-text, -start, and -end properties; secondary-sub-visibility option
• vo_gpu: add --icc-force-contrast
• player: add append-play flag to loadlist
• command: add support for secondary subs to sub-seek and sub-step
• options: add watch-later-options to configure which options are saved
• player: add track-list/N/image sub-property
• input: add --no-input-builtin-bindings option
• drm_common: add --drm-device option

Changed

• vo_sixel: change default dither to "auto"
• vd_lavc: add VP8 to the default allowed hwdec codec list
• vo_gpu: lower default deband threshold to preserve more detail
• vo_gpu: adjust interpolation-threshold's default
• demux: undeprecate --cache-secs
• options: add Uploader, Channel_URL to --display-tags defaults
• options: --audio-display determines cover priority
• command: make current-window-scale writeable

Deprecated

• win32: ignore and deprecate --fit-border
• drm_common: deprecate selecting by card number in --drm-connector

Removed

• vo_gpu: remove --icc-contrast
• stats.lua: remove script-opts for the main keys (i/I)
• vo_gpu: opengl: remove --opengl-restrict

Fixes and Minor Enhancements

• terminal: correctly process input when foregrounded
• vo_wlshm: support presentation time
• mac: fix a window positioning bug when exiting fullscreen
• csputils: add mappings for DCI-P3 (ST.431-2) and P3-D65 (ST.432-1)
• player: make resetting of track selection to "auto" work
• stream_lavf: support rtsps
• vo_wlshm: support big endian systems
• demux_mf: add support for more image codecs
• msg: fix really-quiet option to only affect terminal output
• mac: fix traditional fullscreen on macOS 11
• ao_pulse: fix misbehavior with PipeWire when setting volume or mute
• stats.lua: include a filter's @‍label when displaying filters on page 1
• wayland, win32: support the display-hidpi-scale property
• win32: keep the window title-bar inside the screen
• filter_kernels: fix incorrect constant for quadric window
• command: add display-width/display-height property
• edl: add a way to add tags
• stream_file: disable readahead for remote files on macOS to fix stutter
• osxbundle: fix slow and wasteful memory allocation that caused stutter
• vo_gpu: fix extreme clipping with --gamut-clipping for HDR outputs
• af_scaletempo2: speed up using vector calculations
• recorder: fix muxing of certain codecs
• win32: support the focused property
• js: add mp.utils.append_file
• subs: fix missing subtitles on last frame
• stats.lua: show scaled resolution
• osc: expose osc-visibility via shared-script-properties
• terminal-unix: fix ^Z identification and ignore unknown CSI sequences
• context_drm_egl: allow autoprobe selection
• wayland: improve behavior with touch events
• command: make current-window-scale writeable
• vo_vdpau: don't treat preemption as an error to fix VT switching
• wayland: read XCURSOR_THEME to get cursor theme
• demux_playlist: extend maximum line size (again) to 2M
• win32: call timeBeginPeriod on demand on Windows 10
• build: allow easier selection of lua version/package
• vo_gpu: fix distortion with certain rotated videos
• drm_common: skip non-primary devices during automatic choosing
• drm_common: support USB, SPI, Writeback and unknown connector types (future proofing)

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.33.0..v0.34.0 in the git repository or by visiting either https://github.com/mpv-player/mpv/compare/v0.33.0...v0.34.0 or https://git.srsfckn.biz/mpv/log/?qt=range&q=v0.33.0..v0.34.0

Security fix release for the 0.33 branch. Users are advised to upgrade immediately.

Fixes and Minor Enhancements

• demux_mf: improve format string processing (assigned CVE-2021-30145)

This release requires FFmpeg 4.0 or newer.

For packagers: Note that mpv's build system is only supported on Python 3. If you use the bootstrap.py script it will take care of this, otherwise you need to explicitly invoke the build system using python3 waf.

Features

Added

• scripting: load scripts from directories
• mac: activate logging when started from the bundle
• ytdl_hook.lua: delay load subtitles
• sub: add an option to filter subtitles by regex
• scripting: add a way to run subprocesses as "scripts"
• command: implement asynchronous commands and support for named arguments
• player: add optional separate video decoding thread
• vo_gpu: d3d11: add support for exclusive fullscreen
• w32_common: Support HiDPI on Windows
• vo_x11: add 10 bit support
• vo_gpu: add BT.2390 tone-mapping
• client API: add software rendering API
• audio: add scaletempo2 filter based on chromium
• auto_profiles: add this script
• stream: Implement slice:// for reading slices of streams
• player: add automatic loading of external cover art files
• vo_sixel: implement terminal video output using sixel

Changed

• sws_utils: use zimg by default if available
• build: pick up Lua 5.2 by default (preferred over 5.1)
• build: disable RPI vendor blob auto-detection in favor of open-source stack
• build: make C11 atomics mandatory
• build: make libass non-optional
• player: stricter filename matching for external subtitle auto-loading
• lua: support Unicode paths in script loading and IO library
• vo_direct3d: rip out texture video rendering path and dumb down OSD rendering
• audio: rewrite internal audio handling and AO API
• build: disable GLX by default

Removed

• stream_libarchive: disable tar support due to bugs
• Remove remains of Libav compatibility
• stream_smb: remove due to lack of thread safety and the abundance of alternatives, FFmpeg still includes SMB support
• command: remove legacy hook API (has been deprecated for a long time)
• client API: remove deprecated qthelper.hpp header
• removed audio outputs: sndio, rsound, oss
• x11: remove xdg-screensaver invocations that supported dbus based idle inhibit
• client API: deactivate the opengl_cb API
• build system: drop Python 2 compatbility

Options and Commands

Added

• demux: add option to disable cache "sharing" between back and forward buffers
• player: add ab-loop-count option/property
• ytdl_hook: add a way to use ytdl's default formats
• ytdl_hook: add all_formats option that loads all formats that were found
• demux_mkv: document probe-start-time option and enable it by default
• command: extend osd-overlay command with bounds reporting
• player: a number of new playlist contol commands/properties
• ipc: add --input-ipc-client option
• options: add option to control display-sync factor
• vo_gpu: add better gamut clipping option
• vo_gpu: vulkan: add ability to disable events
• x11: add option to make window appear on a specific workspace
• wayland: expose wayland-app-id as a user option
• player: add --subs-with-matching-audio option
• command: add read-only focused property
• screenshot: option to use software rendering for screenshots
• command: add delete-watch-later-config
• command: new property mouse-pos with current position and hover state

Changed

• options: remove deprecation warning for "-foo bar" syntax
• player: make audio hr-seek default
• ad_lavc: disable decoder downmix by default
• command: support save-position-on-quit for "stop" command too
• command: extend subprocess command
• options: do not accept ":" as separator anymore in key/value lists

Deprecated

• demux: deprecate --cache-secs

Removed

• wayland: remove wayland-frame-wait-offset option
• input: remove deprecated --input-file option
• vo_vdpau: remove deprecated/inactive --vo-vdpau-deint option

Fixes and Minor Enhancements

• options: stop hiding deprecated options from --help output
• lua, js: add mp.get_script_directory() function
• lua: fix security relevant loading order issue with scripts
• player: make screenshot each-frame mode more accurate
• bash completion: complete ao/af/vo/vf options
• zimg: add alpha support
• wayland: make resizing better
• edl: add mechanism for delay loading streams
• stream_file: fix caching-related performance regression on CIFS
• cocoa-cb: fix crashes and issues with UI updates
• sub, demux: improve behavior with negative subtitle delay/muxed subs
• demux: make seek ranges work for static images + audio
• cocoa-cb: support maximize/minimize on startup
• umpv: change from legacy FIFO to socket
• stats: move input speed to cache page, make it a graph
• stats: add fourth page with performance graphs
• command: print edition title to OSD when cycling
• zimg: add support for big endian input and output
• demux_mkv: add png intra support
• build: detect VT_GETMODE on FreeBSD and DragonFly
• win32: use windows 10 native virtual-terminal if available
• vo_gpu: enable frame caching for still frames
• command: add property to return text subtitles in ASS
• vo_gpu: ra_pl: add timers support
• build: allow vo_wlshm on more Wayland platforms (e.g. FreeBSD)
• zimg: add slice threading and use it by default
• command: add a way to access properties of a current track
• vo_gpu: EGL: fix transparency on X11/EGL/Mesa
• vd_lavc: add AV1 to the default allowed hwdec codec list

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.32.0..v0.33.0 in the git repository or by visiting either https://github.com/mpv-player/mpv/compare/v0.32.0...v0.33.0 or https://git.srsfckn.biz/mpv/log/?qt=range&q=v0.32.0..v0.33.0

This release requires FFmpeg 4.0 or newer.

Features

Added

• stream_libarchive: enable RAR5 support
• bash completion: add initial implementation
• cocoa-cb: add support for forcing the dedicated GPU for rendering
• cocoa-cb: add pinch to resize window gesture
• w32_common: support minimizing/maximizing using osc window controls

Changed

• wayland: print warning on GNOME due to serious issues with their compositor
• player: write watch-later config even for unseekable streams

Removed

• vo_gpu: hwdec_vdpau: remove direct_mode
• vo_gpu: hwdec_vaegl: remove support for old-style interop

Options and Commands

Added

• command: add a playlist-unshuffle command
• command: add osd-dimensions property
• input: new PLAYONLY and PAUSEONLY keycodes

Changed

• options: change option parsing when using a single dash This adds a warning for -o file.mkv and disallows the use of --o file.mkv (use --o=file.mkv instead).

Fixes and Minor Enhancements

• lua: fix mp.file_info for large files
• vo_gpu: fix crash if dither texture fails to allocate
• wayland: unscrew up cursors, fix various issues
• osc: usability improvements for osc window controls

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.31.0..v0.32.0 in the git repository or by visiting either https://github.com/mpv-player/mpv/compare/v0.31.0...v0.32.0 or https://git.srsfckn.biz/mpv/log/?qt=range&q=v0.31.0..v0.32.0

This release requires FFmpeg 4.0 or newer.

Features

Added

• vo_gpu/d3d11: allow configurable swapchain color space for native HDR output
• player: add mechanisms for better logging as preperation for console.lua
• audio: add ao_audiotrack for Android
• input: introduce a pseudo key name that grabs all text input
• wayland: add grab zone for resizing window with mouse
• osc: implement pseudo client side decorations via OSC
• vf_gpu: add video filter using vo_gpu's renderer
• added console.lua: interactive REPL for input commands
• osc: display Santa hat for idle logo in December
• vd_lavc: add option to autoselect known good hwdec implementations
• mac: replace old event tap for media key support with MediaPlayer

Changed

• input: disable gamepad code by default
• vo_gpu: allow vdpau usage under EGL
• stream, demux: redo origin policy

Removed

• mac: remove Apple Remote support
• client API: deprecate tick event

Options and Commands

Added

• vo_gpu/d3d11: add --d3d11-output-csp for configuring swap chain color space
• command: add command-list property
• command, input: add input-bindings property
• command: add --window-maximized and make --window-minimized settable
• command: add property returning hidpi scale
• command, lua: add a way to share data between scripts
• client API, lua: add new API for setting OSD overlays

Changed

• add a builtin "sw-fast" profile, which restores performance settings for software video conversion. These were switched to higher quality. This affects video outputs like vo_x11 and vo_drm, and screenshots.
• options: make --show-profile without parameters list all profiles
• wayland: support for --hidpi-window-scale option
• stream_lavf: set --network-timeout to 60 seconds by default
• x11: scale window-scale by DPI

Deprecated

• deprecate --input-file
• deprecate --video-sync=display-adrop
• deprecate all input section commands
• deprecate --display-fps, replaced by --override-display-fps

Removed

• remove deprecated --playlist-pos alias

Fixes and Minor Enhancements

• vo_drm, vo_x11: allow use of zimg
• vo_sdl: Support mouse wheel input, Improve mouse button input
• video: fix track switching work for external images
• vo_gpu: fix infinite scaler reinit spam
• f_output_chain: fix possible crash when changing filters
• vo_gpu: opengl: add hack for ancient Mesa/GLX
• demux_lavf: export demuxer_id for more formats which have it
• lua: make later key bindings always have higher priority
• drm_common: fix display FPS estimation for interlaced modes
• vo_drm: fix incorrect pixel format possibly being picked for 30-bit
• zsh completion: fix pcre usage to really be optional
• options: increase consistency between list options and document them
• osc: reduce unnecesary CPU usage by using property notifications

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.30.0..v0.31.0 in the git repository or by visiting either https://github.com/mpv-player/mpv/compare/v0.30.0...v0.31.0 or https://git.srsfckn.biz/mpv/log/?qt=range&q=v0.30.0..v0.31.0