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)