fbi1

Usage

Overview

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.

--(no)interactive

Allow interactively controlling the program from the keyboard. This requires that stdin is a TTY. Default is to allow interactive control.

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.