From 006c9694c0990a05eb8f967448489958b6d7a5e8 Mon Sep 17 00:00:00 2001 From: archenemies Date: Sat, 23 Jan 2016 22:17:12 -0800 Subject: DOCS: explain about DVD situation in man page. Explains libdvdnav vs libdvdread situation (as much as I know), workarounds for bugs, and limitations of image-based subtitles. (try #4) --- DOCS/man/mpv.rst | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) (limited to 'DOCS') diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index 84c5247d2f..ec188d7bd5 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -381,6 +381,45 @@ file stops playing. If option ``--c`` is changed during playback of ``file2.mkv``, it is reset when advancing to ``file3.mkv``. This only affects file-local options. The option ``--a`` is never reset here. + +Playing DVDs +------------ + +DVDs can be played with the ``dvd://[title]`` syntax. The optional +title specifier is a number which selects between separate video +streams on the DVD. If no title is given (``dvd://``) then the longest +title is selected automatically by the library. This is usually what +you want. mpv does not support DVD menus. + +DVDs which have been copied on to a hard drive or other mounted +filesystem (by e.g. the ``dvdbackup`` tool) are accommodated by +specifying the path to the local copy: ``--dvd-device=PATH``. +Alternatively, running ``mpv PATH`` should auto-detect a DVD directory +tree and play the longest title. + +.. note:: + + mpv uses a different default DVD library than MPlayer. MPlayer + uses libdvdread by default, and mpv uses libdvdnav by default. + Both libraries are developed in parallel, but libdvdnav is + intended to support more sophisticated DVD features such as menus + and multi-angle playback. mpv uses libdvdnav for files specified + as either ``dvd://...`` or ``dvdnav://...``. To use libdvdread, + which will produce behavior more like MPlayer, specify + ``dvdread://...`` instead. Some users have experienced problems + when using libdvdnav, in which playback gets stuck in a DVD menu + stream. These problems are reported to go away when auto-selecting + the title (``dvd://`` rather than ``dvd://1``) or when using + libdvdread (e.g. ``dvdread://0``). + + DVDs use image-based subtitles. Image subtitles are implemented as + a bitmap video stream which can be superimposed over the main + movie. mpv's subtitle styling and positioning options and keyboard + shortcuts generally do not work with image-based subtitles. + Exceptions include options like ``--stretch-dvd-subs`` and + ``--stretch-image-subs-to-screen``. + + CONFIGURATION FILES =================== -- cgit v1.2.3