Provided by: handbrake-cli_1.3.1+ds1-1build1_amd64 bug

NAME

       HandBrakeCLI - versatile DVD ripper and video transcoder (command line)

DESCRIPTION

       Syntax: HandBrakeCLI [options] -i <device> -o <file>

   ### General Handbrake Options
       -h, --help
              Print help

       -u, --update
              Check for updates and exit

       -v, --verbose <#>
              Be verbose (optional argument: logging level)

       -Z. --preset <string>
              Use a built-in preset. Capitalization matters, and if the preset name has spaces, surround it with
              double quotation marks

       -z, --preset-list
              See a list of available built-in presets

       --no-dvdnav
              Do not use dvdnav for reading DVDs (experimental, enabled by default for testing)

   ### Source Options
       -i, --input <string>
              Set input device

       -t, --title <number>
              Select a title to encode (0 to scan all titles only, default: 1)

       --min-duration
              Set the minimum title duration (in seconds). Shorter titles will not be scanned (default: 10).

       --scan Scan selected title only.

       --main-feature
              Detect and select the main feature title.

       -c, --chapters <string>
              Select chapters (e.g. "1-3" for chapters 1 to 3, or "3" for chapter 3 only, default: all chapters)

       --angle <number>
              Select the DVD angle

       --previews <#:B>
              Select how many preview images are generated (max 30), and whether or not they're stored  to  disk
              (0 or 1).  (default: 10:0)

       --start-at-preview <#>
              Start encoding at a given preview.

       --start-at <unit:#>
              Start encoding at a given frame, duration (in seconds), or pts (on a 90kHz clock)

       --stop-at <unit:#>
              Stop encoding at a given frame, duration (in seconds), or pts (on a 90kHz clock)

   ### Destination Options
       -o, --output <string>
              Set output file name

       -f, --format <string>
              Set output format (mp4/mkv, default: autodetected from file name)

       -m, --markers
              Add chapter markers (mp4 and mkv output formats only)

       -4, --large-file
              Use 64-bit mp4 files that can hold more than 4 GB. Note: Breaks iPod, PS3 compatibility.

       -O, --optimize
              Optimize mp4 files for HTTP streaming

       -I, --ipod-atom
              Mark mp4 files so 5.5G iPods will accept them

   ### Video Options
       -e, --encoder <string>
              Set video library encoder Options: x264 / ffmpeg4 / ffmpeg2 / theora (default: ffmpeg4)

       --x264-preset <string>
              When using x264, selects the x264 preset:

              ultrafast / superfast / veryfast / faster / fast / medium / slow / slower / veryslow / placebo

       --x264-tune <string>
              When using x264, selects the x264 tuning:

              film / animation / grain / stillimage / psnr / ssim / fastdecode / zerolatency

       -x, --encopts <string>
              Specify  advanced  encoder  options  in  the  same  style  as  mencoder  (x264  and  ffmpeg only):
              option1=value1:option2=value2

       --x264-profile <string>
              When using x264, ensures compliance with the specified h.264 profile:

              baseline / main / high / high10 / high422 / high444

       -q, --quality <number>
              Set video quality

       -b, --vb <kb/s>
              Set video bitrate (default: 1000)

       -2, --two-pass
              Use two-pass mode

       -T, --turbo
              When using 2-pass use the turbo options on the first pass to improve speed (only works with  x264,
              affects PSNR by about 0.05dB, and increases first pass speed two to four times)

       -r, --rate
              Set  video framerate (5 / 10 / 12 / 15 / 23.976 / 24 / 25 / 29.97 / 30 / 50 / 59.94 / 60) Be aware
              that not specifying a framerate lets  HandBrake  preserve  a  source's  time  stamps,  potentially
              creating variable framerate video

       --vfr, --cfr, --pfr
              Select variable, constant or peak-limited frame rate control. VFR preserves the source timing. CFR
              makes the output constant rate at the rate given by the -r flag (or the source's average  rate  if
              no  -r  is  given).  PFR doesn't allow the rate to go over the rate specified with the -r flag but
              won't change the source timing if it's below that rate.  If none of these  flags  are  given,  the
              default is --cfr when -r is given and --vfr otherwise

   ### Audio Options
       -a, --audio <string>
              Select  audio  track(s),  separated  by  commas ("none" for no audio, "1,2,3" for multiple tracks,
              default: first one).  Multiple output tracks can be used for one input.

       -E, --aencoder <string>
              Audio encoder(s):
                  faac
                  ffaac
                  copy:aac
                  ffac3
                  copy:ac3
                  copy:dts
                  copy:dtshd
                  lame
                  copy:mp3
                  vorbis
                  ffflac
                  copy

              copy:* will passthrough the corresponding audio unmodified to the  muxer  if  it  is  a  supported
              passthrough  audio  type.   Separated by commas for more than one audio track.  (default: faac for
              mp4, lame for mkv)

       --audio-copy-mask <string>
              Set  audio  codecs  that  are  permitted  when  the  "copy"  audio  encoder  option  is  specified
              (aac/ac3/dts/dtshd/mp3, default: all).  Separated by commas for multiple allowed options.

       --audio-fallback <string>
              Set audio codec to use when it is not possible to copy an audio track without re-encoding.

       -B, --ab <kb/s>
              Set audio bitrate(s) (default: depends on the selected codec, mixdown and samplerate) Separated by
              commas for more than one audio track.

       -Q, --aq <quality>
              Set audio quality metric (default: depends on the selected codec) Separated  by  commas  for  more
              than one audio track.

       -C, --ac <compression>
              Set audio compression metric (default: depends on the selected codec) Separated by commas for more
              than one audio track.

       -6, --mixdown <string>
              Format(s) for surround sound downmixing Separated  by  commas  for  more  than  one  audio  track.
              (mono/stereo/dpl1/dpl2/6ch, default: up to 6ch for ac3, up to dpl2 for other encoders)

       -R, --arate
              Set  audio  samplerate(s)  (22.05/24/32/44.1/48  kHz)  Separated by commas for more than one audio
              track.

       -D, --drc <float>
              Apply extra dynamic range compression to the audio, making soft sounds louder. Range is 1.0 to 4.0
              (too  loud),  with  1.5  -  2.5 being a useful range.  Separated by commas for more than one audio
              track.

       --gain <float>
              Amplify or attenuate audio before encoding.  Does NOT work with audio passthru (copy). Values  are
              in dB.  Negative values attenuate, positive values amplify. A 1 dB difference is barely audible.

       -A, --aname <string>
              Audio track name(s), Separated by commas for more than one audio track.

   ### Picture Settings
       -w, --width <number>
              Set picture width

       -l, --height <number>
              Set picture height

       --crop <T:B:L:R>
              Set cropping values (default: autocrop)

       --loose-crop <#>
              Always crop to a multiple of the modulus Specifies the maximum number of extra pixels which may be
              cropped (default: 15)

       -Y, --maxHeight <#>
              Set maximum height

       -X, --maxWidth <#>
              Set maximum width

       --strict-anamorphic
              Store pixel aspect ratio in video stream

       --loose-anamorphic
              Store pixel aspect ratio with specified width

       --custom-anamorphic
              Store pixel aspect ratio in video stream and directly control all parameters.

       --display-width <number>
              Set the width to scale the actual pixels to at playback, for custom anamorphic.

       --keep-display-aspect
              Preserve the source's display aspect ratio when using custom anamorphic

       --pixel-aspect <PARX:PARY>
              Set a custom pixel aspect for custom anamorphic (--display-width and --pixel-aspect  are  mutually
              exclusive and the former will override the latter)

       --itu-par
              Use  wider,  ITU  pixel  aspect  values  for loose and custom anamorphic, useful with underscanned
              sources

       --modulus
              Set the number you want the scaled pixel dimensions

       <number>
              to divide cleanly by. Does not affect strict anamorphic mode, which is always mod 2 (default: 16)

       -M  --color-matrix <601 or 709>
              Set the color space signaled by the output (Bt.601 is  mostly  for  SD  content,  Bt.709  for  HD,
              default: set by resolution)

   ### Filters
       -d, --deinterlace <YM:FD:MM:QP> or <fast/slow/slower>
              Deinterlace video with yadif/mcdeint filter (default 0:-1:-1:1)

       -5, --decomb <MO:ME:MT:ST:BT:BX:BY:MG:VA:LA:DI:ER:NO:MD:PP:FD>
              Selectively        deinterlaces        when        it        detects       combing       (default:
              7:2:6:9:80:16:16:10:20:20:4:2:50:24:1:-1)

       -9, --detelecine <L:R:T:B:SB:MP:FD>
              Detelecine (ivtc) video with pullup filter Note: this filter drops duplicate frames to restore the
              pre-telecine   framerate,  unless  you  specify  a  constant  framerate  (--rate  29.97)  (default
              1:1:4:4:0:0:-1)

       -8, --denoise <SL:SC:TL:TC> or <weak/medium/strong>
              Denoise video with hqdn3d filter (default 4:3:6:4.5)

       -7, --deblock <QP:M>
              Deblock video with pp7 filter (default 5:2)

       --rotate <M>
              Flips images axes (default 3)

       -g, --grayscale
              Grayscale encoding

   ### Subtitle Options
       -s, --subtitle <string>
              Select subtitle track(s), separated by commas More than one output  track  can  be  used  for  one
              input.  Example: "1,2,3" for multiple tracks.  A special track name "scan" adds an extra 1st pass.
              This extra pass scans subtitles matching the language of the first audio or the language  selected
              by  --native-language.   The one that's only used 10 percent of the time or less is selected. This
              should locate subtitles for short  foreign  language  segments.  Best  used  in  conjunction  with
              --subtitle-forced.

       -F, --subtitle-forced <string>
              Only  display  subtitles  from  the  selected  stream if the subtitle has the forced flag set. The
              values in "string" are indexes into the subtitle list specified with '--subtitle'.   Separated  by
              commas  for  more  than one subtitle track.  Example: "1,2,3" for multiple tracks.  If "string" is
              omitted, the first track is forced.

       --subtitle-burned <number>
              "Burn" the selected subtitle into the video track If "number"  is  omitted,  the  first  track  is
              burned.  "number" is an index into the subtitle list specified with '--subtitle'.

       --subtitle-default <number>
              Flag  the  selected  subtitle  as  the default subtitle to be displayed upon playback.  Setting no
              default means no subtitle will be automatically displayed If "number" is omitted, the first  track
              is default.  "number" is an index into the subtitle list specified with '--subtitle'.

       -N, --native-language <string>
              Specify  your  language preference. When the first audio track does not match your native language
              then select the first subtitle that does. When used in conjunction  with  --native-dub  the  audio
              track  is changed in preference to subtitles. Provide the language's iso639-2 code (fre, eng, spa,
              dut, et cetera)

       --native-dub
              Used in conjunction with --native-language requests that if  no  audio  tracks  are  selected  the
              default  selected  audio  track will be the first one that matches the --native-language. If there
              are no matching audio tracks then the first matching subtitle track is used instead.

       --srt-file <string> SubRip SRT filename(s), separated by commas.

       --srt-codeset <string>
              Character codeset(s) that the SRT file(s) are encoded in, separated by commas.  Use 'iconv -l' for
              a list of valid codesets. If not specified latin1 is assumed

       --srt-offset <string>
              Offset  in milli-seconds to apply to the SRT file(s) separated by commas. If not specified zero is
              assumed.  Offsets may be negative.

       --srt-lang <string>
              Language as an iso639-2 code fra, eng, spa et cetera) for the SRT file(s) separated by commas.  If
              not specified then 'und' is used.

       --srt-default <number>
              Flag  the  selected srt as the default subtitle to be displayed upon playback.  Setting no default
              means no subtitle will be automatically displayed  If  "number"  is  omitted,  the  first  srt  is
              default.  "number" is an 1 based index into the srt-file list