summaryrefslogtreecommitdiff
path: root/transcode.sh.1
diff options
context:
space:
mode:
Diffstat (limited to 'transcode.sh.1')
-rw-r--r--transcode.sh.132
1 files changed, 28 insertions, 4 deletions
diff --git a/transcode.sh.1 b/transcode.sh.1
index c827336..2dd725a 100644
--- a/transcode.sh.1
+++ b/transcode.sh.1
@@ -151,12 +151,22 @@ in the current working directory.
.BR \-S " \fILIST\fR, " \-\-skip\-codec " \fILIST\fR, " \-\-skip\-codec= \fILIST\fR
Comma-, space- or colon-separated list of video codec names to skip.
Files whose detected input codec appears in this list are left untouched.
-Codecs specified here are merged with any codecs listed under
+By default, codecs specified here are merged with any codecs listed under
.B [skip] codecs
in
.B config.toml
\(em both sources contribute to the skip list.
.TP
+.BR \-\-skip\-codec\-override
+Ignore codecs listed under
+.B [skip] codecs
+in
+.B config.toml
+and use only codecs provided through
+.BR \-S / \-\-skip\-codec
+for this run. The position of this flag on the command line does not matter;
+it changes how the final skip list is resolved after all options are parsed.
+.TP
.BR \-l ", " \-\-only\-if\-smaller
After encoding, replace the original only when the new file is strictly
smaller. If the transcoded file is larger the temporary file is removed
@@ -358,8 +368,10 @@ sources.
.TP
.IR "${XDG_CONFIG_HOME:-$HOME/.config}/transcode.sh/config.toml"
Optional TOML configuration file. Provides defaults for all options.
-CLI flags always take precedence. The file must be valid TOML; an
-unparseable file is a hard error. Requires
+CLI flags generally take precedence. Skip codecs are additive by default:
+configured codecs and CLI codecs are merged unless
+.BR \-\-skip\-codec\-override
+is used. The file must be valid TOML; an unparseable file is a hard error. Requires
.BR tomlq (1).
Supported sections and keys:
.RS
@@ -400,7 +412,11 @@ CLI \fB--backup-dir\fR takes precedence.
.TP
.B [skip] codecs
Array of strings. Merged with any codecs from
-.BR \-S .
+.BR \-S
+by default. Use
+.BR \-\-skip\-codec\-override
+to ignore this configured list and use only codecs provided through
+.BR \-S / \-\-skip\-codec .
.TP
.B [size_report] enabled
Boolean. Equivalent to
@@ -492,6 +508,14 @@ transcode.sh \-N 10 \-S av1 input.mkv
.fi
.RE
.PP
+Temporarily replace configured skip codecs with only HEVC:
+.PP
+.RS
+.nf
+transcode.sh \-\-skip\-codec\-override \-S hevc input.mkv
+.fi
+.RE
+.PP
Load an alternative configuration file:
.PP
.RS