1fbi(1) General Commands Manual fbi(1)
2
6 fbi - linux framebuffer imageviewer
7
9 fbi [ options ] file ...
10
12 fbi displays the specified file(s) on the linux console using the
13 framebuffer device. PhotoCD, jpeg, ppm, gif, tiff, xwd, bmp and png
14 are supported directly. For other formats fbi tries to use ImageMag‐
15 ick's convert.
16
18 -h print usage info
19 -d device
21 framebuffer device to use. Default is the one your vc is mapped
22 to.
23 -m mode
25 name of the video mode to use (video mode must be listed in
26 /etc/fb.modes). Default is not to change the video mode.
27 -v be verbose: enable status line on the bottom of the screen.
29 -P Enable textreading mode. This has the effect that fbi will dis‐
31 play large images without vertical offset (default is to center
32 the images). Space will first try to scroll down and go to the
33 next image only if it is already on the bottom of the page.
34 Useful if the images you are watching text pages, all you have
35 to do to get the next piece of text is to press space...
36 -t sec timeout: load next image after >sec< seconds without any key‐
38 press (i.e. slideshow)
39 -g gamma
41 gamma correction. Can also be put into the FBGAMMA environment
42 variable. Default is 1.0. Requires Pseudocolor or Directcolor
43 visual, doesn't work for Truecolor.
44 -r n select resolution. PhotoCD only, n = 1..5.
46 -s n set scroll steps in pixels (default is 50).
48 -f font
50 Set font. This can be anything fontconfig accepts. Try fc-list
51 for a list of known fonts on your system. The fontconfig config
52 file is evaluated as well, so any generic stuff defined there
53 (such as mono, sans) will work as well. It is recommended to
54 use monospaced fonts, the textboxes (help text, exif info) look
55 better then.
56 -a Enable autozoom. fbi will automagically pick a reasonable zoom
58 factor when loading a new image.
59 --autoup
61 Like autozoom, but scale up only.
62 --autodown
64 Like autozoom, but scale down only.
65 -u Randomize the order of the filenames.
67 -e Enable editing commands.
69 -b create backup files (when editing images).
71 -p preserve timestamps (when editing images).
73 --comments
75 Display comment tags (if present) instead of the filename.
76 Probably only useful if you added reasonable comments yourself
77 (using wrjpgcom for example), otherwise you likely just find
78 texts pointing to the software which created the image.
79
81 cursor keys scroll large images
82 +, - zoom in/out
83 ESQ, Q quit
84 PgUp previous image
85 PgDn, Space next image
86 Return next image, write the filename of the current
87 image to stdout.
88 P pause the slideshow (if started with -t, toggle)
89 V enable/disable status line
90 H display textbox with brief help
91 I display textbox with some EXIF info
92 <number>g jump to image #<number>
93 <number>s set zoom to <number>%
94 The Return vs. Space key thing can be used to create a file list while
96 reviewing the images and use the list for batch processing later on.
97
99 fbi also provides some very basic image editing facilities. You have
100 to start fbi with the -e switch to use them.
101 Shift+D delete image
103 R rotate 90° clockwise
104 L rotate 90° counter-clock wise
105 The delete function actually wants a capital letter 'D', thus you have
107 to type Shift+D. This is done to avoid deleting images by mistake
108 because there are no safety bells: If you ask fbi to delete the image,
109 it will be deleted without questions asked.
110 The rotate function actually works for JPEG images only. It does a
112 lossless transformation of the image.
113
115 fbi needs rw access to the framebuffer devices (/dev/fbN), i.e you (our
116 your admin) have to make sure fbi can open the devices in rw mode. The
117 IMHO most elegant way is to use pam_console (see /etc/security/con‐
118 sole.perms) to chown the devices to the user logged in on the console.
119 Another way is to create some group, chown the special files to that
120 group and put the users which are allowed to use the framebuffer device
121 into the group. You can also make the special files world writable,
122 but be aware of the security implications this has. On a private box
123 it might be fine to handle it this way though.
124 fbi also needs access to the linux console (i.e. /dev/ttyN) for sane
126 console switch handling. That is obviously no problem for console
127 logins, but any kind of a pseudo tty (xterm, ssh, screen, ...) will not
128 work.
129
131 fbset(1), convert(1)
132
134 Gerd Knorr <kraxel@bytesex.org>
135
137 Copyright (C) 1999-2004 Gerd Knorr <kraxel@bytesex.org>
138 This program is free software; you can redistribute it and/or modify it
140 under the terms of the GNU General Public License as published by the
141 Free Software Foundation; either version 2 of the License, or (at your
142 option) any later version.
143 This program is distributed in the hope that it will be useful, but
145 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
146 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
147 Public License for more details.
148 You should have received a copy of the GNU General Public License along
150 with this program; if not, write to the Free Software Foundation, Inc.,
151 675 Mass Ave, Cambridge, MA 02139, USA.
152 (c) 1999-2004 Gerd Knorr fbi(1)