Personal fork of nsxiv
Go to file
N-R-K 0ee05d29f0
Clarify comment in example key-handler (#89)
currently, the key-handler will not receive the `S-` modifier if there's
a capital equivalent of that KEY.
if https://github.com/nsxiv/nsxiv/pull/78 is to be merged, then this
behaviour may change.

however as it currently stands, we should fix the comment. we can update
it later if needed.

Co-authored-by: Berke Kocaoğlu <berke.kocaoglu@metu.edu.tr>
2021-09-28 10:19:41 +00:00
examples Clarify comment in example key-handler (#89) 2021-09-28 10:19:41 +00:00
icon Add desktop and icon rules to Makefile, document icon installation (#80) 2021-09-23 02:17:52 +00:00
.editorconfig add an editorconfig file, closes #25 2021-09-16 22:55:31 +03:00
.gitignore Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
CHANGELOG.md Stable version 27.1 2021-09-17 05:25:19 +06:00
CONTRIBUTING.md Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
LICENSE Added LICENSE 2011-01-18 15:29:18 +01:00
Makefile Rename icon & desktop and add install-all in Makefile (#96) 2021-09-25 05:00:21 +00:00
README.md Rename icon & desktop and add install-all in Makefile (#96) 2021-09-25 05:00:21 +00:00
TODO.md Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
autoreload_inotify.c Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
autoreload_nop.c Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
commands.c Use zoom steps instead of hard-coding levels (#92) 2021-09-25 11:11:21 +06:00
commands.lst Add mark range function 2018-06-09 11:44:47 +02:00
config.def.h Use zoom steps instead of hard-coding levels (#92) 2021-09-25 11:11:21 +06:00
image.c Use zoom steps instead of hard-coding levels (#92) 2021-09-25 11:11:21 +06:00
main.c make keyhandler abort key configurable via config.h 2021-09-24 17:29:30 +06:00
nsxiv.1 Change location of example scripts (#86) 2021-09-22 18:36:55 +00:00
nsxiv.desktop Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
nsxiv.h Use zoom steps instead of hard-coding levels (#92) 2021-09-25 11:11:21 +06:00
options.c switch -0 to bottom in options.c 2021-09-21 23:37:59 +03:00
thumbs.c add .mark.foreground to Xresources 2021-09-17 02:32:11 +06:00
utf8.h Replace utf8codepoint with Chris Wellons' utf8_decode 2017-12-07 21:19:53 +01:00
util.c Rename, Update Docs and Prepare for Release (#9) 2021-09-16 22:55:31 +03:00
window.c code-style: use constant length array (#79) 2021-09-22 01:53:11 +06:00

README.md

nsxiv

Neo (or New or Not) Simple (or Small or Suckless) X Image Viewer

nsxiv is a fork of now unmaintained sxiv with the purpose of maintaining it and adding simple, sensible features. nsxiv is free software licensed under GPLv2 and aims to be easy to modify and customize.

Please file a bug report if something does not work as documented or expected in this repository, after making sure you are using the latest release of nsxiv. Contributions are welcome, see CONTRIBUTING.md for details.

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
  • Play GIF animations
  • Display image information in status bar
  • Display image name/path in X title

Screenshots

Image mode: (Default colors)

Image

Thumbnail mode: (Custom colors)

Thumb

Dependencies

nsxiv requires the following software to be installed:

  • Imlib2
  • X11
  • Xft
  • freetype2
  • fontconfig

The following libraries are optional. They are automatically enabled if installed.

  • giflib : Used for animated gif playback.
  • libexif : Used for auto-orientation and exif thumbnails.
  • libwebp : Used for animated webp playback.

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

Building

nsxiv is built using the commands:

$ make

Running make will automatically detect if libexif and libgif are available and enable them if so. CLI arguments will override any automatic detection. For example:

$ make HAVE_LIBGIF=0

will always disable libgif. Alternatively, they can be disabled via editing config.mk.

Installing nsxiv:

# make install

Installing desktop entry:

# make install-desktop

Installing icons:

# make install-icon

Installing all of the above:

# make install-all

Please note, that these requires root privileges. By default, nsxiv is installed using the prefix /usr/local, so the full path of the executable will be /usr/local/bin/nsxiv, the .desktop entry will be /usr/local/share/applications/nsxiv.desktop and the icon path will be /usr/local/share/icons/hicolor/{size}/apps/nsxiv.png.

You can install nsxiv into a directory of your choice by changing this command to:

$ make PREFIX="/your/dir" install

Example scripts are installed using DOCPREFIX which defaults to /usr/local/share/doc/nsxiv. You can change DOCPREFIX the same way you can change PREFIX shown above.

The build-time specific settings of nsxiv 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 man page for information on how to use nsxiv. To do so, execute the following after the installation:

$ man nsxiv

F.A.Q

  • Can I open remote urls with nsxiv?
    Yes, see nsxiv-url

  • Can I open all the images in a directory?
    Yes, see nsxiv-rifle

  • Can I set default arguments for nsxiv?
    Yes, see nsxiv-env

  • Can I pipe images into nsxiv?
    No, not yet. See #32

Download

You can browse the source code repository on GitHub or get a copy using git with the following command:

$ git clone https://github.com/nsxiv/nsxiv.git

You can view the changelog here