Further manpage refinements

without huge GUI dependencies, though it can also be started by

.Pq graphical

file managers to view an image.

By default

.Pq unless arguments or a filelist are specified ,

When no file arguments or filelists are specified,

.Nm

displays all files in the current directory.

.

.

Index mode forms an index print from the filelist.

Image thumbnails are shown along with the filename,

filesize and pixel size, printed using a truetype

size and dimensions, printed using a truetype

font of your choice.

The resulting image can be viewed or saved, and its size

can be limited by height, width or both.

thumbnails.

Use

.Cm --conversion-timeout Ar num

with a non-negative value to enable it.

with a non-negative value to enable support for these formats.

.

.

.Sh OPTIONS

.

Make the window fullscreen.

Note that in this mode, large images will always be scaled down to fit the

screen,

screen, and

.Cm --zoom Ar zoom

only affects smaller images and never scales larger than necessary to fit the

screen size.

.

.It Cm --insecure

.

When viewing files with HTTPS, this option disables strict hostname and peer

checking.

This allows images on sites with self-signed certificates to be opened, but is

no more secure than plain HTTP.

When viewing files with HTTPS, this option disables all certificate checks.  It

allows images on sites with self-signed or expired certificates to be opened,

but is no more secure than plain HTTP.

.

.It Cm --keep-zoom-vp

.

.

.It Cm --no-recursive

.

Don't recursively expand any directories (enabled by default).

Useful to override theme options.

Don't recursively expand any directories.

This is the default, but this option is useful to override themes containing

.Cm --recursive .

.

.It Cm -R , --reload Ar int

.

.Ar int

seconds.

Useful for viewing HTTP webcams or frequently changing directories.

.Pq Note that the filelist reloading is still experimental.

.Pq Note that filelist reloading is still experimental.

.

.Pp

.

Scroll

.Ar count

pixels whenever scroll_up, scroll_down, scroll_left or scroll_right is pressed.

Note that this option accepts negative numbers in case you need to inverse the

scroll direction; see

Note that this option accepts negative numbers in case you need to reverse the

scroll direction. See

.Sx KEYS CONFIG SYNTAX

to change it permanently.

for how to reverse it permanently.

Default: 20

.

.It Cm -D , --slideshow-delay Ar float

.

Redraw thumbnail window every

.Ar n

images.

In

.Nm

<= 1.5, the thumbnail image used to be redrawn after every computed thumbnail

.Pq so, it updated immediately .

However, since the redrawing takes quite long

.Pq especially for thumbnail mode on a large filelist ,

this turned out to be a major performance penalty.

As a workaround, the thumbnail image is redrawn every 10th image now by default.

images while generating thumbnails.

Redrawing takes quite long, so the default is 10.

Set

.Ar n No = 1

to get the old behaviour,

.Ar n No = 0

will only redraw once all thumbnails are loaded.

to update the thumbnail window immediately.

With

.Ar n No = 0 ,

there will only be one redraw once all thumbnails are loaded.

.

.El

.

All config files treat lines starting with a

.Qq #

character as comments.

Note that mid-line comments are not supported.

Comments at the end of a line are not supported.

.

.

.Sh THEMES CONFIG SYNTAX

.It m Bq toggle_menu

.

Show menu.

Use the arrow keys and return to select items,

Use the arrow keys and return to select items, and

.Aq escape

to close the menu.

.

.It Ao keypad Down Ac , Ao Ctrl+Down Ac Bq scroll_down

.

Scroll down.

Note that the scroll keys work without anti-aliasing for performance reasons,

Note that the scroll keys work without anti-aliasing for performance reasons;

hit the render key after scrolling to antialias the image.

.

.It Aq Alt+Left Bq scroll_left_page

.

Here are some examples of useful option combinations.

See also:

.Aq http://feh.finalrewind.org/examples/

.Aq https://feh.finalrewind.org/examples/

.

.Bl -tag -width indent

.

.

Show some EXIF information, extracted by exifprobe/exifgrep

.

.It feh --action 'rm %F' -rl --max-dim 1000x800

.It feh --action 'rm %F' -rl --max-dimension 1000x800

.

Recursively remove all images with dimensions below or equal to 1000x800 pixels

from the current directory.

.

.Sh DEPENDENCIES

.

When

.Cm --edit

is used,

.Nm

requires the

needs the

.Cm jpegtran

and

.Cm jpegexiforient

binaries

.Pq usually distributed in Qo libjpeg-progs Qc or similar

for lossless rotation.

for lossless JPEG rotation.

.

.Pp

.

To view images from URLs such as http://, you need

To view images from URLs such as http://,

.Nm

compiled with libcurl support (enabled by default).

See the

.Sx VERSION

section.

must be compiled with libcurl support.

It is $MAN_CURL$ in this build

.

.

.Sh BUGS

.Pp

.

See also:

http://feh.finalrewind.org

https://feh.finalrewind.org