| 1 |  |
| 2 | |
| 3 | **Neo (or New or Not) Simple (or Small or Suckless) X Image Viewer** |
| 4 | -------------------------------------------------------------------- |
| 5 | |
| 6 | nsxiv is a fork of now unmaintained [sxiv](https://github.com/muennich/sxiv) |
| 7 | with the purpose of maintaining it and adding simple, sensible features. |
| 8 | nsxiv is free software licensed under GPLv2 and aims to be easy to modify and customize. |
| 9 | |
| 10 | Please file a bug report if something does not work as documented or |
| 11 | expected in *this* repository, after making sure you are using the latest |
| 12 | release of nsxiv. Contributions are welcome, see [CONTRIBUTING.md](CONTRIBUTING.md) |
| 13 | for details. |
| 14 | |
| 15 | |
| 16 | Features |
| 17 | -------- |
| 18 | |
| 19 | * Basic image operations, e.g. zooming, panning, rotating |
| 20 | * Customizable key and mouse button mappings (in *config.h*) |
| 21 | * Thumbnail mode: grid of selectable previews of all images |
| 22 | * Ability to cache thumbnails for fast re-loading |
| 23 | * Basic support for multi-frame images |
| 24 | * Play GIF animations |
| 25 | * Display image information in status bar |
| 26 | * Display image name/path in X title |
| 27 | |
| 28 | |
| 29 | Screenshots |
| 30 | ----------- |
| 31 | |
| 32 | **Image mode: (Default colors)** |
| 33 | |
| 34 |  |
| 35 | |
| 36 | **Thumbnail mode: (Custom colors)** |
| 37 | |
| 38 |  |
| 39 | |
| 40 | |
| 41 | Dependencies |
| 42 | ------------ |
| 43 | |
| 44 | nsxiv requires the following software to be installed: |
| 45 | |
| 46 | * Imlib2 |
| 47 | * X11 |
| 48 | * Xft |
| 49 | * freetype2 |
| 50 | * fontconfig |
| 51 | |
| 52 | The following libraries are optional. They are automatically enabled if installed. |
| 53 | |
| 54 | * giflib : Used for animated gif playback. |
| 55 | * libexif : Used for auto-orientation and exif thumbnails. |
| 56 | |
| 57 | Please make sure to install the corresponding development packages in case that |
| 58 | you want to build nsxiv on a distribution with separate runtime and development |
| 59 | packages (e.g. \*-dev on Debian). |
| 60 | |
| 61 | |
| 62 | Building |
| 63 | -------- |
| 64 | |
| 65 | nsxiv is built using the commands: |
| 66 | |
| 67 | $ make |
| 68 | |
| 69 | Running make will automatically detect if libexif and libgif are available and |
| 70 | enable them if so. CLI arguments will override any automatic detection. |
| 71 | For example: |
| 72 | |
| 73 | $ make HAVE_LIBGIF=0 |
| 74 | |
| 75 | will always disable libgif. |
| 76 | Alternatively, they can be disabled via editing `config.mk`. |
| 77 | |
| 78 | Installing nsxiv: |
| 79 | |
| 80 | # make install |
| 81 | |
| 82 | Installing desktop entry: |
| 83 | |
| 84 | # make desktop |
| 85 | |
| 86 | Installing icons: |
| 87 | |
| 88 | # make icon |
| 89 | |
| 90 | Please note, that these requires root privileges. |
| 91 | By default, nsxiv is installed using the prefix "/usr/local", so the full path |
| 92 | of the executable will be "/usr/local/bin/nsxiv", the `.desktop` entry will be |
| 93 | "/usr/local/share/applications/nsxiv.desktop" and the icon path will be |
| 94 | "/usr/local/share/icons/hicolor/{size}/apps/nsxiv.png". |
| 95 | |
| 96 | You can install nsxiv into a directory of your choice by changing this command to: |
| 97 | |
| 98 | $ make PREFIX="/your/dir" install |
| 99 | |
| 100 | Example scripts are installed using `DOCPREFIX` which defaults to |
| 101 | `/usr/local/share/doc/nsxiv`. You can change `DOCPREFIX` the same way you can |
| 102 | change `PREFIX` shown above. |
| 103 | |
| 104 | The build-time specific settings of nsxiv can be found in the file *config.h*. |
| 105 | Please check and change them, so that they fit your needs. |
| 106 | If the file *config.h* does not already exist, then you have to create it with |
| 107 | the following command: |
| 108 | |
| 109 | $ make config.h |
| 110 | |
| 111 | |
| 112 | Usage |
| 113 | ----- |
| 114 | |
| 115 | Please see man page for information on how to use nsxiv. To do so, execute the |
| 116 | following after the installation: |
| 117 | |
| 118 | $ man nsxiv |
| 119 | |
| 120 | |
| 121 | F.A.Q |
| 122 | ----- |
| 123 | |
| 124 | * Can I open remote urls with nsxiv? <br> |
| 125 | Yes, see [nsxiv-url](https://github.com/nsxiv/nsxiv/wiki/nsxiv-url) |
| 126 | |
| 127 | * Can I open all the images in a directory? <br> |
| 128 | Yes, see [nsxiv-rifle](https://github.com/nsxiv/nsxiv/wiki/nsxiv-rifle) |
| 129 | |
| 130 | * Can I set default arguments for nsxiv? <br> |
| 131 | Yes, see [nsxiv-env](https://github.com/nsxiv/nsxiv/wiki/nsxiv-env) |
| 132 | |
| 133 | * Can I pipe images into nsxiv? <br> |
| 134 | No, not yet. See [#32](https://github.com/nsxiv/nsxiv/issues/32) |
| 135 | |
| 136 | |
| 137 | Download |
| 138 | -------- |
| 139 | |
| 140 | You can [browse](https://github.com/nsxiv/nsxiv) the source code repository |
| 141 | on GitHub or get a copy using git with the following command: |
| 142 | |
| 143 | $ git clone https://github.com/nsxiv/nsxiv.git |
| 144 | |
| 145 | You can view the changelog [here](CHANGELOG.md) |