summaryrefslogtreecommitdiffstats
path: root/DOCS/man/mpv.rst
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS/man/mpv.rst')
-rw-r--r--DOCS/man/mpv.rst43
1 files changed, 43 insertions, 0 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index 84c5247d2f..6716c382f2 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -37,6 +37,10 @@ LIRC support - configure remotes as input devices instead).
See the ``--input-`` options for ways to customize it.
+The following listings are not necessarily complete. See ``etc/input.conf`` for
+a list of default bindings. User ``input.conf`` files and Lua scripts can
+define additional key bindings.
+
Keyboard Control
----------------
@@ -381,6 +385,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
===================