summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-06-20 22:45:17 +0200
committerwm4 <wm4@nowhere>2014-06-20 22:52:16 +0200
commit199e3b27630ae45cd396b8af4fbb5bcccf0e2456 (patch)
tree817aa2511fe9278bcc95fce72f6af57395b973bc
parent689aae56b6697507564d3f91467abd3e33c3ee9f (diff)
downloadmpv-199e3b27630ae45cd396b8af4fbb5bcccf0e2456.tar.bz2
mpv-199e3b27630ae45cd396b8af4fbb5bcccf0e2456.tar.xz
manpage: explicitly document protocols
-rw-r--r--DOCS/man/en/mpv.rst91
1 files changed, 79 insertions, 12 deletions
diff --git a/DOCS/man/en/mpv.rst b/DOCS/man/en/mpv.rst
index 984e6b4d7c..ec03c4d252 100644
--- a/DOCS/man/en/mpv.rst
+++ b/DOCS/man/en/mpv.rst
@@ -15,18 +15,6 @@ SYNOPSIS
| **mpv** [options] [file|URL|-]
| **mpv** [options] --playlist=PLAYLIST
| **mpv** [options] files
-| **mpv** bd://[title][/device] [options]
-| **mpv** bdnav://[title][/device] [options]
-| **mpv** dvd://[title|[start\_title]-end\_title][/device] [options]
-| **mpv** dvdnav://[longest|menu|title][/device] [options]
-| **mpv** \tv://[channel][/input_id] [options]
-| **mpv** \pvr:// [options]
-| **mpv** \dvb://[card\_number@]channel [options]
-| **mpv** \mf://[filemask|\@listfile] [-mf options] [options]
-| **mpv** cdda://track[-endtrack][:speed][/device] [options]
-| **mpv** [file|mms[t]|http|httpproxy|rt[s]p|ftp|udp|smb]://[user:pass\@]URL[:port] [options]
-| **mpv** edl://[edl specification as in edl-mpv.rst]
-
DESCRIPTION
===========
@@ -446,6 +434,85 @@ taking screenshots is handled by the VOs, and adding the screenshot filter will
break hardware decoding. (The filter may still be useful for taking screenshots
at a certain point within the video chain when using multiple video filters.)
+PROTOCOLS
+=========
+
+``http://...``, ``https://``, ...
+ Many network protocols are supported, but the protocol prefix must always
+ be specified. mpv will never attempt to guess whether a filename is
+ actually a network address. A protocol prefix is always required.
+
+``-``
+ Play data from stdin.
+
+``smb://PATH``
+ Play a path from Samba share.
+
+``bd://[title][/device]`` ``--bluray-device=PATH``
+ Play a Blu-Ray disc. Currently, this does not accept iso files. Instead,
+ you must mount the iso file as filesystem, and point ``--bluray-device``
+ to the mounted directly.
+
+``bdnav://[title][/device]``
+ Play a Blu-Ray disc, with navigation features enabled. This feature is
+ permanently experimental.
+
+``dvd://[title|[starttitle]-endtitle][/device]`` ``--dvd-device=PATH``
+ Play a DVD. If you want dvdnav menus, use ``dvd://menu``. If no title
+ is given, the longest title is auto-selected.
+
+ ``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 use for ``dvd://``. Use is discouraged. It's provided only
+ for compatibility and for transition.
+
+``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.)
+
+``mf://[filemask|@listfile]`` ``--mf-...``
+ Play a series of images as video.
+
+``cdda://track[-endtrack][:speed][/device]`` ``--cdrom-device=PATH`` ``--cdda-...``
+ Play CD.
+
+``lavf://...``
+ Access any FFmpeg/Libav libavformat protocol. Basically, this passed the
+ string after the ``//`` directly to libavformat.
+
+``av://type:options``
+ This is intended for using libavdevice inputs. ``type`` is the libavdevice
+ 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.
+
+ ``avdevice://`` is an alias.
+
+``file://PATH``
+ A local path as URL. Might be useful in some special use-cases. Note that
+ ``PATH`` itself should start with a third ``/`` to make the path an
+ absolute path.
+
+``edl://[edl specification as in edl-mpv.rst]``
+ Stitch together parts of multiple files and play them.
+
+``null://``
+ Simulate an empty file.
+
+``memory://data``
+ Use the ``data`` part as source data.
+
.. include:: options.rst
.. include:: ao.rst