2021-09-16 10:32:59 +01:00
|
|
|
![nsxiv](https://raw.githubusercontent.com/nsxiv/nsxiv/gh-pages/img/logo.png "nsxiv")
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
**Neo (or New or Not) Simple (or Small or Suckless) X Image Viewer**
|
|
|
|
--------------------------------------------------------------------
|
2011-01-21 14:27:06 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
nsxiv is a fork of now unmaintained [sxiv](https://github.com/muennich/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
|
2021-10-02 06:29:38 +01:00
|
|
|
release of nsxiv. Contributions are welcome, see
|
|
|
|
[CONTRIBUTING.md](CONTRIBUTING.md#Contribution-Guideline) for details.
|
2011-01-21 14:27:06 +00:00
|
|
|
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2011-09-08 15:48:55 +01:00
|
|
|
Features
|
2011-09-12 18:28:02 +01:00
|
|
|
--------
|
2011-09-08 15:48:55 +01:00
|
|
|
|
|
|
|
* 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
|
2021-09-16 10:32:59 +01:00
|
|
|
* Play GIF animations
|
2013-01-27 17:03:01 +00:00
|
|
|
* Display image information in status bar
|
2021-09-16 10:32:59 +01:00
|
|
|
* Display image name/path in X title
|
2011-09-08 15:48:55 +01:00
|
|
|
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2011-09-08 16:31:37 +01:00
|
|
|
Screenshots
|
2011-09-12 18:28:02 +01:00
|
|
|
-----------
|
2011-09-08 16:31:37 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
**Image mode: (Default colors)**
|
2011-09-08 16:31:37 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
![Image](https://raw.githubusercontent.com/nsxiv/nsxiv/gh-pages/img/image.png "Image mode")
|
2011-09-08 16:31:37 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
**Thumbnail mode: (Custom colors)**
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
![Thumb](https://raw.githubusercontent.com/nsxiv/nsxiv/gh-pages/img/thumb.png "Thumb mode")
|
2011-09-08 16:31:37 +01:00
|
|
|
|
|
|
|
|
2021-10-19 14:00:23 +01:00
|
|
|
Installing via package manager
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
nsxiv is available on the following distributions/repositories. If you don't see
|
|
|
|
your distro listed here, either contact your distro's package maintainer or
|
|
|
|
consider packaging it yourself and adding it to the respective community repo.
|
|
|
|
|
|
|
|
[![Packaging status](https://repology.org/badge/vertical-allrepos/nsxiv.svg)](https://repology.org/project/nsxiv/versions)
|
|
|
|
|
|
|
|
Repos not tracked by repology:
|
|
|
|
|
|
|
|
* Fedora: Enable the copr repo via `dnf copr enable mamg22/nsxiv`.
|
|
|
|
|
|
|
|
|
2020-01-16 11:16:33 +00:00
|
|
|
Dependencies
|
2011-09-12 18:28:02 +01:00
|
|
|
------------
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
nsxiv requires the following software to be installed:
|
2020-01-16 11:16:33 +00:00
|
|
|
|
|
|
|
* Imlib2
|
|
|
|
* X11
|
2021-09-21 07:24:28 +01:00
|
|
|
|
2021-10-03 17:52:12 +01:00
|
|
|
The following dependencies are optional.
|
2021-09-21 07:24:28 +01:00
|
|
|
|
2021-10-03 17:52:12 +01:00
|
|
|
* inotify : Used for auto-reloading images on change.
|
|
|
|
Disabled via `HAVE_INOTIFY=0`
|
2021-09-19 09:49:56 +01:00
|
|
|
* libXft, freetype2, fontconfig : Used for the status bar.
|
|
|
|
Disabled via `HAVE_LIBFONTS=0`
|
2021-09-21 07:24:28 +01:00
|
|
|
* giflib : Used for animated gif playback.
|
2021-10-03 17:52:12 +01:00
|
|
|
Disabled via `HAVE_LIBGIF=0`.
|
2021-09-21 07:24:28 +01:00
|
|
|
* libexif : Used for auto-orientation and exif thumbnails.
|
2021-10-03 17:52:12 +01:00
|
|
|
Disable via `HAVE_LIBEXIF=0`
|
2021-09-24 12:20:55 +01:00
|
|
|
* libwebp : Used for animated webp playback.
|
2021-10-03 17:52:12 +01:00
|
|
|
Disabled via `HAVE_LIBWEBP=0`.
|
2020-01-16 11:16:33 +00:00
|
|
|
|
|
|
|
Please make sure to install the corresponding development packages in case that
|
2021-09-16 10:32:59 +01:00
|
|
|
you want to build nsxiv on a distribution with separate runtime and development
|
|
|
|
packages (e.g. \*-dev on Debian).
|
2020-01-16 11:16:33 +00:00
|
|
|
|
|
|
|
|
|
|
|
Building
|
|
|
|
--------
|
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
nsxiv is built using the commands:
|
2011-01-21 14:27:06 +00:00
|
|
|
|
|
|
|
$ make
|
|
|
|
|
2021-10-03 17:52:12 +01:00
|
|
|
You can pass `HAVE_X=0` to `make` to disable an optional dependency.
|
2021-09-14 15:42:57 +01:00
|
|
|
For example:
|
|
|
|
|
2021-10-03 17:52:12 +01:00
|
|
|
$ make HAVE_LIBEXIF=0
|
2021-09-14 15:42:57 +01:00
|
|
|
|
2021-10-03 17:52:12 +01:00
|
|
|
will disable `libexif` support. Alternatively they can be disabled via editing
|
|
|
|
the `Makefile` directly. `OPT_DEP_DEFAULT=0` can be used to disable all
|
|
|
|
optional dependencies.
|
2021-09-14 15:42:57 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
Installing nsxiv:
|
|
|
|
|
|
|
|
# make install
|
|
|
|
|
2021-09-23 03:17:52 +01:00
|
|
|
Installing desktop entry:
|
|
|
|
|
2021-09-25 06:00:21 +01:00
|
|
|
# make install-desktop
|
2021-09-23 03:17:52 +01:00
|
|
|
|
|
|
|
Installing icons:
|
|
|
|
|
2021-09-25 06:00:21 +01:00
|
|
|
# make install-icon
|
|
|
|
|
|
|
|
Installing all of the above:
|
|
|
|
|
|
|
|
# make install-all
|
2021-09-23 03:17:52 +01:00
|
|
|
|
|
|
|
Please note, that these requires root privileges.
|
2021-09-24 06:07:27 +01:00
|
|
|
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`.
|
2021-09-16 10:32:59 +01:00
|
|
|
|
|
|
|
You can install nsxiv into a directory of your choice by changing this command to:
|
2011-01-21 14:27:06 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
$ make PREFIX="/your/dir" install
|
2011-01-21 14:27:06 +00:00
|
|
|
|
2021-10-03 17:52:12 +01:00
|
|
|
Example scripts are installed using `EGPREFIX` which defaults to
|
|
|
|
`/usr/local/share/doc/nsxiv/examples`. You can change `EGPREFIX` the same way
|
|
|
|
you can change `PREFIX` shown above.
|
2021-09-22 19:36:55 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
The build-time specific settings of nsxiv can be found in the file *config.h*.
|
2011-09-12 18:28:02 +01:00
|
|
|
Please check and change them, so that they fit your needs.
|
2011-09-13 09:08:55 +01:00
|
|
|
If the file *config.h* does not already exist, then you have to create it with
|
|
|
|
the following command:
|
|
|
|
|
|
|
|
$ make config.h
|
2011-09-08 15:02:46 +01:00
|
|
|
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2011-01-21 14:27:06 +00:00
|
|
|
Usage
|
2011-09-12 18:28:02 +01:00
|
|
|
-----
|
2013-04-02 18:43:55 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
Please see man page for information on how to use nsxiv. To do so, execute the
|
|
|
|
following after the installation:
|
2014-10-24 11:25:18 +01:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
$ man nsxiv
|
2014-04-24 19:40:26 +01:00
|
|
|
|
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
F.A.Q
|
|
|
|
-----
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
* Can I open remote urls with nsxiv? <br>
|
2021-10-02 06:29:38 +01:00
|
|
|
Yes, see [nsxiv-url](https://github.com/nsxiv/nsxiv-extra/tree/master/scripts/nsxiv-url)
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
* Can I open all the images in a directory? <br>
|
2021-10-02 06:29:38 +01:00
|
|
|
Yes, see [nsxiv-rifle](https://github.com/nsxiv/nsxiv-extra/tree/master/scripts/nsxiv-rifle)
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
* Can I set default arguments for nsxiv? <br>
|
2021-10-02 06:29:38 +01:00
|
|
|
Yes, see [nsxiv-env](https://github.com/nsxiv/nsxiv-extra/tree/master/scripts/nsxiv-env)
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
* Can I pipe images into nsxiv? <br>
|
2021-09-16 22:16:00 +01:00
|
|
|
No, not yet. See [#32](https://github.com/nsxiv/nsxiv/issues/32)
|
2012-12-21 22:36:59 +00:00
|
|
|
|
|
|
|
|
2021-10-02 06:29:38 +01:00
|
|
|
User patches
|
|
|
|
------------
|
|
|
|
|
|
|
|
Due to our limited [project scope](CONTRIBUTING.md#Project-Scope), certain features or
|
|
|
|
customization cannot be merged into nsxiv mainline. Following the spirit of
|
|
|
|
suckless software, we host the [nsxiv-extra](https://github.com/nsxiv/nsxiv-extra)
|
|
|
|
repo where users are free to submit whatever patches or scripts they wish.
|
|
|
|
|
|
|
|
Description on how to use or submit patches can be found on
|
|
|
|
[nsxiv-extra's](https://github.com/nsxiv/nsxiv-extra) README.
|
|
|
|
|
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
Download
|
|
|
|
--------
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
You can [browse](https://github.com/nsxiv/nsxiv) the source code repository
|
|
|
|
on GitHub or get a copy using git with the following command:
|
2012-12-21 22:36:59 +00:00
|
|
|
|
2021-09-16 10:32:59 +01:00
|
|
|
$ git clone https://github.com/nsxiv/nsxiv.git
|
2021-09-16 21:15:28 +01:00
|
|
|
|
|
|
|
You can view the changelog [here](CHANGELOG.md)
|