summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorDudemanguy <random342@airmail.cc>2023-11-05 12:51:43 -0600
committerDudemanguy <random342@airmail.cc>2023-12-08 18:14:06 +0000
commitce958b77424327a30a3026c226a1db72f26e3543 (patch)
tree89cdf473787eb1b43055e73db5ffbb86d7cdfb5f /DOCS/man/options.rst
parentb7d85f0d4a5330cb3f433cd0cb4c977e10a168f7 (diff)
downloadmpv-ce958b77424327a30a3026c226a1db72f26e3543.tar.bz2
mpv-ce958b77424327a30a3026c226a1db72f26e3543.tar.xz
filter_sdh: add --sub-filter-sdh-enclosures option
This filter is a bit complicated, but one of the essential parts of it is removing text enclosed by particular set of characters (e.g. text inbetween []). This was previously hardcoded to only take into account parenthesis and brackets, but people may want to filter more things so make this customizable. The option only takes "left hand characters" so the right pair is mapped internally if applicable. If not, then we just use the same character. Fixes #8268 since the unicode character in question can just be passed to this option.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst16
1 files changed, 14 insertions, 2 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 97bf375c10..4a9dcfe3b8 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2898,8 +2898,11 @@ Subtitles
This is intended for English, but may in part work for other languages too.
The intention is that it can be always enabled so may not remove
all parts added.
- It removes speaker labels (like MAN:), upper case text in parentheses and
- any text in brackets.
+
+ It removes speaker labels (like MAN:) and any text enclosed within symbols like
+ parentheses or brackets as specified by the ``--sub-filter-sdh-enclosures`` option.
+ Note that parenthesis are a special case and only upper case text is removed. For
+ more filtering, you can use the ``--sub-filter-sdh-harder`` option.
Default: ``no``.
@@ -2910,6 +2913,15 @@ Subtitles
Default: ``no``.
+``--sub-filter-sdh-enclosures=<string>``
+ Specify a string of characters that ``--sub-filter-sdh`` will use to potentially
+ remove text. Text that is enclosed within characters specified by this string will
+ be removed. Note that bracket characters with known pairs (such as ``(`` or ``[``)
+ will be mapped internally to their matching right hand character, so you only need
+ to specify left hand characters.
+
+ Default: ``([``.
+
``--sub-filter-regex-...=...``
Set a list of regular expressions to match on text subtitles, and remove any
lines that match (default: empty). This is a string list option. See