Provided by: fbi_2.07-2_i386 bug

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)