diff options
| -rw-r--r-- | README.md | 18 | ||||
| -rw-r--r-- | transcode.sh.1 | 20 |
2 files changed, 37 insertions, 1 deletions
@@ -59,8 +59,9 @@ install -Dm644 transcode.sh.bash-completion \ ``` > **PATH note:** the script resets `PATH` to `/bin:/usr/bin:/usr/local/bin` -> for security. If your `ffmpeg` lives elsewhere (e.g. Homebrew on macOS, +> for security. If your `ffmpeg` lives elsewhere (e.g. Homebrew on macOS, > Nix), prepend its directory: +> > ```sh > PATH="/opt/homebrew/bin:$PATH" transcode.sh input.mp4 > ``` @@ -79,6 +80,21 @@ Each preset is sourced as Bash and must define an array named `ffargs`. The variable `output_pixel_format` is available and contains the automatically selected pixel format (derived from the input file). +Before the preset's `ffargs` are appended, the script always passes +these base arguments to `ffmpeg`: + +``` +-map 0 # include all streams from the input +-map_metadata 0 # copy all container-level metadata +-map_chapters 0 # copy all chapter markers +-c copy # default to stream copy for every stream +``` + +A preset therefore only needs to specify the streams it wishes to +re-encode (typically `-c:v:0`) and any associated encoder options. +All other streams — audio, subtitles, attachments — are passed through +unchanged unless the preset explicitly overrides them. + **Example — `~/.config/transcode.sh/presets/default.sh`:** ```sh diff --git a/transcode.sh.1 b/transcode.sh.1 index 9001e8a..fe38c21 100644 --- a/transcode.sh.1 +++ b/transcode.sh.1 @@ -158,6 +158,26 @@ The variable is available to presets and contains the automatically selected output pixel format string. .IP +Before the preset's +.B ffargs +are appended, the script always passes the following base arguments to +.BR ffmpeg (1): +.RS +.nf +\-map 0 # include all streams from the input +\-map_metadata 0 # copy all container\-level metadata +\-map_chapters 0 # copy all chapter markers +\-c copy # default to stream copy for every stream +.fi +.RE +.IP +A preset therefore only needs to specify the streams it wishes to +re-encode (typically +.BR \-c:v:0 ) +and any associated encoder options. All other streams — audio, +subtitles, attachments — are passed through unchanged unless the preset +explicitly overrides them. +.IP Example preset: .RS .nf |