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.9.3

2013-06-11

feh-2.9.3.tar.bz2 (signature)

Patch by David Gowers: Add %L format code (temporary copy of filelist)
Fix buffer overflows in printf implementation (affects --action, --customlist, --index-info, --info, --thumb-title, --title)
Fix tests failing when compiled with help=1

Archive - Bugs - Release feed - Roadmap

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 v2.9.3 (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 giblib-dev libxinerama-dev libjpeg-progs

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

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