README.md

Simple X Image Viewer

sxiv is an alternative to feh and qiv. Its only dependencies besides xlib are
imlib2, libexif and giflib. The primary goal for writing sxiv is to create an
image viewer, which only has the most basic features required for fast image
viewing (the ones I want). It has vi key bindings and works nicely with tiling
window managers. Its code base should be kept small and clean to make it easy
for you to dig into it and customize it for your needs.

Features

Basic image operations, e.g. zooming, panning, rotating

Customizable key and mouse button mappings (in config.h)

Thumbnail mode: grid of selectable previews of all images

Ability to cache thumbnails for fast re-loading

Basic support for multi-frame images

Load all frames from GIF files and play GIF animations

Display image information in status bar

Screenshots

Image mode:

Thumbnail mode:

Installation

sxiv is built using the commands:

$ make
# make install

Please note, that the latter one requires root privileges.
By default, sxiv is installed using the prefix "/usr/local", so the full path
of the executable will be "/usr/local/bin/sxiv".

You can install sxiv into a directory of your choice by changing the second
command to:

# make PREFIX="/your/dir" install

The build-time specific settings of sxiv can be found in the file config.h.
Please check and change them, so that they fit your needs.
If the file config.h does not already exist, then you have to create it with
the following command:

$ make config.h

Usage

sxiv has two modes of operation: image and thumbnail mode. The default is
image mode, in which only the current image is shown. In thumbnail mode a grid
of small previews is displayed, making it easy to choose an image to open.