exkc
/
sxiv-exkc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
23 Commits 1 Branch 0 Tags 480 KiB
C 91.8%
Roff 5.6%
Makefile 1.7%
Shell 0.9%
Go to file
zcake 6b72f2d5ac reband 2021-04-18 05:16:57 +08:00
patches/sxiv-loop-patch clean 2020-11-19 11:05:51 +00:00
LICENSE first commit 2020-11-18 15:36:44 +00:00
Makefile change config 2021-01-01 21:27:39 +08:00
README.md reband 2021-04-18 05:16:57 +08:00
TODO first commit 2020-11-18 15:36:44 +00:00
autoreload_inotify.c first commit 2020-11-18 15:36:44 +00:00
autoreload_nop.c first commit 2020-11-18 15:36:44 +00:00
commands.c add loop patch 2020-11-19 10:31:26 +00:00
commands.lst first commit 2020-11-18 15:36:44 +00:00
config.def.h first commit 2020-11-18 15:36:44 +00:00
config.h null 2020-11-27 20:22:31 +08:00
image.c add loop patch 2020-11-19 10:31:26 +00:00
main.c change config 2021-01-01 21:27:39 +08:00
options.c reband 2021-04-18 05:16:57 +08:00
sxiv-bar change config 2021-01-01 21:30:27 +08:00
sxiv-key null 2020-11-28 10:23:11 +08:00
sxiv.1 reband 2021-04-18 05:16:57 +08:00
sxiv.desktop change desktop file 2020-12-29 10:01:54 +08:00
sxiv.h chamge color 2020-11-19 08:27:51 +00:00
thumbs.c add loop patch 2020-11-19 10:31:26 +00:00
utf8.h first commit 2020-11-18 15:36:44 +00:00
util.c first commit 2020-11-18 15:36:44 +00:00
window.c reband 2021-04-18 05:16:57 +08:00

README.md

Simple X Image Viewe(eXkc build)

The sole purpose of sxiv is to be the perfect image viewer for me. It is free software so that you can use it and modify it for your needs. Please file a bug report if something does not work as documented or expected. Contributions are welcome but there is no guarantee that they will be incorporated.

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

Dependencies

sxiv requires the following software to be installed:

  • Imlib2
  • X11
  • Xft
  • freetype2
  • fontconfig
  • giflib (optional, disabled with HAVE_GIFLIB=0)
  • libexif (optional, disabled with HAVE_LIBEXIF=0)

Please make sure to install the corresponding development packages in case that you want to build sxiv on a distribution with separate runtime and development packages (e.g. *-dev on Debian).

Building

sxiv is built using the commands:

# sudo make clean 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

Please see the man page for information on how to use sxiv.