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

2014-02-28

feh-2.10.tar.bz2 (signature)

  • Allow non-centered wallpapers using the --geometry option (Patch by Joel Bradshaw)
  • Add ; flag to --info (as in "--info ';echo foo'") to disable info display on startup
  • Partially fix off-by-one pixel error when warping the pointer in the bottom/right window border
  • thumbnail mode: If --action is set, run specified command instead of opening image on click.
  • feh.desktop: Use feh %F since we support multiple files
  • Fix --borderless not working on some 64bit systems (Patch by Brian Mattern)
  • Always use absolute paths in .fehbg

Archive - Bugs - Release feed - Roadmap

Features

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.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, 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.10.tar.bz2
tar -xjf feh-2.10.tar.bz2
cd feh-2.10

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.

valid xhtml valid css famfamfam iki