LinuxCommandLibrary

feh

Display images

TLDR

View images locally or using a URL

$ feh [path/to/images]
copy

View images recursively
$ feh --recursive [path/to/images]
copy

View images without window borders
$ feh --borderless [path/to/images]
copy

Exit after the last image
$ feh --cycle-once [path/to/images]
copy

Use a specific slideshow cycle delay
$ feh --slideshow-delay [seconds] [path/to/images]
copy

Use a specific wallpaper mode (centered, filled, maximized, scaled or tiled)
$ feh --bg-[center|fill|max|scale|tile] [path/to/image]
copy

Create a montage of all images within a directory, outputting as a new image
$ feh --montage --thumb-height [150] --thumb-width [150] --index-info "[%nn%wx%h]" --output [path/to/montage_image.png]
copy

SYNOPSIS

feh [options] [file(s)|directory(s)|URL(s)]

PARAMETERS

-A, --action
    Run a command on file change.

-F, --full-screen
    Open feh in full-screen mode.

-Z, --auto-zoom
    Zoom images to fit screen.

-g, --geometry x
    Set window geometry (width x height).

-r, --recursive
    Recursively load images from subdirectories.

-q, --quiet
    Be quiet; don't output any messages.

-z, --randomize
    Randomize file list before viewing.

-d, --draw-filename
    Draw the filename on the image.

-w, --window-id
    Specify a window ID to use. Useful for setting wallpaper.

--bg-fill
    Set the background to a solid color. Use together with --window-id.

--bg-scale
    Scale the image to fit the screen. Use together with --window-id.

--bg-tile
    Tile the image to fill the screen. Use together with --window-id.

DESCRIPTION

feh is an image viewer aimed at command line users. Unlike more complex image viewers, feh does not have a graphical user interface beyond the images themselves. It is primarily controlled via command-line arguments and configuration files, making it ideal for use in scripts, window managers, and environments where minimalism is desired.

feh supports various viewing modes including fullscreen, slideshow, montage, and thumbnail browsing. It can also be used to set the desktop background (wallpaper) in various tiling modes. feh can load image lists from files, directories, or URLs, making it versatile for various image viewing and management tasks. Its speed and low resource consumption make it a popular choice for users with limited resources or those who prefer a keyboard-driven workflow.

CAVEATS

feh does not have editing capabilities. It's designed purely for viewing images.

CONFIGURATION

feh can be configured through command-line options and configuration files. The default configuration file is usually located at ~/.config/feh/fehrc or ~/.fehrc. These file contains default options that apply to every call to feh.

FILE LISTS

feh can take a file containing a list of images as an argument. This allows for viewing specific sets of images without needing to pass them all as command-line arguments. The images need to be separated using newlines.

HISTORY

feh was created as a fast and lightweight alternative to other image viewers. Its focus on command-line usage made it popular amongst users looking for simple, scriptable image viewing solutions. It has been continuously maintained and updated with new features and bug fixes by various developers throughout its history.

SEE ALSO

display(1), xv(1), xloadimage(1)

Copied to clipboard