Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
  • release-3.7
  • release-3.6
  • 3.10.3
  • 3.10.2
  • 3.10.1
  • 3.10
  • 3.9.1
  • 3.9
  • 3.8
  • 3.7.2
  • 3.7.1
  • 3.7
  • 3.6.3
  • 3.6.2
  • 3.6.1
  • 3.6
  • 3.5
  • 3.4.1
  • 3.4
  • 3.3
  • 3.2.1
  • 3.2
23 results
Compare
user avatar
Merge branch 'Ferada-xdg-thumbnails'
Birte Kristina Friesel authored
b79cb3cf
History
user avatar b79cb3cf
History
Name Last commit Last update
cam
examples
man
scripts
share
src
test
.gitignore
AUTHORS
COPYING
ChangeLog
Makefile
README.md
TODO
config.mk
README.md

feh

Imlib2 based image viewer

Dependencies

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

If built with exif=1:

  • libexif-dev
  • libexif12

Recommended

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

Installation

For end users:

$ make
$ sudo make install app=1

For package maintainers and users who do not want feh to install its icons into /usr/share:

$ make
$ sudo make install

Explanation: feh ships some icons and an X11 desktop entry, which allow it to be used from file managers, desktop menus and similar. However, installing icons to /usr/local/share/... does not seem to work reliable in all cases. Because of this, when using "make install app=1", feh will install its icons to /usr/share/..., even though they technically belong into /usr/local.

ZSH Completion for feh is available here

Make flags

Flags can be used to control the build and installation process.

e.g.

make flag=bool
make install flag=bool

or

export flag=bool
make && make install

For example, make xinerama=0 debug=1 will disable Xinerama support and produce a debug build.

Available flags are:

Flag Default value Description
app 0 install icons to /usr/share, regardless of DESTDIR and `PREFIX, and call gtk-update-icon-cache afterwards
cam 0 install deprecated feh-cam und gen-cam-menu scripts
curl 1 use libcurl to view http:// and similar images
debug 0 debug build, enables --debug
exif 0 Builtin EXIF tag display support
help 0 include help text (refers to the manpage otherwise)
stat64 0 Support CIFS shares from 64bit hosts on 32bit machines
xinerama 1 Support Xinerama/XRandR multiscreen setups

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

Additionally, the standard variables PREFIX and DESTDIR are supported.

PREFIX (default: /usr) controls where the application and its data files will be installed. It must be set both during make and make install.

DESTDIR (default: empty) sets the installation root during "make install". It is mostly useful for package maintainers.

Note: config.mk 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, here.

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)

Requires

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