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

feh v2.12


feh-2.12.tar.bz2 (signature)

  • feh-cam and gen-cam-menu are no longer installed by default. Use make install cam=1 to install them or make uninstall cam=1 && make install cam=0 to remove them permanently
  • feh no longer depends on giblib. Instead, the relevant parts of the giblib source were imported into the feh source. Rationale: giblib is unmaintained and, as far as I know, only used by three projects (one of which is feh). There is at least one known bug in it, and as I do not have the time to take over giblib development, importing the library seems to be the best solution.
  • Fix/improve --randomize for short filelists (closes #151)
  • Fix a buffer overflow in the printf implementation when handling unknown format specifiers (affects --action, --customlist, --index-info, --info, --thumb-title and --title)
  • Update help (if built with help=1)

Archive - Bugs - Release feed - Roadmap



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.12 (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.12.tar.bz2
tar -xjf feh-2.12.tar.bz2
cd feh-2.12

or check out the git version:
git clone git://derf.homelinux.org/feh
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