summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMartin Herkt <lachs0r@srsfckn.biz>2017-04-22 05:07:03 +0200
committerMartin Herkt <lachs0r@srsfckn.biz>2017-04-23 01:57:53 +0200
commiteabba2de4d4b135c9b2fe63435662e90a4d763e0 (patch)
treed0189ccf895386f7de6c8cbc58aa2cfd87230c1d
parent1bcb2f999e650c0c16f4f0ccd442d6db47e20f32 (diff)
downloadmpv-eabba2de4d4b135c9b2fe63435662e90a4d763e0.tar.bz2
mpv-eabba2de4d4b135c9b2fe63435662e90a4d763e0.tar.xz
Release 0.25.0v0.25.0
Also update release policy documentation and version extraction.
-rw-r--r--DOCS/release-policy.md17
-rw-r--r--RELEASE_NOTES2601
-rw-r--r--VERSION1
-rwxr-xr-xversion.sh12
4 files changed, 2617 insertions, 14 deletions
diff --git a/DOCS/release-policy.md b/DOCS/release-policy.md
index e68bc3524c..507f4c440e 100644
--- a/DOCS/release-policy.md
+++ b/DOCS/release-policy.md
@@ -7,8 +7,7 @@ contains breaking changes, such as changed options or added/removed features,
and Y is incremented if a release contains only bugfixes and other minor
changes.
-There is only one release branch that keeps track of the latest version and
-will not be maintained separately.
+Releases are tagged on the master branch and will not be maintained separately.
The goal of releases is to provide Linux distributions with something to
package. If you want the newest features, just use the master branch.
@@ -19,18 +18,22 @@ Releases other than the latest release are unsupported and unmaintained.
Release procedure
-----------------
-- Merge master into branch release/current.
+While on master:
-- Create and/or update the `RELEASE_NOTES` file.
+- Update the `RELEASE_NOTES` file.
-- Create and/or update the `VERSION` file.
+- Update the `VERSION` file.
- Update `DOCS/client-api-changes.rst` and `DOCS/interface-changes.rst`
(in particular, update the last version numbers if necessary)
-- Create tag v0.X.Y.
+- Commit changes.
-- Push branch and tag to GitHub.
+- Create signed tag v0.X.Y.
+
+- Add -UNKNOWN suffix to version in `VERSION` file.
+
+- Commit changes, push branch and tag to GitHub.
- Create a new GitHub release using the content of `RELEASE_NOTES` related to
the new version.
diff --git a/RELEASE_NOTES b/RELEASE_NOTES
new file mode 100644
index 0000000000..b78b82eb82
--- /dev/null
+++ b/RELEASE_NOTES
@@ -0,0 +1,2601 @@
+Release 0.25.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
+
+
+Release 0.24.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
+
+
+Release 0.23.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
+
+
+Release 0.22.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
+
+
+Release 0.21.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
+- command: add sub-speed property
+
+
+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