exiftran man page

exiftran — transform digital camera jpeg images

Synopsis

exiftran [options] file1 file2 ... fileN

exiftran -i [transform options] [others options] file1 file2 ... fileN

exiftran -o outputfile [transform options] [other options] inputfile

exiftran -d file1 file2 ... fileN > exifinfo

Description

Exiftran is a command line utility to transform digital camera jpeg images. It can do lossless rotations like jpegtran(1), but unlike jpegtran(1) it cares about the EXIF data: It can rotate images automatically by checking the exif orientation tag; it updates the exif informations if needed (image dimension, orientation); it also rotates the exif thumbnail. It can process multiple images at once.

Transform Options

-a

Automatic (using exif orientation tag).

-9

Rotate by 90 degrees clockwise.

-1

Rotate by 180 degrees clockwise.

-2

Rotate by 270 degrees clockwise.

-f

Mirror image vertically (top / bottom).

-F

Mirror image horizontally (left to right).

-t

Transpose (across UL-to-LR corner).

-T

Transverse (across UR-to-LL corner).

-nt

Don't transform exif thumbnail.

-ni

Don't transform jpeg image. You might need this or the -nt option to fixup things in case you transformed the image with some utility which ignores the exif thumbnail. Just generating a new thumbnail with -g is another way to fix it.

-no

Don't update the orientation tag. By default exiftran sets the orientation to "1" (no transformation needed) to avoid other exif-aware applications try to rotate the already-rotated image again.

Other Options

-h

Print a short help text.

-d

Dump exif data for the file(s).

-c text

Set jpeg comment tag to text.

-g

(re)generate exif thumbnail.

-o file

Specify output file. Only one input file is allowed in this mode.

-i

Enable inplace editing of the images. Exiftran allows multiple input files then. You must specify either this option or a output file with -o for all operations which modify the image (i.e. everything but -d right now).

-b

Create a backup file when doing inplace editing (imply -i).

-p

Preserve timestamps (atime + mtime) when doing inplace editing (imply -i).

Examples

Autorotate all jpeg files in the current directory:

  exiftran -ai *.jpeg

See Also

exif(1), exiftags(1), jpegtran(1)

Author

Gerd Hoffmann <gerd@kraxel.org>

Info

(c) 2002-2012 Gerd Hoffmann EXIFTRAN 2.08 Transform digital camera jpeg images