diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 20 |
1 files changed, 14 insertions, 6 deletions
@@ -134,9 +134,11 @@ An optional TOML configuration file can be placed at: ${XDG_CONFIG_HOME:-$HOME/.config}/transcode.sh/config.toml ``` -Use `--config-file FILE` to load an alternative path. CLI flags always take -precedence over values in the config file. The file must be valid TOML — an -unparseable file is a hard error. Requires `tomlq` when the file is present. +Use `--config-file FILE` to load an alternative path. CLI flags generally take +precedence over values in the config file. Skip codecs are additive by default: +configured codecs and CLI codecs are merged unless `--skip-codec-override` is +used. The file must be valid TOML — an unparseable file is a hard error. +Requires `tomlq` when the file is present. **Example `config.toml`:** @@ -169,10 +171,12 @@ quiet = false | `[output]` | `verbose` | boolean | `-v` | | `[size_report]` | `enabled` | boolean | `-s` / `--no-size-report` | | `[size_report]` | `file` | string | `--size-report-file` | -| `[skip]` | `codecs` | array of strings | `-S` (merged with CLI) | +| `[skip]` | `codecs` | array of strings | `-S` / `--skip-codec-override` | > **Note:** `[skip] codecs` from the config file and `--skip-codec` from the -> CLI are **merged** — both sources contribute to the skip list. +> CLI are **merged** by default — both sources contribute to the skip list. Use +> `--skip-codec-override` to ignore configured skip codecs and use only codecs +> provided through `--skip-codec` for that run. > **Note:** `[encoding] hwaccel` accepts `false` (disable), `true` (use `auto`), > or a method string such as `"vaapi"` or `"cuda"`. CLI `--hwaccel`/`--no-hwaccel` @@ -209,7 +213,8 @@ transcode.sh [OPTION] [--] FILE... | `-s`, `--size-report` | Print per-file size feedback and write a status TSV log | | `--no-size-report` | Disable a size report enabled in `config.toml` | | `--size-report-file PATH`, `--size-report-file=PATH` | Size report TSV path (default: `transcode_size_report`) | -| `-S LIST`, `--skip-codec LIST`, `--skip-codec=LIST` | Codecs to skip (comma/space/colon separated) | +| `-S LIST`, `--skip-codec LIST`, `--skip-codec=LIST` | Add codecs to the effective skip list (comma/space/colon separated) | +| `--skip-codec-override` | Use only codecs from `--skip-codec`, ignoring `[skip].codecs` from config | | `-l`, `--only-if-smaller` | Only replace original if new file is smaller | | `--no-only-if-smaller` | Do replace original even if new file is bigger | | `-p NAME`, `--preset NAME`, `--preset=NAME` | Preset to use (default: `default`) | @@ -238,6 +243,9 @@ transcode.sh --backup-dir ~/transcode-backups *.mp4 # Use a custom preset, only keep result if smaller, skip AV1 inputs transcode.sh --preset av1_fast --only-if-smaller --skip-codec av1 /media/films/*.mkv +# Temporarily replace the configured skip list with only HEVC +transcode.sh --skip-codec-override --skip-codec hevc input.mkv + # Run at a moderate priority and continue past failures transcode.sh --nice 10 --continue *.mp4 |