Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
fast and light Imlib2-based image viewer
Failed to load latest commit information.
cam Deprecate feh-cam and gen-cam-menu (they will be removed by 2013)
examples add find-lowres example script
man Make --scale-down work with --geometry.
scripts checkopts: use non-dyndns domain
share feh.desktop: Add default and en_US GenericName ("Image viewer")
src Make --scale-down work with --geometry.
test update test screenshots (Xephyr/import are working properly again)
.gitignore add a desktop file (closes #98)
AUTHORS Obscure other mail addresses in AUTHORS as well.
COPYING update year in COPYING while at it
ChangeLog version bump
Makefile don't install feh-cam and gen-cam-menu by default
README strip unneded parts from giblib, part 1
TODO import partial giblib source into feh, do not link with giblib


feh - Imlib2 based image viewer

 * <>
 * <>
 * #feh on


 * Imlib2
 * libcurl (disable with make curl=0)
 * libpng
 * libX11
 * libXinerama (disable with make xinerama=0)

If built with exif=1:

 * libexif-dev
 * libexif12


 * jpegtran  (supplied by the jpeg library, for lossless image rotation)
 * convert  (supplied by ImageMagick, can be used to load unsuppoted formats)


$ make
$ sudo make install

ZSH Completion for feh is available at

Make flags

Use "make flag=bool", e.g. "make xinerama=0 debug=1" to disable Xinerama
support and get a debug build.

Available flags are:

 * cam      (default 0) - install deprecated feh-cam und gen-cam-menu scripts
 * curl     (default 1) - use libcurl to view http:// and similar images
 * debug    (default 0) - debug build, enables --debug
 * exif     (default 0) - Builtin EXIF tag display support
 * help     (default 0) - include help text (refers to the manpage otherwise)
 * stat64   (default 0) - Support CIFS shares from 64bit hosts on 32bit machines
 * xinerama (default 1) - Support Xinerama/XRandR multiscreen setups

So, by default libcurl and Xinerama are enabled, the rest is disabled.

Note: is designed so that in most cases, you can set environment
variables instead of editing it. E.g.:
CFLAGS='-g -Os' make
export DESTDIR=/tmp/feh PREFIX=/usr; make && make install

Builtin EXIF support is maintained by Dennis Real, see

Testing (non-X)

$ make test

Requires perl >= 5.10 with Test::Command. The tests are non-interactive and
work without X, so they can safely be run even on a headless buildserver.

Testing (X)

 * import (usually supplied by imagemagick)
 * perl >= 5.10 with GD, Test::More and X11::GUITest
 * twm
 * Xephyr

$ make test-x11

Be aware that this is quite experimental, so far the X-tests have only been
run on one machine. So they may or may not work for you.
Something went wrong with that request. Please try again.