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

This release requires FFmpeg 4.0 or newer.
This release has replaced the internal Vulkan rendering abstraction
with libplacebo's more up-to-date implementation.

Features

Added

• vo_gpu: vulkan: hwdec_cuda: Add support for Vulkan interop
• command: support for async commands
• input: support for named arguments
• cocoa-cb: add support for mac 10.14 Dark mode and run time switching
• vo_gpu: switch to Vulkan API implementation based on libplacebo
• context_drm_egl: Add support for presentation feedback
• vo_gpu: implement error diffusion for dithering
• vo/gpu: hwdec_vdpau: Support direct mode for 4:4:4 content
• vo_gpu: hwdec_vaapi: Add Vulkan interop
• video, TOOLS: add vf_fingerprint and a skip-logo script
• vo_gpu: d3d11: add support for presentation feedback
• vo_drm: 30bpp support
• cocoa-cb: add support for 10bit opengl rendering
• video: add pure gamma TRC curves for 2.0, 2.4 and 2.6
• vo_drm: Implement N-buffering and presentation feedback
• Reintroduce vo_wayland as vo_wlshm
• video: add zimg wrapper
• wayland: add presentation time
• input: add gamepad support through SDL2

Changed

• cocoa-cb: use libmpv's advanced rendering control and timing
• vo_gpu: improve tone mapping desaturation
• vo_gpu: redesign peak detection algorithm
• vo_gpu: allow boosting dark scenes when tone mapping
• osc: improve look of seekranges
• vo_gpu: x11: remove special vdpau probing, use EGL by default
• demux: sort filenames naturally when playing a directory / archive
• stream_dvb: rewrite channel switching, remove old stream control
• filters: extend vf_format so that it can convert color parameters

Removed

• demux, stream: rip out the classic stream cache
• vo_gpu: removed internal Vulkan implementation
• Remove libdvdread support in favor of libdvdnav
• demux, stream: remove much of the optical disc support
• Remove classic Linux analog TV support, and DVB runtime controls
• demux, stream: remove old rar support in favor of libarchive
• vo_gpu: remove mali-fbdev
• vo_gpu: remove vdpau/GLX backend
• vf_vapourynth: remove Lua backend
• vo_gpu: remove hwdec_d3d11eglrgb

Options and Commands

Added

• command: add a subprocess command
• vo_gpu: added --tone-mapping-max-boost, --hdr-peak-decay-rate, --hdr-scene-threshold-low/high
• player: add --demuxer-cache-wait option
• Implement backwards playback
• demux: add a on-disk cache
• demux, command: add another stream recording mechanism, dump-cache command
• ao_pulse: add --pulse-allow-suspended
• command: add video-add/video-remove/video-reload commands
• demux_cue: added --demuxer-cue-codepage to select CUE sheet charset
• input: add keybind command
• command: add sub-start & sub-end properties
• video/d3d11: added --d3d11-adapter to select a rendering adapter by name
• vo_gpu/d3d11: added --d3d11-output-format for configuring swap chain format

Changed

• vo_gpu: split --linear-scaling into --linear-upscaling and --linear-downscaling
• vo_gpu: split --tone-mapping-desaturate into strength and exponent
• drm: rename --drm-osd-plane-id to --drm-draw-plane, --drm-video-plane-id to --drm-drmprime-video-plane, --drm-osd-size to --drm-draw-surface-size

Deprecated

• options: deprecate --video-aspect, replaced by --video-aspect-override
• options: deprecate --record-file, --spirv-compiler

Removed

• options: remove deprecated --chapter option
• demux: remove "program" property
• stream: remove "disc-titles", "disc-title", "disc-title-list", and "angle" properties
• cocoa-cb: remove --macos-title-bar-style, replaced by --macos-title-bar-material and --macos-title-bar-appearance
• spirv: remove support for --spirv-compiler=nvidia (shaderc is the only remaining option)

Fixes and Minor Enhancements

• context_drm_egl: implement n-buffering
• cocoa-cb: add support for custom colored title bar
• vo_gpu: x11egl: support Mesa OML sync extension
• demux, demux_edl: add extension for tracks sourced from separate streams
• context_drm_egl: Use eglGetPlatformDisplayEXT if available
• vo_gpu: vulkan: add Android context
• wayland: use xdg-decoration if available
• vo_gpu: glx: use GLX_OML_sync_control for better vsync reporting
• demux: runtime option changing for cache and stream recording
• x11: fix ICC profiling for multiple monitors
• zsh completion: move generation to runtime and improve

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

A bug fix release for the 0.29 release branch.

Fixes and Minor Enhancements

• af_rubberband: Fix for A-V drift on seeking.
• ao_alsa: Fixes to remove spam during pausing and end-of-file.
• ao_jack: Fix for mpv attempting to connect to non-standard devices such as MIDI.
• ao_openal: Drop support for Apple's bundled OpenAL due to lack of features to successfully build.
• ao_pulse: Fix for audio buffer length calculation.
• demux_lavf: Fix EDL playback of certain DASH streams.
• demux_lavf: Mark v4l streams as not seekable.
• demux_raw: Fix for gapless playback from raw audio input.
• drm_atomic: Fix to enable video output with devices without a video overlay plane.
• encode: Fix for crashes in case of failure to write to output.
• encode: Fix for encoding when utilizing lavfi-complex.
• Fix to strip HDR peak metadata if attached to SDR video (#6111)
• macOS: Capability to fall back on SW rendering for testing purposes.
• macOS: Fix for issues with the main menu.
• macOS: Fix for side by side split view.
• macOS: Fixes for crashes, most notably those happening on 10.14 (#5908, #6097, #6041, #6062).
• macOS: No longer let older, unsupported versions of the Swift build tools through configure.
• manpage: Misc fixups.
• stream_{smb,file}: Fix for partial writes to buffers.
• stream_libarchive: Fix hang when an out-of-bound seek happens.
• stream_smb: Fix for crashes due to libsmbclient and threading (#5936).
• vo_gpu: Fix for corruption when multiple compute shaders override each others' block sizes (#6083).
• ytdl_hook: Always load "ytdl://" URLs with ytdl_hook first.
• ytdl_hook: Fix audio streams not being picked up for some sites.

Options and Commands

Added

• --cocoa-cb-sw-renderer to control whether or not to fall back on software rendering on macOS.

This release requires FFmpeg 4.0 or newer.

Features

Added

• ao/openal: Add better sample format and channel layout selection
• ao/openal: Add support for direct channels output
• cocoa-cb: initial implementation via opengl-cb API
• context_drm_egl: Introduce 30bpp support (requires Mesa 18.0.0_rc4 or later)
• osx: add some more menu bar items as suggested by Apples's HIG
• vo_gpu: make screenshots use the GL renderer (#5498, #5240)
• x11: support Shift+TAB as an input key bind (#5849)
• ytdl_hook: support native dash demuxer, if present

Changed

• ao_alsa, ao_pulse: reduce requested buffer size
• audio: change format negotiation, remove channel remix fudging
• client API: deprecate opengl-cb API and introduce a replacement API
• demux: lower demuxer cache default sizes from 400MB/400MB to 50MB/150MB
• osx: always deactivate the early opengl flush on macOS
• scripting: change when/how player waits for scripts being loaded
• vo_gpu: various improvements to HDR peak detection
• vo_gpu: various improvements to HDR tone mapping
• wayland_common: update to stable xdg-shell
• ytdl_hook: parse youtube playlist urls to set start index if --ytdl-raw-option=yes-playlist= is specified

Deprecated

• af_lavrresample: deprecate this filter

Removed

• build: drop support for SDL1 (only applied to ao_sdl)

Options and Commands

Added

• add a number of --audio-resample-* options, which should from now on be used instead of --af-defaults=lavrresample:
• ao/openal: --openal-direct-channels
• command: add --osd-on-seek option defaulting to bar
• command: add a change-list command (#5435)
• options: add --http-proxy
• options: add a builtin low-latency profile
• vaapi: add option to select a non-default device path with --vaapi-device (#4320)
• video: add option to reduce latency by 1 or 2 frames
• vo_gpu: introduce --target-peak (#5521)

Changed

• command: change cycle-value command behavior (#5772)
• config: replace config dir lua-settings/ with dir script-opts/
• options: --lavfi-complex now requires uniquely named filter pads.
• options: --ytdl is now always enabled, even for libmpv
• options: make --deinterlace=yes always deinterlace (#5219)
• options: slightly improve filter help output for lavfi bridge
• vo: rename --vo=opengl-cb to --vo=libmpv

Deprecated

• encoding: deprecate a bunch of obscure options (--ovoffset, --oaoffset, --ovfirst, --oafirst)
• options: deprecate --vf-defaults and --af-defaults
• osx: --gpu-context=cocoa with --gpu-api=opengl is now deprecated in favour of --vo=libmpv

Removed

• command: remove an old compatibility hack that allowed CLI aliases to be set as property, deprecated in 0.26.0
• input: remove legacy command handling for MPlayer commands that were deprecated in 2013
• options: drop --opensles-sample-rate, as --audio-samplerate should be used if desired
• options: drop deprecated --videotoolbox-format, --ff-aid, --ff-vid, --ff-sid, --ad-spdif-dtshd, --softvol options
• options: remove --video-stereo-mode
• options: remove deprecated ao/vo auto profiles
• options: remove the following encoding options: --ocopyts (now the default, old timestamp handling is gone), --oneverdrop (now default), --oharddup (you need to use --vf=fps=VALUE), --ofps, --oautofps, --omaxfps

Fixes and Minor Enhancements

• HIDRemote: fix volume buttons on macOS 10.13 (#5721)
• TOOLS/autoload: Fix broken "disabled" option
• TOOLS/autoload: be more robust with slow directory listings (#5618)
• ao_sdl: fix default buffer size
• build: add static libraries to libmpv.pc
• build: bump waf to 2.0.9 (fixes Python 3.7 compatibility)
• build: manually add standard library search paths for linking (#5791)
• common: round all integer times to milliseconds
• demux, player: fix playback of sparse video streams (w/ still images)
• demux: support for some kinds of timed metadata (e.g. ICY)
• demux_mkv: add V_AV1 identifier for AV1
• demux_mkv: support Meridian Lossless Packing in Matroska (#5923)
• display additional metadata tags during video playback
• drm_atomic: Fix memory leaks in drm_atomic_create
• enable cache for FUSE filesystems on OpenBSD and FreeBSD
• gpu: prefer 16bit floating point FBO formats to 16bit integer ones
• hwdec_vaegl: Fix VAAPI EGL interop used with gpu-context=drm
• input.conf: use exact value for [ binding, which does the inverse of ]
• input: add a keybinding to toggle hardware decoding
• input: minor additions to default key bindings (#973)
• osc: fix accidentally skipping files when seeking with slider
• player: fix strange behavior on edition switching
• player: fix track autoselection of external files yet again
• terminal-unix: stop trying to read when terminal disappears (#5842)
• video: actually wait for last frame being rendered on EOF
• video: fix --video-rotate in some cases
• video: fix crash with vdpau when reinitializing rendering (#5447)
• vo_gpu: fix anamorphic screenshots (#5619)
• vo_vdpau: fix resizing and rotation problems

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

This release contains an additional fix for CVE-2018-6360.

Fixes and Minor Enhancements

• ytdl_hook: whitelist subtitle URLs as well (#5456)

This release contains an additional fix for CVE-2018-6360.

Fixes and Minor Enhancements

• ytdl_hook: whitelist subtitle URLs as well (#5456)

This release fixes CVE-2018-6360.

Fixes and Minor Enhancements

• ytdl_hook: whitelist protocols from urls retrieved from youtube-dl (#5456)

This release fixes CVE-2018-6360.

Fixes and Minor Enhancements

• ytdl_hook: whitelist protocols from urls retrieved from youtube-dl (#5456)

This release needs recent FFmpeg (newer than 3.4) due to major refactoring.
Required library versions:

• libavutil >= 56.6.100
• libavcodec >= 58.7.100
• libavformat >= 58.0.102
• libswscale >= 5.0.101
• libavfilter >= 7.0.101
• libswresample >= 3.0.100

The LGPL 2.1+ relicensing process is now mostly complete. The remaining GPL-only
code (see Copyright file) can be disabled at build time by using --enable-lgpl.

Features

Added

• Add DRM_PRIME Format Handling and Display for RockChip MPP decoders
• csputils: Add support for Display P3 primaries
• demux: support multiple seekable cached ranges, display cache ranges on OSC
• demux_playlist: support .url files (#5107)
• dvb: Add multiple frontends support (up to 8)
• dvb: implement parsing of modulation for VDR-style channels config
• hwdec: add mediacodec hardware decoder for IMGFMT_MEDIACODEC frames,
  rename mediacodec to mediacodec-copy
• lua: integrate stats.lua script (bound to i/I by default)
• vd_lavc: add support for nvdec hwaccel
• vo_gpu: add android opengl backend
• vo_gpu: initial d3d11 support
• vo_gpu: vulkan support

Removed

• af: remove deprecated audio filters (channels, equalizer, pan, volume;
  replacements in lavfi)
• vf: remove most GPL video filters (crop, dsize, expand, flip, gradfun, mirror,
  noformat, pullup, rotate, scale, stereo3d, yadif; replacements in lavfi)
• vf_buffer: remove this filter
• video: remove automatic stereo3d filter insertion
• vo_gpu: remove hwdec_vaglx interop
• vo_opengl: refactor into vo_gpu
• vo_wayland: remove

Options and Commands

Added

• demux: add option to create CC tracks eagerly (--sub-create-cc-track)
• options: add --start=none to reset previously set start time
• options: add --vlang switch

Changed

• cache: lower default size to 2*10MB
• demux: bump the demuxer cache readahead duration to 10 hours
• demux: use seekable cache for network by default, bump prefetch limit
• msg: make --msg-level affect --log-file too
• player/misc.c: allow both --length and --end to control play endpoint
• player: match subtitles with language tags with --sub-auto=exact
• rename --opengl-hwdec-interop to --gpu-hwdec-interop (now mostly useless)
• vd_lavc: prefer nvdec over vdpau with --hwdec=auto (better codec and surface
  format support)
• vd_lavc: rename --hwdec=rpi to --hwdec=mmal

Removed

• options: remove --heartbeat-cmd and --heartbeat-interval
  (incidentally fixes #4888)

Fixes and Minor Enhancements

• TOOLS/autoload.lua: add ogm, ogg and opus extensions
• Use /dev/tty instead of stdin for terminal input (#4190)
• audio: add audio softvol processing to AO (replaces previously GPL’d code)
• audio: fix channel conversion with NA channels (e.g. with ALSA)
• audio: fix missing volume update on init and reinit
• csputils: Fix DCI P3 primaries white point
• demux: don't allow subtitles to mess up buffered time display
• demux: fix .cue files with audio files that contain attached pictures
• demux: fix accounting for seekable ranges on track switches (fixes missing
  audio when cycling through audio tracks with e.g. EDL, --merge-files, ordered
  chapters and youtube-dl pseudo DASH)
• demux: fix crash with cue/ordered chapter files (#5027)
• demux: speed up cache seeking with a coarse index
• demux_lavf: always give libavformat the filename when probing
  (helps with mp3 files)
• demux_mkv: add V_SNOW tag to mkv_video_tags
• dvb: Fix long channel switching: next/prev channel
• dvb: fixes for ATSC tuning
• lavc_conv: clamp timestamps to positive (#5047)
• macOS: fix bundle on macOS High Sierra (10.13) (#4926, #4866)
• mp_image: always copy color attributes on hw download (#4804)
• mp_image: select an explicit fallback for chroma location (#4804)
• msg: bump log level of --log-file to -v -v
• msg: reinterpret a bunch of message levels
• osc: fix rare stack overflow when changing visibility mode
• osdep/io: add android-related bullshit to fix files >2 GiB
• player/playloop.c: respect playback start time when using --loop-file
• player: allow seeking in cached parts of unseekable streams
• player: make track language matching case insensitive (#5272)
• player: use start timestamp for ab-looping if --ab-loop-a is absent
• player: when loading external file, always add all track types (#5132)
• restore-old-bindings.conf: add old macOS/Wayland AXIS bindings
• screenshot: create directories from template
• scripting: report dlerror() output
• sd_ass: accept RFC8081 font media types
• sd_ass: accept otc as fallback OpenType collection file extension
• stream_libarchive: work around various types of locale braindeath
  (https://git.io/vbiFJ)
• subprocess-win: don't change the mouse cursor when creating processes
• video: add a hack to avoid missing subtitles with vf_sub (#5194)
• video: fix alpha handling (#4983)
• video: fix memory leaks (roughly 1 KB per decoded frame) with hwdec copy modes
• video: fix rotation and deinterlace auto filters
• video: properly pass through ICC data
• vo: add support for externally driven renderloop and make wayland use it
  (partially fixes display-sync under wayland; disables rendering when window
  is invisible)
• vo_gpu: change --tone-mapping-desaturate algorithm
• vo_gpu: enable 3DLUTs in dumb mode
• vo_gpu: fix gamma scale
• vo_gpu: fix mobius tone mapping compatibility to GLSL 120 (#5069)
• vo_gpu: fix video sometimes not being rerendered on equalizer change
• vo_gpu: kill off FBOTEX_FUZZY (#1814)
• vo_gpu: opengl: fix possible screenshot window crash (#4905)
• vo_gpu: opengl: use GLX_MESA_swap_control where available
• vo_gpu: reduce the --alpha=blend-tiles checkerboard intensity
• vo_gpu: win: remove exclusive-fullscreen detection hack
• vo_lavc: remove messy delayed subtitle rendering logic (#4689)
• wayland_common: implement output tracking, many cleanups and bugfixes
• Windows: skip window snapping if Windows handled it
• Windows: add more-POSIXy versions of open() and fstat() (#4711)
• ytdl_hook: don't prepend ytdl:// to non-youtube links in playlists (#5003)

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

Features

Added

• Windows: handle media keys
• libmpv: options: add a thread-safe way to notify option updates
• vd_lavc/vo_opengl: support embedded ICC profiles
• vo: rendering API abstraction for future non-GL video outputs
• vo_opengl: add a gamut warning feature to highlight out-of-gamut colors (--gamut-warning)
• vo_opengl: add direct rendering support (--vd-lavc-dr)
• vo_opengl: implement (faster) compute shader based EWA kernel
• vo_opengl: implement HLG OOTF inverse
• vo_opengl: support HDR peak detection (--hdr-compute-peak)
• vo_opengl: support float input pixel formats
• vo_opengl: support loading custom user textures (#4586)
• vo_opengl: support user compute shaders

Removed

• Remove video equalizer handling from vo_direct3d, vo_sdl, vo_vaapi, and vo_xv (GPL, not worth the effort to support legacy VOs)

Options and Commands

Added

• macOS: add --no-native-fs option to disable the native macOS fullscreen (#4014)
• player: add --track-auto-selection option

Changed

• input: use mnemonic names for mouse buttons, same as Qt: https://doc.qt.io/qt-5/qt.html#MouseButton-enum
• options: change --loop semantics
• player: make --lavfi-complex changeable at runtime
• vf_eq: remove this filter (GPL; uses libavfilter’s eq filter now, with changed semantics)
• video: change --deinterlace behavior
• vo_opengl: generalize HDR tone mapping to gamut mapping, --hdr-tone-mapping → --tone-mapping

Removed

• --field-dominance (GPL-only author, no chance of relicensing)
• input: drop deprecated "osd" command
• options: drop --video-aspect-method=hybrid (GPL-only)

Fixes and Minor Enhancements

• TOOLS/autocrop.lua: fix cropdetect black limit for 10-bit videos
• TOOLS/lua/autodeint: update to lavfi-bridge
• TOOLS/lua/status-line: improve and update
• af_lavrresample: don't call swr_set_compensation() unless necessary (#4716)
• ao_oss: fix period_size calculation (#4642)
• ao_rsound: allow setting the host
• audio: fix spdif mode
• filter_kernels: correct spline64 kernel
• macOS: fix media keys input when other Apps steal the priority (#4834)
• macOS: fix the support of multiple renderers (GPU switch) (#2371)
• macOS: remove the standard "Show Tab Bar" menu item
• options: fix --include (#4673)
• player: fix --end with large values (#4650)
• player: fix confusion in audio resync code (#4688)
• player: make refresh seeks slightly more robust (#4757)
• player: readd smi subtitle extension (#4626)
• vd_lavc: change auto-probe order to prefer cuda over vdpau-copy
• vd_lavc: fix device leak with copy-mode hwaccels (#4735)
• vd_lavc: fix hwdec compatibility with yuvj420p formats
• vd_lavc: fix mid-stream hwdec fallback
• vf_vapoursynth: fix inverted sign and restore 10 bit support (#4720)
• video: increase --monitorpixelaspect range
• vo_opengl: adjust the rules for linearization (#4631)
• vo_opengl: scale deband-grain to the signal range
• vo_opengl: tone map on the maximum signal component
• x11: fix that window could be resized when using embedding (#4784)
• ytdl_hook: resolve relative paths when joining segment urls (#4827)
• ytdl_hook: support fragments with relative paths, fixes segmented DASH

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

VA-API/VDPAU hardware decoding now requires FFmpeg > 3.2.
DVB support is disabled by default since it does not work with some older kernels.
Built-in V4L TV support is disabled by default. av://v4l2 can be used instead.
Support for C plugins is now enabled by default (#4491).

Many more parts of the player are now licensed under LGPL, see Copyright file.
Thanks to all contributors who have agreed to relicensing of their changes!
See #2033 for details.

Features

Added

• Universal Windows Plaform (UWP) support (libmpv only)
• csputils: implement sony s-gamut
• js: add javascript scripting support using MuJS
  See DOCS/man/javascript.rst for more details
• vo_opengl: add new HDR tone mapping algorithm (mobius, now default)
• vo_opengl: hwdec_cuda: Support separate decode and display devices
• vo_opengl: implement sony s-log1 and s-log2 trc
• vo_opengl: implement support for OOTFs and non-display referred content

Removed

• vf_dlopen: remove this filter

Options and Commands

Added

• vo_opengl: add --tone-mapping-desaturate
• vo_opengl: support tone-mapping-param for clip
• ytdl_hook: add option to exclude URLs from being parsed

Changed

• allow setting profile option with libmpv
• audio: move replaygain control to top-level options
• external_files: parse ~ in --{sub,audio}-paths
• options: change --sub-fix-timing default to no (#4484)
• options: expose string list actions for --sub-file option
• options: slight cleanup of --sub-ass-style-override
  • signfs → scale
  • --sub-ass-style-override → --sub-ass-override
• renamed the HDR TRCs st2084 and std-b67 to pq and hlg respectively
• replace vf_format's peak suboption by sig-peak, which is relative to the reference white level instead of in cd/m^2
• the following options change to append-by-default (and possibly separator):
  • --script
• video: change --video-aspect-method default value to container

Deprecated

• m_option: deprecate multiple items for -add etc.
• player: deprecate "osd" command
• --audio-file-paths => --audio-file-path
• --sub-paths => --sub-file-path
• --opengl-shaders => --opengl-shader
• --sub-paths => --sub-file-paths
• the following options are deprecated for setting via API:
  • "script" (use "scripts")
  • "sub-file" (use "sub-files")
  • "audio-file" (use "audio-files")
  • "external-file" (use "external-files")
    (the compatibility hacks for this will be removed after this release)

Removed

• chmap: remove misleading "downmix" channel layout name (#4545)
• demux_lavf: remove --demuxer-lavf-cryptokey option (#4579)
• input.conf: drop TV/DVB bindings
• options: remove remaining deprecated audio device selection options
  • --alsa-device
  • --oss-device
  • --coreaudio-exclusive
  • --pulse-sink
  • --rsound-host/--rsound-port
  • --ao-sndio-device
  • --ao-wasapi-exclusive
  • --ao-wasapi-device
• remove option --target-brightness
• remove property "video-params/nom-peak"

Fixes and Minor Enhancements

• TOOLS/lua/autoload.lua: actually sort files case insensitive (#4398)
• TOOLS/lua/autoload.lua: ignores all files starting with "."
• ao_openal: kill off device listing (#4311)
• ao_pulse: reorder format choice to prefer float and S32 over S16 as fallback format
• ao_wasapi: try correct initial format (#4582)
• command: add missing change notification for playlist-shuffle (#4573)
• demux_disc: fix bluray subtitle language retrieval (#4611)
• demux_mkv: fix alpha with vp9 + libvpx
• demux_mkv: support FFmpeg A_MS/ACM extensions
• ipc-unix: don’t truncate the message on EAGAIN (#4452)
• ipc: raise json nesting limit (#4394)
• macOS: fix mpv-wrapper.sh when used with csh or tcsh shell
• macOS: properly unhide Dock when quitting during System fs animation
• mpv_identify: replace deprecated fps property (#4550)
• options/path: fallback to USERPROFILE if HOME isn't set
• player: close audio device on no audio track
• player: fix potential segfault when playing dvd:// with DVD disabled (#4393)
• player: prevent seek position to jump around adjacent keyframes, e.g. when dragging the OSC bar on short videos (#4183)
• vo_opengl: bump up SHADER_MAX_HOOKS and MAX_TEXTURE_HOOKS to 64
• vo_opengl: correct off-by-one in scale=oversample
• vo_opengl: do not use vaapi-over-GLX (#4555)
• vo_opengl: fall back to ordered dither instead of blowing up (#4519)
• vo_opengl: tone map in linear XYZ instead of RGB
• x11: add 128x128 sized icon support
• ytdl_hook: add a header to support geo-bypass
• ytdl_hook: don't override start time set by saved state
• ytdl_hook: don't override user-set start time
• ytdl_hook: treat single-entry playlists as a single 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.25.0..v0.26.0
in the git repository or by visiting either
https://github.com/mpv-player/mpv/compare/v0.25.0...v0.26.0 or
https://git.srsfckn.biz/mpv/log/?qt=range&q=v0.25.0..v0.26.0