RepoMirrors/mpv
1
0
Fork 0
mirror of https://github.com/mpv-player/mpv synced 2025-01-05 22:49:58 +00:00
Code Issues Releases Wiki Activity

manpage: update input protocols

Browse Source 
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.
This commit is contained in:
wm4 2019-11-04 16:24:57 +01:00
parent 872df1e06f
commit 517489814d
1 changed files with 20 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
DOCS/man/mpv.rst
View File

@ -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`` Options of this type can be changed at runtime using the ``change-list``
command, which takes the suffix as separate operation parameter. 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 CONFIGURATION FILES
=================== ===================
@ -650,12 +625,8 @@ Some profiles are loaded automatically. The following example demonstrates this:
:: ::
[protocol.dvd] [extension.mkv]
profile-desc="profile for dvd:// streams" profile-desc="profile for .mkv files"
alang=en
[extension.flv]
profile-desc="profile for .flv files"
vf=flip vf=flip
The profile name follows the schema ``type.name``, where type can be The profile name follows the schema ``type.name``, where type can be
@ -792,10 +763,10 @@ PROTOCOLS
``ytdl://...`` ``ytdl://...``
By default, the youtube-dl hook script (enabled by default for mpv CLI) By default, the youtube-dl hook script only looks at http(s) URLs. Prefixing
only looks at http URLs. Prefixing an URL with ``ytdl://`` forces it to an URL with ``ytdl://`` forces it to be always processed by the script. This
be always processed by the script. This can also be used to invoke special can also be used to invoke special youtube-dl functionality like playing a
youtube-dl functionality like playing a video by ID or invoking search. video by ID or invoking search.
Keep in mind that you can't pass youtube-dl command line options by this, Keep in mind that you can't pass youtube-dl command line options by this,
and you have to use ``--ytdl-raw-options`` instead. and you have to use ``--ytdl-raw-options`` instead.
@ -820,29 +791,15 @@ PROTOCOLS
``bluray://`` is an alias. ``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 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 ``dvdnav://`` is an old alias for ``dvd://`` and does exactly the same
thing. 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-...`` ``dvb://[cardnumber@]channel`` ``--dvbin-...``
Digital TV via DVB. (Linux only.) Digital TV via DVB. (Linux only.)
@ -866,9 +823,17 @@ PROTOCOLS
demuxer name, and ``options`` is the (pseudo-)filename passed to the demuxer name, and ``options`` is the (pseudo-)filename passed to the
demuxer. demuxer.
For example, ``mpv av://lavfi:mandelbrot`` makes use of the libavfilter .. admonition:: Example
wrapper included in libavdevice, and will use the ``mandelbrot`` source
filter to generate input data. ::
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. ``avdevice://`` is an alias.