summaryrefslogtreecommitdiffstats
path: root/DOCS/man/mpv.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2019-11-04 16:24:57 +0100
committerwm4 <wm4@nowhere>2019-11-04 16:24:57 +0100
commit517489814d6bc4837a1c24f7601a77136564fb7a (patch)
treede32782d26a2b5f293e1dfb3e3faef14c3e1d4a6 /DOCS/man/mpv.rst
parent872df1e06f96d9b0716a91c412aabcc3af85e9ad (diff)
downloadmpv-517489814d6bc4837a1c24f7601a77136564fb7a.tar.bz2
mpv-517489814d6bc4837a1c24f7601a77136564fb7a.tar.xz
manpage: update input protocols
tv:// and pvr:// are gone, DVD almost. The former didn't really have any uses left, except webcams. Provide a replacement example for that. We don't need a separate section for DVD. If you use DVD, you're on your own. There's still enough documentation left to puzzle things together even if you don't read the source code.
Diffstat (limited to 'DOCS/man/mpv.rst')
-rw-r--r--DOCS/man/mpv.rst75
1 files changed, 20 insertions, 55 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index 6ca7c8f575..334fad4bdb 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -504,31 +504,6 @@ Some options only support a subset of the above.
Options of this type can be changed at runtime using the ``change-list``
command, which takes the suffix as separate operation parameter.
-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:: DVD subtitles
-
- 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
===================
@@ -650,12 +625,8 @@ Some profiles are loaded automatically. The following example demonstrates this:
::
- [protocol.dvd]
- profile-desc="profile for dvd:// streams"
- alang=en
-
- [extension.flv]
- profile-desc="profile for .flv files"
+ [extension.mkv]
+ profile-desc="profile for .mkv files"
vf=flip
The profile name follows the schema ``type.name``, where type can be
@@ -792,10 +763,10 @@ PROTOCOLS
``ytdl://...``
- By default, the youtube-dl hook script (enabled by default for mpv CLI)
- only looks at http URLs. Prefixing an URL with ``ytdl://`` forces it to
- be always processed by the script. This can also be used to invoke special
- youtube-dl functionality like playing a video by ID or invoking search.
+ By default, the youtube-dl hook script only looks at http(s) URLs. Prefixing
+ an URL with ``ytdl://`` forces it to be always processed by the script. This
+ can also be used to invoke special youtube-dl functionality like playing a
+ video by ID or invoking search.
Keep in mind that you can't pass youtube-dl command line options by this,
and you have to use ``--ytdl-raw-options`` instead.
@@ -820,29 +791,15 @@ PROTOCOLS
``bluray://`` is an alias.
-``dvd://[title|[starttitle]-endtitle][/device]`` ``--dvd-device=PATH``
+``dvd://[title][/device]`` ``--dvd-device=PATH``
Play a DVD. DVD menus are not supported. If no title is given, the longest
- title is auto-selected.
+ title is auto-selected. Without ``--dvd-device``, it will probably try
+ to open an actual optical drive, if available and implemented for the OS.
``dvdnav://`` is an old alias for ``dvd://`` and does exactly the same
thing.
-``dvdread://...:``
-
- Play a DVD using the old libdvdread code. This is what MPlayer and
- older mpv versions used for ``dvd://``. Use is discouraged. It's
- provided only for compatibility and for transition, and to work
- around outstanding dvdnav bugs (see "DVD library choices" above).
-
-``tv://[channel][/input_id]`` ``--tv-...``
-
- Analogue TV via V4L. Also useful for webcams. (Linux only.)
-
-``pvr://`` ``--pvr-...``
-
- PVR. (Linux only.)
-
``dvb://[cardnumber@]channel`` ``--dvbin-...``
Digital TV via DVB. (Linux only.)
@@ -866,9 +823,17 @@ PROTOCOLS
demuxer name, and ``options`` is the (pseudo-)filename passed to the
demuxer.
- For example, ``mpv av://lavfi:mandelbrot`` makes use of the libavfilter
- wrapper included in libavdevice, and will use the ``mandelbrot`` source
- filter to generate input data.
+ .. admonition:: Example
+
+ ::
+
+ mpv av://v4l2:/dev/video0 --profile=low-latency --untimed
+
+ This plays video from the first v4l input with nearly the lowest latency
+ possible. It's a good replacement for the removed ``tv://`` input.
+ Using ``--untimed`` is a hack to output a captured frame immediately,
+ instead of respecting the input framerate. (There may be better ways to
+ handle this in the future.)
``avdevice://`` is an alias.