From 6480a9dc31eee74205dc73dfdb519f8e661176ee Mon Sep 17 00:00:00 2001 From: Bert Date: Fri, 21 Jan 2011 15:27:06 +0100 Subject: Added README.md --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ TODO | 1 + 2 files changed, 44 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d95f951 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +sxiv: Simple (or small or suckless) X Image Viewer + +sxiv is a really simple alternative to feh and qiv. Its only dependency is +imlib2. The primary goal for writing sxiv is to create an image viewer, which +only implements the most basic features required for fast image viewing. Its +code base should be kept small and clean making it easy for you to dig into it +and customize it for your needs. + +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/sbin/sxiv". + +You can install it into a directory of your choice by changing the second +command to: + + # PREFIX="/your/dir" make install + +All build-time specific settings can be found in the file "config.h". Please +check and change them, so that they fit your needs. + +Usage +----- +sxiv has no useful command line options yet, but they will be added in the next +releases. Right now, it simply displays all files given given on the +command line. + +Use the following keys to control sxiv: + + q Quit sxiv + Escape Quit sxiv and return an exit value of 2 (useful for scripting) + Space,n Go to the next image + Backspace,p + Go to the previous image + +,= Zoom in + - Zoom out + h,j,k,l Scroll left/up/down/right diff --git a/TODO b/TODO index f98cab8..c61debf 100644 --- a/TODO +++ b/TODO @@ -4,3 +4,4 @@ - write man page - toggle aliasing - fullscreen mode +- view all images in directories (recursive mode) -- cgit v1.2.3-54-g00ecf