feh

lightweight X11 image viewer

TLDR

View images

$ feh [image.jpg]

View directory as slideshow

$ feh -D [5] [directory]

Set wallpaper

$ feh --bg-scale [image.jpg]

Thumbnail mode

$ feh -t [directory]

Fullscreen mode

$ feh -F [image.jpg]

SYNOPSIS

feh [options] [files|directories|URLs]

feh is a lightweight, fast image viewer for X11. It supports slideshows, thumbnail browsing, montages, and setting desktop wallpapers through command-line control.The viewer handles multiple image formats and provides keyboard and mouse controls for navigation and zooming. It can read images from files, directories, stdin, or URLs.feh is particularly popular for setting wallpapers in window managers that lack built-in wallpaper support.

PARAMETERS

FILES

Images to display.

-F, --fullscreen

Start in fullscreen mode.

-D SEC, --slideshow-delay SEC

Slideshow delay in seconds.

-t, --thumbnails

Thumbnail browser mode.

--bg-scale IMAGE

Fit image to screen (may distort).

--bg-fill IMAGE

Fill screen preserving aspect ratio (may crop).

--bg-max IMAGE

Scale to fit without cropping (may leave borders).

--bg-center IMAGE

Center image without scaling.

--bg-tile IMAGE

Tile image across screen.

-g WxH, --geometry WxH

Limit window size.

-Z, --auto-zoom

Zoom to fit window.

-r, --recursive

Recurse into directories.

--help

Display help information.

CAVEATS

X11 only (no Wayland native). Large images may load slowly. Wallpaper setting requires running at startup.

HISTORY

feh was created by Tom Gilbert in 1999 as a fast, simple X11 image viewer. It remains widely used in lightweight Linux setups, especially for its wallpaper-setting capabilities.

feh