summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2015-08-22 22:08:17 +0200
committerwm4 <wm4@nowhere>2015-08-22 22:08:17 +0200
commit602105dbdae5b35dfcd7c060349b42a990bd25a8 (patch)
tree8d07ab84dfa12396841010b3f7d066688f9352d2 /DOCS
parent1e4113040c533278f61f66e56e817aba5958f380 (diff)
downloadmpv-602105dbdae5b35dfcd7c060349b42a990bd25a8.tar.bz2
mpv-602105dbdae5b35dfcd7c060349b42a990bd25a8.tar.xz
player: add --playlist-pos option
Oddly often requested.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst11
2 files changed, 12 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index e74296c557..9d1390c808 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -20,6 +20,7 @@ Interface changes
::
--- mpv 0.10.0 will be released ---
+ - add --playlist-pos option
- add --video-sync* options
"display-sync-active" property
"vo-missed-frame-count" property
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index afa3eb55a8..c8b2460879 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -129,6 +129,17 @@ Playback Control
Specify which chapter to start playing at. Optionally specify which
chapter to end playing at. Also see ``--start``.
+``--playlist-pos=<no|index>``
+ Set which file on the internal playlist to start playback with. The index
+ is an integer, with 0 meaning the first file. The value ``no`` means that
+ the selection of the entry to play is left to the playback resume mechanism
+ (default). If an entry with the given index doesn't exist, the behavior is
+ unspecified and might change in future mpv versions. The same applies if
+ the playlist contains further playlists (don't expect any reasonable
+ behavior). Passing a playlist file to mpv should work with this option,
+ though. E.g. ``mpv playlist.m3u --playlist-pos=123`` will work as expected,
+ as long as ``playlist.m3u`` does not link to further playlists.
+
``--playlist=<filename>``
Play files according to a playlist file (Supports some common formats. If
no format is detected, it will be treated as list of files, separated by