summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--RELEASE_NOTES370
1 files changed, 370 insertions, 0 deletions
diff --git a/RELEASE_NOTES b/RELEASE_NOTES
new file mode 100644
index 0000000000..6c37309db2
--- /dev/null
+++ b/RELEASE_NOTES
@@ -0,0 +1,370 @@
+Release 0.9.0 (Draft)
+=====================
+
+Changes
+-------
+
+Changes that may break users' config files have been annotated with a `(!)`.
+
+- Note: mpv is not compatible with Lua 5.3. Lua 5.1 or 5.2 is required.
+- The minimum required libass version is now 0.12.1 or newer.
+- The minimum required FFmpeg version is now 2.4.0 (equiv. Libav 11) or newer.
+- The internal libmpg123 support was removed. This was already not used by default in
+ the previous release.
+- `(!)` The LIRC support was removed. Configure LIRC remotes as input devices instead.
+- `(!)` The Linux Joystick support was removed.
+- `(!)` `--ass-use-margins` has been renamed to `--sub-use-margins` and applies
+ only to plain-text (non-ASS) subtitles (enabled by default). The new
+ `--ass-force-margins` option applies only to ASS subtitles (disabled by
+ default). To get the old behaviour back, enable both at the same time.
+- `(!)` The `--sub-scale-with-window` option now only applies to plain text
+ (non-ASS) subtitles (enabled by default). The new `--ass-scale-with-window`
+ option does the same but only with ASS subtitles (disabled by default).
+- `(!)` The range for the `param1` for the `gaussian` `vo_opengl` scaler has
+ been redefined. Instead of being an arbitrary 1-100 range, have a default
+ value of 1.0, and anything higher is blurrier.
+- `(!)` The `seek`, `playlist_next, `playlist_prev`, `loadfile` and `loadlist`
+ parameters no longer accept numerical parameters where symbolic parameter
+ names exist.
+- `(!)` `vo_opengl` changes:
+ - `(!)` The `smoothmotion` suboption has been renamed to `interpolation`.
+ The old name is still supported for now.
+ - `(!)` The `bilinear_slow` scaler has been renamed to `triangle`.
+ - `(!)` `scale-down` has been renamed to `dscale` and now has its own set of
+ config options (e.g. `dscale-radius`).
+ - `(!)` Scaler radius no longer defaults to `3` but to a preferred value
+ that may be different for each filter.
+ - The `scale-radius` option may now go down as low as `0.5`, which is the
+ value used by the `nearest` filter.
+ - `spline36` is the new `cscale` default for `opengl-hq`. This might break
+ setups that use `fbo-format=rgb8`. To work around it, leave `fbo-format`
+ as its default, or set to something higher than 8, or set `cscale=bilinear`,
+ the previous default.
+- `(!)` `vf_format` no longer converts video to YUYV if there is no parameter.
+ Video is now passed unchanged unless a format is specifically requested.
+- `(!)` The `--colormatrix`, `--colormatrix-input-range`,
+ `--colormatrix-output-range` and `--colormatrix-primaries` options have been
+ converted into `vf_format` suboptions. See commit 27715b7 and the manual for
+ details.
+- The `device` subption to `ao_wasapi` has been deprecated in favor of
+ `--audio-device`.
+- `--video-rotate` now allows 360 as an argument instead of stopping at 359.
+- Several improvements to `af_scaletempo`.
+- Options that have multiple options and also include a "yes" option now
+ default to that if specified with no arguments.
+- The default value of `--cache-default` is now 150000 (153.6 MB, ~146 MiB).
+- JPEG screenshots now use the same subsampling as the source video. The images
+ are still RGB regardless of source format though.
+
+Bug fixes
+---------
+
+- mpv no longer saves position on files that can't be resumed (issue #1701).
+- (X11) Fix the player thinking the mouse has left the window in some WMs /
+ embeddings (issue #1672).
+- mpv no longer freezes on wayland when the compositor stops asking it to draw
+ itself (e.g. when minimized) (issue #249).
+- `.ac3` files are no longer rejected by `--audio-file-auto` (issue #1759).
+- `ao_wasapi` now automatically enables `exclusive` when passthrough is
+ attempted (issue #1742).
+- Attempt to fix flickering on Intel VAAPI drivers with `--hwdec=vaapi` and
+ `--vo=opengl` (issue #1765).
+- `youtube-dl` will no longer download video streams when video playback
+ is disabled with `--no-video`.
+
+New features
+------------
+
+- `vo_opengl` features:
+ - Added `ewa_ginseng`, `ewa_hanning`, `robidoux`, `robidouxsharp`,
+ `oversample` and `haasnsoft` scalers.
+ - There are now `ewa_lanczonsoft` and `ewa_lanczossharp` aliases to
+ `ewa_lanczos` that are tuned to be blurrier and sharper, respectively.
+ - Added `gamma-auto` option that uses ambient light sensors to automatically
+ adjust the video gamma. See commit c028d78 for details.
+ - Added `blend-subtitles` option to draw subtitles directly into the video
+ instead of rendered afterwards. Potentially necessary for correct rendering
+ with files that use ASS subtitles for typesetting in combination with an
+ `icc-profile`. There is a default option for drawing after upscaling,
+ and a `video` option for drawing before upscaling. See details and warning
+ on the manual.
+ - There is now a `tscale` option, used to choose the temporal scaler used
+ in the `interpolation` mode (previously `smoothmotion`).
+ - There is a new `scale-blur` parameter to adjust the amount of blur that
+ most of the filters produce. Deviating from the default may introduce
+ artifacts in EWA filters.
+ - (Windows) There is now a `dwmflush` option that might help improve
+ rendering of high-fps video. Disabled by default. See manual for options.
+- New `pseudo-gui` builtin profile, automatically used when launched from
+ `mpv.desktop` or by opening `mpv.exe` on windows (`mpv.com` still works as
+ usual). The `pseudo-gui` tries to make the player window behave closer to
+ what a desktop player would do, by not immediately closing and allowing the
+ user to drag&drop files for playback. See manual for details.
+- Add support to pitch correct stretched audio with librubberband.
+- Add support for the Raspberry Pi 2's hardware decoder when FFmpeg (or Libav)
+ is built with `--enable-mmal`. See commit 8fff125 for details.
+- The `--cache` option now accepts a "yes" option, that always enables a
+ `--cache-default`-sized cache on all cases a cache can be used, unless
+ `--cache-default` disables caching.
+- `ao_pulse`, `ao_coreaudio` and `ao_wasapi` now support device hotplugging.
+- New `--osd-align-x` and `--osd-align-y` options can be used to align the OSD
+ independently from subtitles.
+- New `--osd-bold` and `--sub-text-bold` options can be enabled to bold all
+ OSD or plain-text subtitle text, respectively.
+- Added a default keybind to the `u` key that enables/disables ASS style
+ overriding. When enabled, is equivalent to `--ass-style-override=force`.
+- There is now a `MOUSE_ENTER` keybind, that is called when the mouse cursor
+ enters the VO from outside.
+- The new `--ytdl-params` option can be set to arguments that are always given
+ to `youtube-dl` invocations. There is no sanity checking, so invalid options
+ can prevent `mpv` from working with http URLs.
+- `vo_direct3d_shaders` now supports NV12 colorspace without using stretchrect,
+ but it seems no drivers actually support that.
+- (Client API) Added a `rescan_external_files` command, as requested on issue
+ #1586.
+- (Client API) If enabled, initializing the Client API will now also load the
+ user's `mpv.conf`.
+- (Client API) There's a new `mpv_opengl_cb_report_flip()` call for API users
+ to call to inform mpv of when exactly a frame was displayed.
+- (Client API) The `mpv_opengl_cb_render()` function was deprecated in favor
+ of the new, simpler `mpv_opengl_cb_draw()` function.
+- The `--input-file` argument may now also be a file descriptor in the form
+ "fd://N", where N is the FD number.
+
+This listing is not complete. A complete changelog can be seen by running
+`git log v0.8.0..v0.9.0` in the git repository.
+
+Release 0.8.3
+=============
+
+Changes
+-------
+
+- Documentation fixes and updates.
+- (Client API) Clarify `mpv_opengl_cb_render`'s viewport parameter behavior.
+
+Bug fixes
+---------
+
+- (X11) Fix crash on `vo_xv:no-colorkey` with the Overlay adapter. (bug #1629)
+- Make the video equalizer work correctly on some VAAPI drivers. (bug #1647)
+- Prevent OSD from disappearing when clicking on mozplugger. (bug #1672)
+- The new DVB-S2 support code, using S2API, now builds on FreeBSD.
+- Fix decoding of seekable matroska from unseekable network stream. (bug #1656)
+- (OSX) Fix crashing when closing a VO's window (usually at exit). (bug #1657)
+- (OSX) Unhide the mouse cursor when over the Dock or Launchpad. (bug #513)
+- (OSX) Fix mouse cursor autohiding when the player is fullscreen.
+- `vf_vavpp` (VAAPI postprocessing) now deinterlaces video correctly.
+- `smb://` streams now use the stream cache (used to be inefficient).
+- (Windows) Do not hide the mouse cursor when it is hovering the window menu.
+- Fix 8-channel output on `ao_jack`. (bug #1688)
+- Fix `--mf-fps` parameter on JPEG files. (bug #1689)
+- Fix anamorphic scaling being ignored if it was very minor.
+
+This listing is not complete. A complete changelog can be seen by running
+`git log v0.8.2..v0.8.3` in the git repository.
+
+Release 0.8.2
+=============
+
+Bug fixes
+---------
+
+- Fix OSD placement accidentally messed up in 0.8.1.
+
+Release 0.8.1
+=============
+
+Changes
+-------
+
+- DOCS/client-api-changes has been correctly updated for the v0.8.0 release
+ series.
+- Quality and major perfomance improvements to smoothmotion.
+- Silence the "[ytdl_hook] WARNING: video doesn't have subtitles" warning.
+- Other documentation updates.
+
+Bug fixes
+---------
+
+- Attempt to fix OpenGL shader compilation on Intel windows drivers. (bug
+ #1536)
+- Attempt to improve the OpenGL shader's compatibility with GLES2.
+- (Windows) Fix noise when seeking while using wasapi:exclusive. (bug #1529)
+- Fix the waf-based build system when used with newer versions of waf with
+ python3.
+- Documentation fixes. (includes bug #1608)
+
+New features
+------------
+
+- mpv now tries to load '.vtt' subtitles.
+
+This listing is not complete. A complete changelog can be seen by running
+`git log v0.8.0..v0.8.1` in the git repository.
+
+Release 0.8.0
+=============
+
+Changes
+-------
+
+Changes that may break users' config files have been annotated with a `(!)`.
+
+- `(!)` vo_opengl_old has been removed. OpenGL rendering now requires hardware
+ that can do at least OpenGL 2.1, the oldest version supported by vo_opengl.
+- `(!)` vf_pp has been removed. A version of it can still be accessed through
+ lavfilter (e.g. --vf=lavfi=[pp...]), but it receives no QP information.
+ Also, vf_dlopen no longer passes QP information to its loaded plugin either
+ (it's always 0).
+- `(!)` vf_softpulldown, vf_swapuv, vf_phase, vf_divtc and vf_ilpack have all
+ been removed. Ports or alternative versions of these filters are available
+ through libavfilter (vf_lavfi).
+- vf_pullup and vf_noise now are simply wrappers to their libavfilter
+ equivalents. Both are only currently available on FFmpeg (not Libav).
+- `(!)` ao_portaudio has been removed. There is good support for the native
+ audio drivers of all major desktop platforms, as well as ao_sdl and
+ ao_openal as fallbacks.
+- `(!)` vo_opengl's `lscale` suboption has been renamed to `scale`; `lradius`
+ is now `scale-radius`, `lparam1` and `lparam2` are now respectively
+ `scale-param1` and `scale-param2`; `lscale-down` is now `scale-down`.
+ The `cscale` suboption remains as is.
+- `(!)` Several of the `vo_opengl` radius-preset aliases supported by `scale`
+ have been removed; use `scale-radius` to set if needed. For example, use
+ `--vo=opengl:scale=lanczos:scale-radius=2` instead of `scale=lanczos2`.
+ The default radius is recommended for most filters.
+- `(!)` vo_opengl no longer supports the `stereo` suboption. The anaglyph
+ effect can be reproduced with the stereo3d filter. The quadbuffer support,
+ which requires expensive specialized hardware to begin with, is removed.
+- `(!)` The `approx-gamma` suboption to vo_opengl has been removed. The
+ BT.1886 specification says that it's actually how it's supposed to be done
+ so it is now the default when `srgb` or `icc-profile` are enabled. This does
+ not include BT.1886's gamma drop.
+- `(!)` The `no-scale-sep` and `indirect` suboptions to vo_opengl have been
+ removed. These are now autodetected and enabled whenever they would have
+ benefit.
+- `(!)` The `--lua` and `--lua-opts` parameters / options are now called
+ `--script` and `--script-opts`, respectively. The `lua` subdir of the mpv
+ config dir is also now expected to be called `scripts` instead.
+- `(!)` The `--fixed-vo` option has been removed. It has been the default for
+ a long time anyway, and disabling fixed-vo is not useful.
+- vo_opengl_hq has been updated to take into account new features.
+ `fancy-downscaling` and `sigmoid-upscaling` are enabled,
+ "mitchell" is now the default for `scale-down`.
+- The `sub-visibility` OSD message is now clearer about whether subtitles
+ are hidden or just not available / selected.
+- The device IDs given to `--audio-device` for use with ao_coreaudio now use
+ UIDs, so they don't change when devices are added/removed or after reboots.
+- `--msg-level` now also accepts ',' as separator.
+- (Client API) The client API now refuses to initialize if the LC_NUMERIC
+ locale is not "C".
+- (Client API) The native type of the `msg-level` parameter is now a key-value
+ list. Setting or reading it as a string still works.
+- (Slave API) The `get_property` command is now deprecated.
+- Documentation updates.
+- PDF documentation is now disabled by default due to rst2pdf being fickle,
+ causing weird build errors.
+- Print desync messages with negative A/V sync as well. While rare, it could
+ happen with some uses of `--autosync`.
+
+Bug fixes
+---------
+
+- (Windows) Avoid resizing the video window when player is minimized, might
+ address bug #1547.
+- (NetBSD) Fix build with v4l2.
+- (Linux) Attempt to address conflicts with the pulseaudio mixer. (bug #1578)
+- Multiple cdda:// fixes. (bugs #1555, #1560)
+- VP9 timestamps no longer cause "missing PTS" warnings with new enough FFmpeg
+ builds.
+- Fix a crash when using H.264 hardware decoding on new enough libavcodecs.
+ (bug #1587)
+
+New features
+------------
+
+- vo_opengl now supports frame blending to eliminate stuttering when the video
+ framerate does not nicely match the display framerate through the
+ `smoothmotion` suboption. This is not meant to artificially increase the
+ video's FPS, so there is no "soap opera effect" or difficulties with some
+ video types (e.g. anime).
+- vo_opengl now supports sigmoidal upscaling (e.g. for fullscreen), which
+ reduces ringing induced by upscaling, enabled through the
+ `sigmoid-upscaling` suboption.
+- vo_opengl now supports ewa_lanczos (Jinc) scaling, which provides higher
+ quality with less aliasing. It supports an experimental `scale-antiringing`
+ parameter, which tries to further reduce video ringing.
+- vo_opengl now has a `linear-scaling` suboption, that makes the scalers work
+ in linear light. Implied by the `srgb`, `icc-profile` or the new
+ `sigmoid-upscaling` suboption.
+- vo_opengl has improved downscaling for higher downscale ratios when
+ `fancy-downscaling` is enabled.
+- Add `--keep-open=always` to make `--keep-open` apply to all files instead of
+ only the last.
+- mpv now filters the tags that are printed on the console to try to hide
+ useless metadata. The filter works as a whitelist, and can be configured
+ with the `--display-tags` option.
+- Add a `--sub-scale-by-window` option that, when set to 'no', prevents
+ subtitles from changing their pixel size when the window changes sizes.
+- vo_opengl now technically has GLES 2 and 3 support (but not GLES 1). GLES 3
+ support is only tested on Mesa's software emulation. GLES 2 has been tested
+ on nvidia drivers. Both GLES modes are feature deficient and inefficient due
+ to GLES limitations, so they should not be preferred over the standard
+ OpenGL mode.
+- (X11) vo_opengl now supports the `icc-profile-auto` option on X11 hosts.
+- The 'A' key now by default cycles through a list of preset aspect ratios.
+ Meant to be used to work around broken files.
+- There is now a "force" mode for `--loop`. Works like "inf", but tries to
+ open files/streams even if there was an error on the previous attempt.
+- There is now a `--log-file` option to write mpv's log messages to a specifed
+ file.
+- There is now a `--audio-file-auto` option to automatically load an external
+ audio file with certain constraints. Will only load external audio if the
+ playing file has a video stream. Set to "exact" by default. (bug #967)
+- There is now a `--network-timeout` option to specify a timeout in seconds
+ for network access. If 0 (default), uses the libavformat default. If a
+ protocol that doesn't support timeouts is used, this option is ignored.
+- (X11) The XF86 special keys are now all mappable in `input.conf`. All keys
+ documented in `XF86keysym.h` are available, but only as their numeric codes.
+- (Linux) The DVB implementation now supports DVB-S2 through S2API.
+- (Linux) The VDR format for `channels.conf` is now supported and preferred.
+ See http://linuxtv.org/vdrwiki/index.php/Syntax_of_channels.conf for the
+ syntax. Tuning to DVB-S2 channels requires the VDR-format `channels.conf`.
+- (Linux) There is now a `--dvbin-full-transponder` option for handling
+ special broadcast cases where PIDs switch, or just to work around incomplete
+ PID data.
+- (Client API) There is now an opengl_cb VO, which receives the OpenGL context
+ from the libmpv client. This allows a client to render libmpv video directly
+ to a provided OpenGL context without having to use --wid embedding.
+- (Client API) The aforementioned --wid parameter can now be set at any time,
+ but has no effect if a file is already loaded.
+- (Client API) The list of DVD titles can now be queried.
+- (Client API) There is now a `filtered-metadata` property, containing only
+ the tags allowed by `--display-tags`.
+- (Client API) There is now support for XEmbed `--wid` targets, such as a
+ `GtkSocket`'s `gtk_socket_get_id()`.
+- (Client API) There is now a `file-format` property with a symbolic name
+ for the file format. In some cases this might be a comma separated list
+ of various different extensions due to libavformat idiosyncrasies.
+- (Client API) There is now a `mouse` command for generating mouse events
+ over the video window.
+- (Client API) There is now a `partially-seekable` property that indicates
+ whether a file is only considered `seekable` because of the stream cache,
+ but would not be seekable otherwise (e.g. realtime stream, or HTTP with
+ no resume support). Small relative seeks may be fine, but larger seeks
+ will likely fail.
+- (Client API) There is now an MPV_EVENT_QUEUE_OVERFLOW event that is posted
+ whenever events have to be dropped because the queue is full. No further
+ events are posted until the MPV_EVENT_QUEUE_OVERFLOW is consumed to avoid
+ duplicated posting.
+- (Client API) There is now a helper `mpv_wait_async_requests()` function
+ that blocks until all known async requests have completed. (bug #1542)
+- (Client API) There is now a `detected-hwdec` property that returns the
+ detected hardware decoder when one is successfully opened. This probably
+ only returns a valid value after playback has started.
+- (Client API) There are now `audio_add`, `audio_remove` and `audio_reload`
+ counterparts to the equivalent `sub_` commands for handling external audio
+ files.
+
+This listing is not complete. A complete changelog can be seen by running
+`git log v0.7.0..v0.8.0` in the git repository.