Skip to content

Instantly share code, notes, and snippets.

@lisamelton
Last active October 17, 2021 13:58
Show Gist options
  • Save lisamelton/f7f002ee20a534faf1f1 to your computer and use it in GitHub Desktop.
Save lisamelton/f7f002ee20a534faf1f1 to your computer and use it in GitHub Desktop.
Output from `transcode-video --help`
Transcode video file or disc image directory into format and size similar to
popular online downloads. Works best with Blu-ray or DVD rip.
Automatically determines target video bitrate, number of audio tracks, etc.
WITHOUT ANY command line options.
Usage: transcode-video [OPTION]... [FILE|DIRECTORY]...
Input options:
--scan list title(s) and tracks in video media and exit
--title INDEX select indexed title in video media
(default: main feature or first listed)
--chapters CHAPTER[-CHAPTER]
select chapters, single or range (default: all)
Output options:
-o, --output FILENAME|DIRECTORY
set output path and filename, or just path
(default: input filename with output format extension
in current working directory)
--mp4 output MP4 instead of Matroska `.mkv` format
--m4v " " with `.m4v` extension instead of `.mp4`
--chapter-names FILENAME
import chapter names from `.csv` text file
(in NUMBER,NAME format, e.g. "1,Intro")
--no-log don't write log file
--dry-run don't transcode, just show `HandBrakeCLI` command and exit
Quality options:
--big raise default limits for both video and AC-3 audio bitrates
(always increases output size)
--quick trade some precision for 45-50% increase in encoding speed
(more than 15% speedier than x264 encoder "fast" preset)
(avoids quality loss of "faster" and "veryfast" presets)
--preset veryfast|faster|fast|slow|slower|veryslow
apply x264 encoder preset
Video options:
--crop T:B:L:R set video crop values (default: 0:0:0:0)
(use `--crop detect` for optimal crop values)
(use `--crop auto` for `HandBrakeCLI` behavior)
--720p fit video within 1280x720 pixel bounds
--max-width WIDTH, --max-height HEIGHT
fit video within horizontal and/or vertical pixel bounds
--pixel-aspect X:Y
set pixel aspect ratio (default: 1:1)
(e.g.: make X larger than Y to stretch horizontally)
--force-rate FPS
force constant video frame rate
(`23.976` applied automatically for some inputs)
--limit-rate FPS
set peak-limited video frame rate
(`30` applied automatically for most inputs)
--filter NAME[=SETTINGS]
apply `HandBrakeCLI` video filter with optional settings
(`deinterlace` applied automatically for some inputs)
(refer to `HandBrakeCLI --help` for more information)
(can be used multiple times)
Audio options:
--main-audio TRACK[=NAME]
select main audio track with optional name
(default: 1 or first in selected language)
(default output can be two audio tracks,
both surround and stereo, i.e. "width" is `double`)
--add-audio TRACK[=NAME]|language[=CODE[,...]]|all
add track selected by number assigning it an optional name
or add tracks selected by one or more languages
or add all tracks
(language is indicated by ISO 639-2 code, e.g.: `eng`)
(multiple languages are separated by commas)
(default output is single AAC audio track,
i.e. "width" is `stereo`)
(can be used multiple times)
--audio-width TRACK|all=double|surround|stereo
set audio output "width" for specific track or all tracks
with `double` to allow room for two output tracks
with `surround` to allow single surround or stereo track
with `stereo` to allow only single stereo track
(can be used multiple times)
--ac3-bitrate 384|448|640
set AC-3 audio bitrate (default: 384)
--pass-ac3-bitrate 384|448|640
set AC-3 audio pass-through bitrate (default: 448)
--copy-audio TRACK|all
try to copy track selected by number in its original format
falling back to AC-3 format if original not allowed
or try to copy all tracks in same manner
(can be used multiple times)
--copy-audio-name TRACK|all
copy original track name selected by number
unless the name is specified with another option
or try to copy all track names in same manner
(can be used multiple times)
--no-audio disable all audio output
Subtitle options:
--burn-subtitle TRACK|scan
burn track selected by number into video
or `scan` to find forced track in main audio language
--force-subtitle TRACK|scan
add track selected by number and set forced flag
or scan for forced track in same language as main audio
--add-subtitle TRACK|language[=CODE[,...]]|all
add track selected by number
or add tracks selected by one or more languages
or add all tracks
(language is indicated by ISO 639-2 code, e.g.: `eng`)
(multiple languages are separated by commas)
(can be used multiple times)
--no-auto-burn don't automatically burn first forced subtitle
External subtitle options:
--burn-srt FILENAME
burn SubRip-format text file into video
--force-srt FILENAME
add subtitle track from SubRip-format text file
and set forced flag
--add-srt FILENAME
add subtitle track from SubRip-format text file
(can be used multiple times)
--bind-srt-language CODE
bind ISO 639-2 language code (default: und)
to previously forced or added subtitle
(can be used multiple times)
--bind-srt-encoding FORMAT
bind character set encoding (default: latin1)
to previously burned, forced or added subtitle
(can be used multiple times)
--bind-srt-offset MILLISECONDS
bind +/- offset in milliseconds (default: 0)
to previously burned, forced or added subtitle
(can be used multiple times)
Advanced options:
-E, --encoder-option NAME=VALUE|_NAME
pass x264 video encoder option by name with value
or disable use of option by prefixing name with "_"
(e.g.: `-E vbv-bufsize=8000`)
(e.g.: `-E _crf-max`)
(refer to `x264 --fullhelp` for more information)
(can be used multiple times)
-H, --handbrake-option NAME[=VALUE]|_NAME
pass `HandBrakeCLI` option by name or by name with value
or disable use of option by prefixing name with "_"
(e.g.: `-H stop-at=duration:30`)
(e.g.: `-H _markers`)
(refer to `HandBrakeCLI --help` for more information)
(some options are not allowed)
(can be used multiple times)
Diagnostic options:
-v, --verbose increase diagnostic information
-q, --quiet decrease " "
Other options:
-h, --help display this help and exit
--version output version information and exit
Requires `HandBrakeCLI`, `mp4track`, `mplayer` and `mkvpropedit`.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment