feh - imlib2 based image viewer

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. For anything feh-related, you're welcome to join #feh on irc.oftc.net.

feh v2.14


feh-2.14.tar.bz2 (signature)

  • Add --xinerama-index option for background setting (patch by James Knight)
  • When removing the last image in slidsehow mode, stay on the last (previously second-to-last) image (patch by Lior Shiponi)
  • Allow --sort and --randomize to override each other (most recently specified option wins) instead of always preferring --sort
  • Thumbnail mode: Mark image as processed when executing an action (--action) by clicking on an image
  • It is now possible to override feh's idea of the active xinerama screen using the --xinerama-index option
  • Remove (undocumented) feature allowing to override feh's idea of the active xinerama screen by setting the XINERAMA_SCREEN environment variable

Archive - Bugs - Release feed



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 the source code of the latest release here: feh v2.14 (signature). Or check out the latest development version: feh git.

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

Building from source

Compiling feh from source (e.g. to try the development version or for distros which don't have the latest release yet) is quite trivial. feh does not use any fancy build system, all you need is GNU make, a C compiler (like gcc or clang) and the 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 http://feh.finalrewind.org/feh-2.14.tar.bz2
tar -xjf feh-2.14.tar.bz2
cd feh-2.14

or check out the git version:
git clone git://git.finalrewind.org/feh || git clone git://github.com/derf/feh.git
cd feh

Now, compile and install feh:
sudo make install


Please report bugs, feature requests or any other source code related stuff either on the GitHub issue tracker or directly to derf0 on #feh (irc.oftc.net). You can of course also e-mail derf+feh at finalrewind dot org.

Any contributions, be it patches, your feh configs or texts/examples for this website are also greatly appreciated. Please send them either via IRC or e-mail.

valid xhtml valid css famfamfam iki