feh is an X11 image viewer aimed mostly at console users. Unlike most other viewers, it does not have a fancy GUI, but simply displays images. It is controlled via commandline arguments and configurable key/mouse actions.

It is released under a variant of the MIT license.

feh v3.10

2023-04-06

feh-3.10.tar.bz2 (signature)

Add --sort=none option to un-set sort modes specified earlier
Improve error messages for Imlib2 ≥ 1.8
Fix build with clang 16. (Patch by orbea)
Fix tests when building with magic=1

Archive - Bugs - Release feed

Features

Various operation modes:
- Slideshow: Show all files in or below a directory, change slides with your keyboard or automatically after a delay
- Thumbnail: List files as clickable thumbnails
- List: ls-like output with image dimensions etc.
- Multiwindow: Open all images at once
optional HTTP/FTP support via libcurl
Can be used as wallpapersetter, supports rxvt transparency
Filelist support
Lots of configurable keyboard shortcuts. Well usable without mouse
Custom actions (shell commands), e.g. for sorting images

Documentation

The feh manual explains the various operation modes and options in detail.
You might also be interested in the Changelog.
There is a growing list of examples and screenshots.

Download

Download the source code of the latest release here: feh v3.10 (signature). Or check out the latest development version: feh git.

feh is also shipped by many Linux/BSD distributions, including Arch Linux, Debian, FreeBSD, OpenBSD and Ubuntu.

Building from source

You can easily compile feh from source, e.g. to try out the latest changes in the git repository. All you need is GNU make, a C compiler (gcc/clang) and some libraries.

Example for Debian:

First, install the dependencies:
apt-get install libcurl4-openssl-dev libx11-dev libxt-dev libimlib2-dev libxinerama-dev libjpeg-progs

Then, either get the latest tarball:
wget https://feh.finalrewind.org/feh-3.10.tar.bz2
tar -xjf feh-3.10.tar.bz2
cd feh-3.10

or check out the git version:
git clone https://git.finalrewind.org/feh
cd feh

Now, compile and install feh:
make
sudo make install

Contribute

Please report bugs, feature requests or any other source code related stuff on the GitHub issue tracker. You can also send a mail to derf+feh at finalrewind dot org, though GitHub issues are preferred.