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 visual, 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 90° clockwise
       L               rotate 90° 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 console.  Another way is to create some group, chown  the  special  files  to  that
       group  and  put  the users which are allowed to use the framebuffer 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 MERCHANTABILITY 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)