OS Manuals

/usr/bin/jpegtran

Utilities for manipulating JPEG images

From libjpeg-turbo-utils 3.2.1-r0 (os), captured 2026-11-05 by running jpegtran --help (exit 1). permalink

usage: /usr/bin/jpegtran [switches] [inputfile]
Switches (names may be abbreviated):
  -copy none     Copy no extra markers from source file
  -copy comments Copy only comment markers (default)
  -copy icc      Copy only ICC profile markers
  -copy all      Copy all extra markers
  -optimize      Optimize Huffman table (smaller file, but slow compression)
  -progressive   Create progressive JPEG file
Switches for modifying the image:
  -crop WxH+X+Y  Crop to a rectangular region
  -drop +X+Y filename          Drop (insert) another image
  -flip [horizontal|vertical]  Mirror image (left-right or top-bottom)
  -grayscale     Reduce to grayscale (omit color data)
  -perfect       Fail if there is non-transformable edge blocks
  -roll +X+Y     Roll image (shift with wraparound)
  -rotate [90|180|270]         Rotate image (degrees clockwise)
  -transpose     Transpose image
  -transverse    Transverse transpose image
  -trim          Drop non-transformable edge blocks
                 with -drop: Requantize drop file to match source file
  -wipe WxH+X+Y  Wipe (gray out) a rectangular region
Switches for advanced users:
  -arithmetic    Use arithmetic coding
  -icc FILE      Embed ICC profile contained in FILE
  -restart N     Set restart interval in rows, or in blocks with B
  -maxmemory N   Maximum memory to use (in kbytes)
  -maxscans N    Maximum number of scans to allow in input file
  -outfile name  Specify name for output file
  -nooverwrite   Don't overwrite output file if it exists
  -report        Report transformation progress
  -strict        Treat all warnings as fatal
  -verbose  or  -debug   Emit debug output
  -version       Print version information and exit
Switches for wizards:
  -scans FILE    Create multi-scan JPEG per script FILE
Options (27)
OptionDescriptionSource
-copy noneCopy no extra markers from source file.help + man
-optimizeOptimize Huffman table (smaller file, but slow compression)help + man
-progressiveCreate progressive JPEG file.help + man
-crop WxH+X+YCrop the image to a rectangular region of width W and height H, starting at point X,Y.help + man
-drop +X+YDrop (insert) another image at point X,Yhelp + man
-flip horizontal|verticalMirror image (left-right or top-bottom)help + man
-grayscaleReduce to grayscale (omit color data)help + man
-perfectIf you are only interested in perfect transformations, add the -perfect switch.help + man
-roll +X+YRoll image (shift with wraparound) horizontally by X pixels and vertically by Y pixels.help + man
-rotate 90|180|270Rotate image 90 degrees clockwise.help + man
-transposeTranspose image (across UL-to-LR axis).help + man
-transverseTransverse transpose (across UR-to-LL axis).help + man
-trimDrop non-transformable edge blocks with -drop: Requantize drop file to match source filehelp + man
-wipe WxH+X+YWipe (gray out) a rectangular region of width W and height H from the input image, starting at point X,Y.help + man
-arithmeticUse arithmetic coding.help + man
-icc FILEEmbed ICC color management profile contained in the specified file.help + man
-restart NEmit a JPEG restart marker every N MCU rows, or every N MCUs if "B" is attached to the number.help + man
-maxmemory NSet limit for amount of memory to use in processing large images.help + man
-maxscans NAbort if the input image contains more than N scans.help + man
-outfile nameSend output image to the named file, not to standard output.help + man
-nooverwriteDon't overwrite output file if it existshelp
-reportReport transformation progress.help + man
-strictTreat all warnings as fatal.help + man
-verboseor -debug Emit debug outputhelp + man
-versionPrint version information and exit.help + man
-scans FILEUse the scan script given in the specified text file.help + man
-debugSame as -verbose. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.