Provided by:
fbi_2.10-1ubuntu3_amd64 
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, xpm, xwd, bmp, png
and webp formats are supported natively. For other fbi tries to use
ImageMagick(1)´s convert(1).
OPTIONS
-h, --help
Print usage info.
-V, --version
Print fbi version number.
--store
Write command line arguments to config file ~/.fbirc.
-l file, --list file
Read image filelist from file.
-P, --text
Enable textreading mode. In this mode fbi will display large
images without vertical offset (default is to center the
images). The SPACE command 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 are text pages, all
you have to do to get the next piece of text is to press
space...
-a, --autozoom
Enable autozoom. Fbi will automagically pick a reasonable zoom
factor when loading a new image.
--(no)autoup
Like autozoom, but scale up only.
--(no)autodown
Like autozoom, but scale down only.
--(no)fitwidth
Use width only for autoscaling.
-v, --(no)verbose
Be verbose: enable status line on the bottom of the screen
(enabled by default).
-u, --(no)random
Randomize the order of the filenames.
--(no)comments
Display comment tags (if present) instead of the filename.
Probably only useful if you added reasonable comments yourself
(using wrjpgcom(1) for example), otherwise you likely just find
texts pointing to the software which created the image.
-e, --(no)edit
Enable editing commands.
--(no)backup
Create backup files (when editing images).
-p, --(no)preserve
Preserve timestamps (when editing images).
--(no)readahead
Read ahead images into cache.
--cachemem size
Image cache size in megabytes (default is 256).
--blend time
Image blend time in miliseconds.
-T n, --vt n
Start on virtual console n.
-s steps, --scroll steps
Set scroll steps in pixels (default is 50).
-t sec, --timeout sec
Start a continuous slideshow where each image is loaded at sec
second intervals without any keypress.
-1, --(no)once
Don't loop (only use with -t).
-r n, --resolution n
Select resolution, n = 1..5 (default is 3, only PhotoCD).
-g n, --gamma n
Gamma correction. Requires Pseudocolor or Directcolor visual,
doesn't work for Truecolor (default is 1).
-f <arg>, --font <arg>
Set font. This <arg> can be anything fontconfig accepts (see
fonts-conf(5)). Try fc-list(1) 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.
-d /dev/fbN, --device /dev/fbN
Use /dev/fbN device framebuffer. Default is the one your virtual
console is mapped to.
-m videomode, --mode videomode
Name of the video mode to use (video mode must be listed in
/etc/fb.modes). Default is not to change the video mode.
ENVIRONMENT
Fbi uses the following environment variables:
FBGAMMA
This variable may be used to specify a default gamma correction.
COMMAND USAGE
The commands take effect immediately; it is not necessary to type a
carriage return.
In the following commands, i is a numerical argument.
Scrolling
LEFT_ARROW, RIGHT_ARROW, UP_ARROW, DOWN_ARROW
Scroll large images.
PREV_SCREEN, k
Previous image.
NEXT_SCREEN, SPACE, j
Next image.
ig Jump to image #i.
RETURN Write the filename of the current image to stdout(3), then go to
the next image.
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:
fbi file1.gif file2.jpg file3.jpg > fileimagelist.lst
some RETURN and SPACE...
fbi -l fileimagelist.lst
Zoom
a Autozoom.
+ In.
- Out.
is Set zoom to i%.
Other
ESQ, q Quit.
v Toggle status line.
h Display textbox with brief help.
i Display textbox with some EXIF info.
p Pause the slideshow (if started with -t, toggle).
Edit mode
Fbi also provides some very basic image editing facilities. You have to
start fbi with the -e switch to use them.
D, Shift+d
Delete image.
r Rotate 90 degrees clockwise.
l Rotate 90 degrees counter-clock wise.
x Mirror image vertically (top / bottom).
y Mirror image horizontally (left to right).
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.
BUGS
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(7) 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 (/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
convert(1), fbset(1), fc-list(1), imagemagick(1), wrjpgcom(1), fonts-
conf(5), PAM(7)
AUTHOR
Gerd Hoffmann <gerd@kraxel.org>
COPYRIGHT
Copyright (c) 1999-2012 Gerd Hoffmann <gerd@kraxel.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.