summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/options.rst
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS/man/en/options.rst')
-rw-r--r--DOCS/man/en/options.rst61
1 files changed, 50 insertions, 11 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index f528c3f849..cd1b4ab90a 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -273,11 +273,6 @@
Some Blu-ray discs contain scenes that can be viewed from multiple angles.
Here you can tell mpv which angles to use (default: 1).
---bluray-chapter=<ID>
- (Blu-ray only)
- Tells mpv which Blu-ray chapter to start the current title from
- (default: 1).
-
--bluray-device=<path>
(Blu-ray only)
Specify the Blu-ray disc location. Must be a directory with Blu-ray
@@ -298,6 +293,12 @@
from slow media, but can also have negative effects, especially with file
formats that require a lot of seeking, such as mp4. See also ``--no-cache``.
+ Note that half the cache size will be used to allow fast seeking back. This
+ is also the reason why a full cache is usually reported as 50% full. The
+ cache fill display does not include the part of the cache reserved for
+ seeking back. Likewise, when starting a file the cache will be at 100%,
+ because no space is reserved for seeking back yet.
+
--cache-pause=<no|percentage>
If the cache percentage goes below the specified value, pause and wait
until the percentage set by ``--cache-min`` is reached, then resume
@@ -687,6 +688,13 @@
``--fstype=fullscreen``
Fixes fullscreen switching on OpenBox 1.x.
+--native-fs
+ (OS X only)
+ Use OSX's Mission Control's fullscreen feature instead of the custom one
+ provided by mpv. This can potentially break a lot of stuff like
+ ``--geometry`` and is disabled by default. On the other hand it provides
+ a more 'OS X-like' user experience.
+
--gamma=<-100-100>
Adjust the gamma of the video signal (default: 0). Not supported by all
video output drivers.
@@ -849,13 +857,25 @@
:vda: OSX
:crystalhd: Broadcom Crystal HD
+--hwdec-codecs=<codec1,codec2,...|all>
+ Allow hardware decoding for a given list of codecs only. The default is the
+ special value ``all``, which always allows all codecs.
+
+ This is usually only needed with broken GPUs, where fallback to software
+ decoding doesn't work properly.
+
+ *EXAMPLE*:
+
+ - ``mpv --hwdec=vdpau --vo=vdpau --hwdec-codecs=h264,mpeg2video``
+ Enable vdpau decoding for h264 and mpeg2 only.
+
--identify
Deprecated. Use ``TOOLS/mpv_identify.sh``.
--idle
Makes mpv wait idly instead of quitting when there is no file to play.
Mostly useful in slave mode where mpv can be controlled through input
- commands (see also ``--slave``).
+ commands (see also ``--slave-broken``).
--idx
Rebuilds index of files if no index was found, allowing seeking. Useful
@@ -895,7 +915,7 @@
Number of key presses to generate per second on autorepeat.
--no-input-default-bindings
- Use the key bindings that mpv ships with by default.
+ Disable mpv default (builtin) key bindings.
--input-keylist
Prints all keys that can be bound to commands.
@@ -908,7 +928,7 @@
--input-file=<filename>
Read commands from the given file. Mostly useful with a FIFO.
- See also ``--slave``.
+ See also ``--slave-broken``.
*NOTE*: When the given file is a FIFO mpv opens both ends so you
can do several `echo "seek 10" > mp_pipe` and the pipe will stay
@@ -1247,6 +1267,12 @@
--name
Set the window class name for X11-based video output methods.
+--native-keyrepeat
+ Use system settings for keyrepeat delay and rate, instead of
+ ``--input-ar-delay`` and ``--input-ar-rate``. (Whether this applies
+ depends on the VO backend and how it handles keyboard input. Does not
+ apply to terminal input.)
+
--avi-ni
(Internal AVI demuxer which is not used by default only)
Force usage of non-interleaved AVI parser (fixes playback of some bad AVI
@@ -1286,6 +1312,10 @@
Do not play sound. With some demuxers this may not work. In those cases
you can try ``--ao=null`` instead.
+--no-resume-playback
+ Do not restore playback position from ``~/.mpv/watch_later/``.
+ See ``quit_watch_later`` input command.
+
--no-sub
Disables display of internal and external subtitles.
@@ -1327,6 +1357,9 @@
--osd-back-color=<#RRGGBB>, --sub-text-back-color=<#RRGGBB>
See ``--osd-color``. Color used for OSD/sub text background.
+--osd-blur=<0..20.0>, --sub-text-blur=<0..20.0>
+ Gaussian blur factor. 0 means no blur applied (default).
+
--osd-border-color=<#RRGGBB>, --sub-text-border-color=<#RRGGBB>
See ``--osd-color``. Color used for the OSD/sub font border.
@@ -1703,9 +1736,6 @@
*EXAMPLE*:
- - ``mpv foreman.qcif --demuxer=rawvideo --rawvideo=qcif`` Play the
- famous "foreman" sample video.
-
- ``mpv sample-720x576.yuv --demuxer=rawvideo --rawvideo=w=720:h=576``
Play a raw YUV sample.
@@ -1748,6 +1778,15 @@
grayscale output with this option. Not supported by all video output
drivers.
+--save-position-on-quit
+ Always save the current playback position on quit. When this file is
+ played again later, the player will seek to the old playback position on
+ start. This affects any form of stopping playback (quitting, going to the
+ next file).
+
+ This behavior is disabled by default, but is always available when quitting
+ the player with Shift+Q.
+
--sb=<n>
Seek to byte position. Useful for playback from CD-ROM images or VOB files
with junk at the beginning. See also ``--start``.