summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorrcombs <rcombs@rcombs.me>2020-06-22 15:08:42 -0500
committerrcombs <rcombs@rcombs.me>2020-08-19 23:44:54 -0500
commitc9474dc9ed6172a5f17f66f4b7d367da6b077909 (patch)
tree7992ffd7e3b5049415951d8392f206592cb162c0 /DOCS/man
parentdb0f9fab67af4776ec82dd491413fe642fb2670a (diff)
downloadmpv-c9474dc9ed6172a5f17f66f4b7d367da6b077909.tar.bz2
mpv-c9474dc9ed6172a5f17f66f4b7d367da6b077909.tar.xz
player: add --subs-with-matching-audio option
This allows users to control whether full dialogue subtitles are displayed with an audio track already in their preferred subtitle language. Additionally, this improves handling for the forced flag, automatically selecting between forced and unforced subtitle streams based on the user's settings and the selected audio.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/options.rst12
1 files changed, 10 insertions, 2 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 5245e18cae..30ea5d7ce1 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -135,6 +135,11 @@ Track Selection
Note that if ``--lavfi-complex`` is set before playback is started, the
referenced tracks are always selected.
+``--subs-with-matching-audio=<yes|no>``
+ When autoselecting a subtitle track, select a non-forced one even if the selected
+ audio stream matches your preferred subtitle language (default: yes). Disable this
+ if you'd like to only show subtitles for foreign audio or onscreen text.
+
Playback Control
----------------
@@ -2487,9 +2492,12 @@ Subtitles
subtitles (if the difference is smaller than 210 ms, the gap or overlap
is removed).
-``--sub-forced-only``
+``--sub-forced-only=<auto|yes|no>``
Display only forced subtitles for the DVD subtitle stream selected by e.g.
- ``--slang``.
+ ``--slang`` (default: ``auto``). When set to ``auto``, enabled when the
+ ``--subs-with-matching-audio`` option is on and a non-forced stream is selected.
+ Enabling this will hide all subtitles in streams that don't make a distinction
+ between forced and unforced events within a stream.
``--sub-fps=<rate>``
Specify the framerate of the subtitle file (default: video fps). Affects