exiftran(1) General Commands Manual exiftran(1)NAME
exiftran - transform digital camera jpeg images
SYNOPSIS
exiftran [ options ] file(s)
DESCRIPTION
exiftran is a command line utility to transform digital image jpeg images. It can do lossless rotations like jpegtran, but unlike jpegtran
it cares about the EXIF data: It can rotate images automatically by checking the exif orientation tag, it updates the exif informaton 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 flip vertical
-F flip horizontal
-t transpose
-T transverse
-nt Don't rotate exif thumbnail.
-ni Don't rotate jpeg image. You might need this or or the -nt option to fixup things in case you rotated 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.
-p Preserve timestamps (atime + mtime) when doing inplace editing.
EXAMPLES
Autorotate all jpeg files in the current directory:
exiftran -ai *.jpeg
SEE ALSO jpegtran(1), exif(1)AUTHOR
Gerd Knorr <kraxel@bytesex.org>
COPYRIGHT
Copyright (C) 2002 Gerd Knorr <kraxel@bytesex.org>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation,
Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
(c) 2003,04 Gerd Knorr exiftran(1)
Check Out this Related Man Page
fbi(1) General Commands Manual fbi(1)NAME
fbi - linux framebuffer imageviewer
SYNOPSIS
fbi [ options ] file ...
DESCRIPTION
fbi displays the specified file(s) on the linux console using the framebuffer device. PhotoCD, jpeg, ppm, gif, tiff, xwd, bmp and png are
supported directly. For other formats fbi tries to use ImageMagick's convert.
OPTIONS -h print usage info
-d device
framebuffer device to use. Default is the one your vc is mapped to.
-m mode
name of the video mode to use (video mode must be listed in /etc/fb.modes). Default is not to change the video mode.
-v be verbose: enable status line on the bottom of the screen.
-P Enable textreading mode. This has the effect that fbi will display large images without vertical offset (default is to center the
images). Space will first try to scroll down and go to the next image only if it is already on the bottom of the page. Useful if
the images you are watching text pages, all you have to do to get the next piece of text is to press space...
-t sec timeout: load next image after >sec< seconds without any keypress (i.e. slideshow)
-g gamma
gamma correction. Can also be put into the FBGAMMA environment variable. Default is 1.0. Requires Pseudocolor or Directcolor vis-
ual, doesn't work for Truecolor.
-r n select resolution. PhotoCD only, n = 1..5.
-s n set scroll steps in pixels (default is 50).
-f font
Set font. This can be anything fontconfig accepts. Try fc-list for a list of known fonts on your system. The fontconfig config
file is evaluated as well, so any generic stuff defined there (such as mono, sans) will work as well. It is recommended to use
monospaced fonts, the textboxes (help text, exif info) look better then.
-a Enable autozoom. fbi will automagically pick a reasonable zoom factor when loading a new image.
--autoup
Like autozoom, but scale up only.
--autodown
Like autozoom, but scale down only.
-u Randomize the order of the filenames.
-e Enable editing commands.
-b create backup files (when editing images).
-p preserve timestamps (when editing images).
--comments
Display comment tags (if present) instead of the filename. Probably only useful if you added reasonable comments yourself (using
wrjpgcom for example), otherwise you likely just find texts pointing to the software which created the image.
KEYS
cursor keys scroll large images
+, - zoom in/out
ESQ, Q quit
PgUp previous image
PgDn, Space next image
Return next image, write the filename of the current
image to stdout.
P pause the slideshow (if started with -t, toggle)
V enable/disable status line
H display textbox with brief help
I display textbox with some EXIF info
<number>g jump to image #<number>
<number>s set zoom to <number>%
The Return vs. Space key thing can be used to create a file list while reviewing the images and use the list for batch processing later on.
EDIT IMAGE
fbi also provides some very basic image editing facilities. You have to start fbi with the -e switch to use them.
Shift+D delete image
R rotate 90o clockwise
L rotate 90o counter-clock wise
The delete function actually wants a capital letter 'D', thus you have to type Shift+D. This is done to avoid deleting images by mistake
because there are no safety bells: If you ask fbi to delete the image, it will be deleted without questions asked.
The rotate function actually works for JPEG images only. It does a lossless transformation of the image.
COMMON PROBLEMS
fbi needs rw access to the framebuffer devices (/dev/fbN), i.e you (our your admin) have to make sure fbi can open the devices in rw mode.
The IMHO most elegant way is to use pam_console (see /etc/security/console.perms) to chown the devices to the user logged in on the con-
sole. Another way is to create some group, chown the special files to that group and put the users which are allowed to use the frame-
buffer device into the group. You can also make the special files world writable, but be aware of the security implications this has. On
a private box it might be fine to handle it this way though.
fbi also needs access to the linux console (i.e. /dev/ttyN) for sane console switch handling. That is obviously no problem for console
logins, but any kind of a pseudo tty (xterm, ssh, screen, ...) will not work.
SEE ALSO fbset(1), convert(1)AUTHOR
Gerd Knorr <kraxel@bytesex.org>
COPYRIGHT
Copyright (C) 1999-2004 Gerd Knorr <kraxel@bytesex.org>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation,
Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
(c) 1999-2004 Gerd Knorr fbi(1)