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

This release drops support for OS X 10.7 and earlier. Support for some optical media functionality (DVD/CD) is now disabled by default.

More parts of the player are now licensed under LGPL. In particular:

• OSD symbol font
• ass_mp, sd_ass
• common.h
• demux/packet
• demux_mkv (with minor exceptions), ebml, matroska.h
• sd_lavc
• sub/osd

Thanks to all contributors who have agreed to relicensing of their changes! See #2033 for details.

Starting with this release, releases will be tagged on the master branch. The release/current branch is thus abandoned.

Features

Added

• TOOLS: add acompressor.lua script for runtime acompressor ffmpeg filter control
• dvb: add support for DVB-T2
• lavfi: support hwdec filters for --lavfi-complex
• macOS: initial Touch Bar support
• osc: add volume button (mouse wheel to change volume)
• sub: add SDH subtitle filter
• vo_opengl: add experimental vdpauglx backend
• vo_opengl: implement videotoolbox hwdec on iOS

Removed

• image_writer: remove useless formats (PPM, PGM, TGA)
• af_drc: remove (use --af=acompressor instead; higher quality)

Options and Commands

Added

• --demuxer-lavf-probe-info
• --sub-filter-sdh, --sub-filter-sdh-harder
• add automatic libavfilter bridges to option parsing
• command: add better runtime filter toggling method
• command: add demux-start-time property
• command: add property notifications for hwdec properties (#4289)
• input: add "async" flag
• osc: add user_opts.boxmaxchars for box layout title limit
• player: add --keep-open-pause=no option
• va_vavpp: reversal-bug=no
• vo_opengl: --opengl-es=force2
• vo_opengl: add --opengl-shader-cache-dir option for caching shaders on disk (mostly for ANGLE)
• vo_opengl: angle: add --angle-flip to set the ANGLE present model

Changed

• command: update sub-fps etc. options on runtime changes
• vo_opengl: prefer X11 backends over Wayland backends
• options: change --audio-file-auto default to not to load any files

Deprecated

• audio: deprecate most non-lavfi audio filters (channels, equalizer, pan, volume)
• video: deprecate almost all non-lavfi video filters (buffer, crop, dlopen, dsize, eq, expand, flip, gradfun, mirror, noformat, pullup, rotate, scale, stereo3d, sub, yadif)
• options: deprecate --loop semantics (planned alias to --loop-file)

Fixes and Minor Enhancements

• Windows: demux_cue: fix UTF-8 paths
• Windows: fix mismatched free/talloc_free (#4315)
• Windows: fix undefined behaviour when toggling fullscreen
• ao_alsa: close lost audio devices (#4189)
• ao_alsa: filter fewer devices
• ao_alsa: fix an error check (#4188)
• ao_jack: update latency on buffer_size/graph change
• ao_wasapi: do not pass nonsense to drivers with double precision formats
• ass_mp: reallocate cached subtitle image data on format changes (#4325)
• build: decouple dvdnav check from dvdread (#4290)
• build: encode_lavc: fix build failure after libavcodec major bump
• build: fix build with HAVE_GL==0
• build: replace android-gl check with a standard GLES3 check
• build: update bundled waf to 1.9.8
• build: vd_lavc: fix potential build failure with vaapi
• demux_lavf: disable half-working mp4 edit list support in libavcodec
• demux_lavf: skip avformat_find_stream_info() for some formats (hls, mp4, mkv by default)
• etc/encoding_profiles.conf: update and remove deprecated stuff
• etc/mpv.conf: remove deprecated options
• external_files: actually try to autoload from fallback paths
• external_files: enable autoloading with URLs (#3264)
• image_writer: make it work with libavcodec's jpg encoder
• macOS: add --ontop-level option for modifying ontop window level (#2376, #3974)
• macOS: add key mappings for previous and next Media Keys (#4204)
• macOS: add option to force dedicated GPU (#3242)
• macOS: fix autofit options on HiDPI resolutions without HiDPI scaling (#4194)
• macOS: fix black edges on live resize
• macOS: fix cursor hiding in the Dock area and top of the screen
• macOS: fix event propagation of menu bar item key shortcuts
• macOS: fix first responder when borderless window is used
• macOS: fix key input in certain circumstances
• macOS: fix retrieval of non-fullscreen window size, also while animating (#4323)
• macOS: fix scroll wheel input with Shift modifier (#3506)
• macOS: improve bundle environment variable handling (#2061)
• macOS: make window draggable on init
• macOS: only move window into screen bounds when changing screens (#4178)
• macOS: only report mouse movements when window is not being dragged (might have triggered OSC and other scripts)
• macOS: properly restore shell state when quitting from the Dock's context menu
• macOS: refactor mouse events and cursor visibility (#1817, #3856, #4147)
• macOS: set background of the title bar from black to white
• osc: bottom/topbar: add fullscreen button
• osc: bottom/topbar: don't clip title vertically
• osc: bottom/topbar: increase timecodes width a bit (#3952)
• osc: fix PlayResX undefined warning when aspect is 0
• osc: fix window dragging with showwindowed=no (#1819)
• osc: make title configurable and use property expansion on it (#4221)
• osc: refactor osc message scaling (#4081, #4083, #4102)
• player: don't block playback stop when seeking
• player: enable "buffering" pausing for DASH streams too
• player: fix core-idle and eof-reached update notifcations
• player: make screenshot commands honor the async flag (#4250)
• player: reduce blocking on VO when switching pause (#4152)
• sd_ass: disable --sub-fix-timing if sub style override is fully disabled
• stream/stream_dvdnav: don't ignore setting title (#4283)
• stream_dvd: fix subs/audio detection on DVDs containing multi-PGC titles
• vf_vavpp: add advanced deint bug compatibility for Intel vaapi drivers
• vf_vavpp: fix first-field mode
• vo_opengl: fix crash with temporal dithering in dumb mode
• vo_opengl: hwdec_d3d11egl: make it work with some ANGLE DLL versions
• vo_x11: reduce flickering on playlist navigation
• wayland: correctly map mouse buttons

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

Features

Added

• Windows: allow snapping to screen edges (#2248)
• macOS: add border cycling (#2430)
• player: add experimental C plugin interface
• player: add experimental stream recording feature (--record-file)
• player: add prefetching of the next playlist entry (--prefetch-playlist; does NOT work with URLs resolved by youtube-dl)
• stream_lavf: add support for data URIs (#4058)
• vaapi: add support for 10-bit video formats (requires patched Mesa and capable hardware)
• x11: pseudo HiDPI scaling

Options and Commands

Added

• sub: add --sub-justify and --sub-ass-justify options
• sub: add option to force using video resolution for image subtitles (--image-subs-video-resolution)

Changed

• command: rename framedrop properties
  • drop-frame-count → decoder-frame-drop-count
  • vo-drop-frame-count → frame-drop-count
• input.conf: change "L" to change loop-file by default

Deprecated

• --hwdec-preload (replaced with --opengl-hwdec-interop)

Removed

• options: drop deprecated --sub-codepage syntax
• options: drop deprecated --vd/--ad codecs selection features
• player: remove --stream-capture option/property

Fixes and Minor Enhancements

• Windows: update the fullscreen state on restoring
• ad_spdif: fix obscure cases of AC3 passthrough (e.g. 44100 Hz AC3)
• ao_oss: use --audio-device if --oss-device isn't set (#4122)
• build: fix --disable-gl if cuda is enabled
• build: rpi: rely on pkgconfig for compiler flags to ease cross compilation
• charset_conv: fallback to interpreting subs as latin1 if iconv fails
• charset_conv: fix "auto" fallback with uchardet not compiled (#3954)
• client API: fix freeze when destroying mpv_handle before mpv_initialize
• client API: fix mpv_set_property() return value before init (#3988)
• command: fix potential crash for script-binding with multi-commands
• command: nicer OSD formatting for loop-file
• command: shorten long playlists on OSD
• config: do not resolve default profile during "include" processing (#4024)
• cuda: fix 10 bit decoding
• cue: accept lower-case cue commands (#4057)
• demux_mkv: any reference makes a frame not a keyframe (fixes seeking in WebM files with alpha channel)
• lavfi: slightly better disconnected output handling (#4118)
• lua: close directory after reading its entries (#4045)
• macOS: consistent normalization when searching for external files (#4016)
• macOS: don't change Space on quit in fullscreen (#3957)
• macOS: don't constrain window frame for fullscreen (#4044)
• macOS: don't init displaylink on reconfig (#4031)
• macOS: fix build on OS X 10.9 (#3946)
• macOS: fix color profile retrieval
• macOS: fix displaylink refresh rate retrieval
• macOS: fix dropping of files and URLs (#4036)
• macOS: fix handling of geometry option (#3867)
• macOS: fix unwanted behavior with window level other than the default (#1757, #1884)
• macOS: fix window size in certain circumstances
• macOS: properly recover from toggleFullscreen fail (#4035)
• osc: allow playlist buttons when looping (#4092)
• osc: bottom/topbar: clip title instead of stretching
• osc: bottombar/topbar: make chapter markers slightly bigger
• osc: box: clip with ellipsis after too much stretching
• osc: fix crashes related to field eventresponder being nil (#3210)
• player: add .scc subtitle extension
• stream_bluray: use proper 0-based index
• sub: remove .txt as text subtitle extension
• tv: fix segfaults on TV input (#4096)
• vaapi: set libva > 0.39.4 message callbacks to prevent it from printing messages to the terminal
• vd_lavc: improved fallback behavior for --hwdec=cuda (#3914)
• vdpau: reject decoding of non-4:2:0 (would decode to garbage)
• vf_lavfi: don't crash with VOs without hardware decoding support (#4064)
• vo_opengl, vo_opengl_cb: better hwdec interop backend selection
• vo_opengl: angle: rewrite with custom swap chain (fixes problems with e.g. 24 fps video on 24 Hz monitors, avoids problems with DirectComposition, enables "screenshot window" command on Windows 8 and newer)
• vo_opengl: partially fix rotation for 4:2:2 content
• vo_opengl: x11egl: fix alpha mode
• wayland: fix high CPU usage with mpv paused and visible
• ytdl_hook, edl: implement pseudo-DASH support
• ytdl_hook: add non-dash fallbacks to default formats
• ytdl_hook: fix opening hitbox.tv rtmp stream
• ytdl_hook: respect --no-audio, don't force-select track
• ytdl_hook: support livestream segmented DASH VODs
• ytdl_hook: support 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.23.0..v0.24.0 in the git repository or by visiting either https://github.com/mpv-player/mpv/compare/v0.23.0...v0.24.0 or https://git.srsfckn.biz/mpv/log/?qt=range&q=v0.23.0..v0.24.0

Now requires at least FFmpeg 3.2.2.

Features

• vo_rpi: partially undeprecate

Added

• vo_opengl: hwdec_cuda: Support P016 output surfaces

Removed

• charset_conv: drop enca and libguess support in favor of uchardet
• vf_vdpaurb: remove this filter in favor of --hwdec=vdpau-copy

Options and Commands

Added

• TOOLS/autoload: allow disabling through script-opts
• demux, stream: add --access-references to prevent opening referenced files

Deprecated

• options: deprecate codec family selection in --vd/--ad

Removed

• macOS: remove --fs-black-out-screens
• options: remove deprecated sub-option handling for --vo and --ao

Fixes and Minor Enhancements

• Windows: window styles improvements (allow minimizing borderless/fullscreen window) (#2229, #2451)
• ad_spdif: Fix crash when spdif muxer is not available
• audio: fix --audio-stream-silence with ao_alsa
• audio: fix --audio-stream-silence with ao_wasapi
• build: drop build-time dependency on Perl
• build: support linking ANGLE (previously loaded dynamically)
• d3d11va: unconditionally load D3D DLLs (#3348)
• demux_mkv: fix seeking in some broken files (#3920)
• hwdec_cuda: allow building without CUDA SDK (load CUDA dynamically)
• macOS: fix dropping of URLs containing query strings on the window
• macOS: fullscreen refactoring (#2857, #3272, #1352, #2062, #3864)
• macOS: support append file to paylist on drop (#2166)
• macOS: update the menu and remove conflicting “Quit & remember position” item (#3865)
• osc: don't hide playlist buttons, just disable
• osc: fix possible race condition in right timecode
• osc: topbar: use same styles as bottombar
• player: don't print format detection error when aborting loading
• vdpau: fix vaapi probing if libvdpau-va-gl1 is present
• video: use demuxer-signaled duration for last video frame (#3924)

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

Features

Added

• audio/out: add AudioUnit output driver for iOS
• demux_mkv: parse Matroska colorimetry metadata
• filter_kernels: add ability to taper kernels/windows, add tukey window
• osc: add seekbarstyle=knob (#2365)
• video/out: add tct as modern caca alternative for true-color and 256-color terminals
• video: add --hwdec=vdpau-copy mode

Deprecated

• vf_vdpaurb: deprecated in favor of --hwdec=vdpau-copy

Options and Commands

Added

• --opengl-early-flush=auto
• --scale-taper, --scale-wtaper
• --scale-wblur
• macOS: --hidpi-window-scale (#3716)
• osc: add script message handlers for chapter/track/playlists

Fixes and Minor Enhancements

• Apply --autofit-larger after --autofit-smaller (#3753)
• Set subtitle track title to indicate hearing/visual impaired tracks
• ao_alsa: disable chmap API use for mono/stereo (#2905, #3045)
• build: add required failure message for libavfilter check (#3692)
• build: fix compilation with mingw-w64/Clang (#3800)
• build: make VideoToolbox available on iOS
• command: fix reset-on-next-file=all and tv-freq option (#3708)
• command: if window-scale can't be set properly, set it as option (#3724)
• demux_mkv: don't recursively resolve timeline for opened reference files
• demux_mkv: fix ordered chapter sources with ordered editions
• opengl: compile against iOS OpenGLES implementation
• options: handle legacy no-* sub-options
• osc: add alpha animation to tooltip (fix lingering tooltip)
• osc: change default deadzonesize to 0.5
• osc: don't wrap the title
• osc: fix crash after reaching a certain position in limited lists (#3691)
• osc: fix crash with no chapters
• osc: fix crashes when dragging seekbar across file changes (#3210)
• osc: fix displaying only half of the entries when at the end of a list
• osc: fix missing chapter ticks with seekbarstyle=bar
• osc: slimbox: fix clipping with seekbarstyle=bar (#3737)
• osc: top/bottombar: also scale when min-width is reached to match box/slimbox behavior
• osc: top/bottombar: dynamically size timecodes according to timems
• osc: top/bottombar: rescale layout to same size with scale=1
• osc: top/bottombar: scale title if too large like box
• player: consistently initialize screensaver state with --force-window
• player: enable no-video subtitle display on coverart too
• player: make --start-time work with --rebase-start-time=no
• player: make sure non-video subtitle rendering is reset if video resumes (#3770)
• player: removing last playlist entry while looping should not stop (#3808)
• player: show subtitles on VO if --force-window is used (#3684)
• player: speed up audio/video re-sync when there is a huge delay
• vdpau: fix hwdec uninit (#3788)
• vo_opengl: blend against background color for --alpha=blend
• vo_opengl: context_rpi: fix stdatomic usage (#3699)
• vo_opengl: fix --blend-subtitles handling (#3773)
• vo_opengl: fix redrawing with hardware decoding (#3773)
• vo_opengl: partially re-enable glFlush() calls (#3670)
• ytdl_hook: sort chapters by time

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

Features

Added

• config: allow profile forward-references in default profile
• demux_lavf: "support" mov edit lists and log errors if used (FFmpeg only)
• hwdec: Add support for CUDA and cuvid/NvDecode (mostly useful on Linux where VDPAU still lacks HEVC Main 10 support; keep using DXVA2 on Windows)
• osc: add right-click behavior to playlist and chapter buttons
• osc: add user-alterable margin for top/bottombar
• rpi: add --hwdec=rpi-copy (#3604)
• sd_lavc: enable teletext
• vaapi: support drm devices when running in vaapi-copy mode
• vd_lavc: Add hwdec wrapper for crystalhd
• vo_opengl: add hw overlay support and use it for RPI
• vo_opengl: basic mali fbdev support
• vo_opengl: rpi: merge vo_rpi features

Removed

• vo_opengl: remove pre/post/scale-shaders in favor of user-shaders

Deprecated

• config: deprecate ao and vo auto-profiles
• vo_rpi: deprecate this VO

Options and Commands

Added

• add --teletext-page option
• af_pan: add af-command support to change the matrix
• af_rubberband: add af-command and option to change the pitch
• command: add a load-script command
• command: add a video-dec-params property
• command: add an apply-profile command
• command: add audio-pts property to get the audio pts
• command: add options to property list
• command: add sub-text property for current subtitle text
• command: export profile list as a property (#977)
• options: add --hwdec=yes as alias for --hwdec=auto
• player: add --player-operation-mode=pseudo-gui
• player: add --video-osd=no option to disable video OSD (#3387)
• player: add --watch-later-directory option
• stream_bluray: select title by playlist (bd://mpls/[playlist])
• vo_opengl: disable glFlush() by default, and add an option to enable it for testing

Changed

• af_rubberband: default to channels=together
• command: allow absolute seeks relative to end of stream
• command: make bitrate properties observable
• command: make most options observable
• msg: make --log-file and --dump-stats accept config path expansion (#3591)
• options: deprecate --playlist-pos to --playlist-start
• options: make input options generally runtime-settable
• options: rename subtitle options (--sub-text- → --sub; --ass- → --sub-ass-)
• osc: change default layout to bottombar, seekbarstyle to bar, use larger scalewindowed and scalefullscreen
• player: make --terminal, --log-file, --dump-stats, --osc, --ytdl, --audio-*, --priority, --stop-screensaver (#3615) settable at runtime
• vo_drm: change CLI options
  • Change connector selection to accept human readable names (such as eDP-1, HDMI-A-2) rather than arbitrary numbers.
  • Change GPU selection to accept GPU number rather than device paths.
  • Merge connector and GPU selection into one --drm-connector.
  • Add support for --drm-connector=help.
  • Add support for --drm-* in EGL backend.
• vo_opengl: rename 3dlut-size to icc-3dlut-size

Removed

• command: remove hwdec-active and hwdec-detected properties
• command: remove vo-cmdline
• options: drop unreferenced --bluray-angle option
• vo, ao: disable positional parameter suboptions
• vo_xv: replace no-colorkey with ck-method=none

Deprecated

• all VOs and AOs: deprecate sub-options, add them as global options
• command: deprecate "cache" property, replace with "cache-percent"
• deprecate --vo-defaults
• deprecate --vo=opengl-hq alias in favor of opengl-hq profile
• options: deprecate --mute=auto
• vo_direct3d: deprecate direct3d_shaders alias, use shaders by default
• vo_opengl: deprecate 'drm-egl' backend and introduce 'drm' instead

Fixes and Minor Enhancements

• TOOLS/zsh.pl: die if we can't parse main options
• TOOLS/zsh.pl: don't filter files by extension (#2273)
• ao_alsa: try to fallback to "hdmi" before "iec958" for spdif
• ao_rsound: fix compilation (#3501)
• aspect: use nominal width instead of actual width for video-unscaled
• audio/out: prevent underruns with spdif under certain conditions
• audio: fix late audio start (#3610)
• audio: fix missed wakeup when changing audio output device
• audio: fix segfault when yanking USB DAC
• charset_conv: Use CP949 instead of EUC-KR
• command: don't log "ignore" command with -v verbosity
• command: try selecting the next track if track switching fails (#3446)
• demux_mkv: don't crash if --ordered-chapters-files fails
• displayconfig: treat a refresh rate of 1 as invalid
• ipc: log when listening to IPC socket (#3598)
• macOS: fix fullscreen regression on 10.11 and newer (#3364)
• mp_image: fix clearing to black with p010 format
• osc: Fix scaling issues when toggling fullscreen (#3429)
• osc: align text vertically in top/bottombar (#2093)
• osc: change seekbar background's alpha scaling
• osc: fix display of chapters and playlist scaling
• osc: move tooltip to inside seekbar for top/bottombar
• osc: show playlist/chapter list on prev/next instead of osd
• path: default ~~ paths to home directory (#3591)
• player: do not let pseudo-gui override user config settings
• player: enable reading from stdin after loading input.conf
• player: fix instant subtitle refresh on track switches
• player: make --force-window work with opengl-cb
• stream_file: don't use poll() on directories (would hang on macOS; #3530, #3649)
• stream_lavf: fix determining seekability (#1701)
• sub: actually apply text alignment options to non-ASS subtitles
• terminal-win: support modifier keys in console input (#3625)
• vo_drm: fix segfault when using invalid card
• vo_opengl: apply 90° rotation to chroma texture size (#3568)
• vo_opengl: fix incorrect video rendering after vdpau preemption recovery
• vo_opengl: partially fix dumb-mode cropping with rotation
• vo_opengl: rpi: use overlay for yuv420p too
• w32_common: initialize playback status as soon as possible (#3482)
• wayland: reject resize events with either dimension being 0 (#3679)
• x11: fix external fullscreen update (#3570)
• ytdl_hook: Add title to playlist items if available
• ytdl_hook: Set aspect ratio for anamorphic video
• ytdl_hook: Support playlist entries without subtitles
• ytdl_hook: add chapters by parsing video's description
• ytdl_hook: don't add subtitles with unknown duration
• ytdl_hook: temporarily force disable dash segments formats

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

Release 0.20.0

Options and Commands

Added

• aspect: add --video-unscaled=downscale-big
• player: add --image-display-duration option to control duration of image display (#3425)
• vo_opengl: angle: new flag (dcomposition) to control DirectComposition

Fixes and Minor Enhancements

• af_lavrresample: fix error if resampler could not be recreated
• audio: avoid missed wakeups with ab-loops
• audio: do not apply --audio-channels if spdif passthrough is in use (#3445)
• cache: don't use a backbuffer if the cache is as large as the file
• command: prevent O(n^2) behaviour for playlist property
• demux: close underlying stream if it's fully read anyway (#3456)
• demux: fix undefined behavior with ogg metadata update (#3451)
• player: make looping slightly more seamless
• player: refresh very low framerate video on filter changes (#3435)
• stream_memory: disable stream cache
• vf_rotate: allow arbitrary rotation (#3434)
• vo: be more trusting to estimated display FPS (#3433)
• w32_common: use hooks to detect parent window resize
• x11: work around mutter fullscreen issue (#2072)

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

Release 0.19.0

Build System Changes

• build: add --htmldir option
• build: always require atomics
• wscript: add proper unversioned SONAME for Android

Features

New

• client API: add stream_cb API for user-defined stream implementations (bumps client API version to 1.22)
• vf_d3d11vpp: add video processor selection
• videotoolbox: add --hwdec=videotoolbox-copy for h/w accelerated decoding with video filters
• vo_opengl: add a tscale=linear direct implementation

Removed

• audio/filter: remove delay audio filter

Options and Commands

Added

• command: add filename/no-ext sub-property that returns filename without extension (#3404)
• command: add properties for HDR metadata
• command: add replaygain information properties to track-list
• options: add vp9 to --hwdec-codecs
• player: add --audio-stream-silence
• player: add --audio-wait-open
• player: add --no-autoload-files
• videotoolbox: add yuv420p to --videotoolbox-format

Changed

• options: un-restrict --audio-delay
• use - as command-name separator everywhere
• vo_opengl: reduce default 3dlut-size to 64x64x64 (since accuracy is improved)

Deprecated

• deprecate "balance" option/property (no replacement)

Fixes and Minor Enhancements

• Windows: don't wait for GUI thread when polling for events (#3393)
• af_lavcac3enc: error out properly if encoding fails
• af_volume: don't let softvol overwrite af_volume volumedb sub-option
• ao_pulse: fix some volume control rounding issues
• ao_wasapi: in exclusive mode, do not output multichannel by default
• audio: add heuristic to move auto-downmixing before other filters
• audio: show an osd bar when changing ao-volume
• demux: make ALBUM replaygain tags optional (#3405)
• demux_raw: fix small typo to add s16be support
• demux_timeline: restore mkv edition switching
• libarchive: sanitize non-UTF8 archive entries
• macOS/vo_opengl: fix crash when glctx is NULL during init (#3360)
• player: disable display-sync with spdif transcoding
• player: do not cut off terminal status line if it contains newlines (#3340)
• player: fix display-sync timing if audio resumes slowly
• player: improve instant track switching (#3392)
• player: improve non-hr seeking with external audio tracks
• player: offset demuxer on start/seek properly with audio/sub delay
• player: sync audio as well when enabling it mid-stream
• stream/stream_bluray: display list of available titles in verbose mode
• sub: don't potentially discard too many subtitles on seek
• video: respect --deinterlace=auto
• vo_direct3d: add missing header (fixes Cygwin build)
• vo_opengl: angle: try D3D9 when D3D11 fails eglInitialize
• vo_opengl: angle: use WARP if there are no hw adapters (makes it work on Windows 7 without hardware-accelerated graphics)
• vo_opengl: increase 3DLUT accuracy at smaller LUT sizes
• vo_opengl: remove the 3dlut-size npot2 restriction
• vo_wayland: fix high CPU usage due to busy polling
• wayland_common: clip window size to the display output size
• wayland_common: fix crashes when switching to fullscreen before the video output is fully initialized
• wayland_common: fix fullscreen image switching bug
• wayland_common: prevent black bars on most non-native aspect ratios
• wayland_common: remove untested/unusable wayland dnd code
• win32: mpv.rc: re-add version info
• x11: skip ICC update on every window move
• ytdl: Error out with http_dash_segments (unsupported for now)

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

Release 0.18.1

Note: Running mpv with different versions of the FFmpeg/Libav libraries than it was compiled with is no longer supported. Even supposedly ABI-compatible versions have been a source of trouble, and it creates far too much complexity with little to no benefit, coupled with absurd and unusable FFmpeg API artifacts.

Instead, mpv will exit with an error when such a situation is detected. This simply means that mpv needs to be rebuilt whenever FFmpeg libraries change.

Features

New

• d3d: implement screenshots for --hwdec=d3d11va
• vo_opengl: add output_size uniform to custom shader
• vo_opengl: implement the Panasonic V-Log function (#3157)
• vo_opengl: implement ARIB STD-B68 (HLG) HDR TRC

Options and Commands

Changed

• command: pack sub image data in overlay-add command

Deprecated

• options: deprecate --heartbeat-cmd
• audio: deprecate --softvol

Removed

• audio: drop --softvol=no and --softvol=auto (#3322)

Fixes and Minor Enhancements

• video: fix deinterlace filter handling on pixel format changes
• x11: silence xdg-screensaver
• vo_opengl: angle: update the swapchain on resize (#3301)
• vo_opengl: error out gracefully when trying to use FBOs without FBO API
• vd_lavc: expose mastering display side data reference peak (improves results with HDR content)
• vo_opengl: generalize HDR tone mapping mechanism (#3293)
• vo_opengl: don't constantly resize the output FBO
• vo_opengl: use ringbuffer of PBOs
• Windows: make WM_NCHITTEST simpler and more accurate
• ao_oss: do not add an entry to audio-device-list if device file missing
• dec_audio: fix segment boudnary switching
• ao_lavc, vo_lavc: Migrate to new FFmpeg encoding API
• vo_opengl: explicitly use main framebuffer when reading window content (#3284)
• vo_xv: fix behavior with odd sizes
• audio: insert auto-inserted filters at end of chain
• x11: add missing FocusChangeMask (disables key repeat when losing focus while a key is down)
• ao_coreaudio: error out when selecting invalid device
• ad_lavc: work around misbehavior of some FFmpeg decoders like wmapro (#3297)
• player: cut off status line on terminal width

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

Release 0.18.0

Build System Changes

• build: Do not link to libGL for egl-drm
• build: also use the iconv check on FreeBSD
• build: don't install tests, only build them
• build: re-enable encoding mode by default
• vo_opengl: hwdec: remove build-dependency on dxva2 (#3150)
• wscript: make at least 1 OpenGL output mandatory

Features

New

• csputils: add SMPTE ST2084 support
• demux_mkv: support Matroska webvtt (#3247)
• demux_playlist: read directories recursively
• stream_memory: add hex:// protocol
• vf_crop: support opaque hardware decoding formats
• vf_d3d11vpp: add a D3D11 video processor filter
• vo_opengl: D3D11VA + ANGLE interop
• vo_opengl: add an angle-es2 backend
• vo_opengl: angle: dynamically load ANGLE
• vo_opengl: d3d11egl: native NV12 sampling support
• vo_opengl: enable color management on GLES
• vo_opengl: implement HDR (SMPTE ST2084)
• vo_opengl: implement tone mapping algorithms
• vo_opengl: make PBOs work on GLES 3.x
• vo_opengl: support external user hooks, enhancing the flexibility of user shaders
• vo_opengl: vdpau interop without RGB conversion
• wayland: implement HIDPI support

Removed

• vo_opengl: remove nnedi3 prescaler (replaced by user shaders)
• vo_opengl: remove prescaling framework with superxbr prescaler (replaced by user shaders)

Options and Commands

Added

• Windows: make taskbar progress indication optional (#2535)
• af_lavcac3enc: make encoder configurable
• command: add playlist-pos-1 property (#2828)
• command: introduce hwdec-current and hwdec-interop properties.
• options: add --fit-border video option (currently Windows only)
• video: add --hwdec=auto-copy mode
• vo_opengl: always autoselect ANGLE as backend if available
• vo_opengl: expose performance timers as properties
• x11: add --x11-bypass-compositor=never
• x11: extend --x11-bypass-compositor with fs-only option (#2582)

Changed

• command: allow setting panscan etc. properties if no video is active
• command: don't seek immediately when setting a-b loop while paused
• command: if only ab-loop-b is set, loop from start of file
• options: --geometry: center window position after applying size (#2397)
• player: loop on end of file if ab-loop-b is unset
• sd_add: replace --sub-ass=no with --ass-style-override=strip

Removed

• vo_opengl: remove non-working rgb/rgba FBO formats

Fixes and Minor Enhancements

• TOOLS/zsh.pl: add .f4v extension in zsh completions
• TOOLS/zsh.pl: complete --audio-device
• Windows: center window on original window center on resize to fit screen
• Windows: fix size calculations for window resize (#2935)
• Windows: fix wrong behavior with window-scale when window size exceeds screen size
• Windows: make VOCTRL_SET_UNFS_WINDOW_SIZE resize the window around its center (#3164)
• af_lavcac3enc: fix custom bitrates
• ao_alsa: add more workarounds for hardware with broken drivers (e.g. ODROID-C2)
• ao_opensles: remove 32-bit audio formats (not supported by Android)
• cocoa: fix actual display refresh rate retrieval
• cocoa: use displaylink without manually tracking the display id (#2392)
• command: improve playlist* properties change notifications (#3267)
• command: slightly nicer OSD list formatting
• compatibility with recent FFmpeg APIs
• d3d: fix hardware decoding of most MPEG2 things
• d3dva: move Intel_H264_NoFGT_ClearVideo to lower priority (#3059)
• demux_mkv: better resync behavior for broken google-created webms
• demux_mkv: fix seeking with files that miss the first index entry
• demux_playlist: recognize m3u8 as playlist extension (#3154)
• input: fix parsing multiple input command prefixes
• lcms: don't warn/error on 3dlut cache misses
• lcms: improve black point handling (especially BT.1886)
• macOS: handle multiple dropped files on the window (#3076)
• player: always show the first frame in DS mode
• player: assume video forwards timestamps jumps only with some formats (#3027)
• player: do not update OSD all the time when paused
• player: eagerly redraw OSD when seeking with coverart
• player: fix use-after-free with --screenshot-directory (#3049)
• player: force VO reconfig when unselecting video track
• player: really start audio only once video is ready
• sd_lavc: work around bug in older FFmpeg releases (#3109)
• stream_cdda: enable cache by default
• sub: fix --sub-gauss
• vd_lavc: better hwdec wrapper decoder selection
• vo_opengl: EGL: fix hwdec probing
• vo_opengl: angle: avoid fullscreen FBO copy for flipping
• vo_opengl: angle: enable DirectComposition (lowers vsync jitter)
• vo_opengl: angle: prevent DXGI hooking Alt+Enter
• vo_opengl: avoid outputting ultra-wide-gamut by default
• vo_opengl: correctly disable interpolation if tscale can't be used
• vo_opengl: fix bicubic_fast in ES mode
• vo_opengl: fix d3d11 hardware decoding probing on Windows 7
• vo_opengl: improve scale=oversample performance
• vo_opengl: make the screen blue on shader errors
• vo_opengl: partially fix 0bgr format support
• vo_opengl: possibly update icc profile after changing options
• vo_opengl: request core profile on X11/EGL too
• vo_opengl: require at least ES 3.0 for float textures
• vo_opengl: vdpau: fix certain cases of preemption recovery failures
• vo_rpi: attempt to survive display mode changes
• vo_rpi: fix destroying overlays (#3100)
• vo_rpi: wait for vsync with a timeout
• vo_sdl: fix pixel formats.
• vo_xv: Handle incorrect size returned by Xv(Shm)CreateImage (#320)
• wayland: correctly report display refresh rate
• wayland: use the advertised size in fullscreen (#3021, #2657)
• x11: tell GNOME to use dark window decorations
• ytdl_hook: fix brightcove urls
• ytdl_hook: just check if protocol is rtmp (#3090)
• ytdl_hook: support multi-arc subtitles

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