xivr

X Image Viewer Rifle

A Dart command line application that acts as a wrapper for any image viewer that has the same CLI as *sxiv(either nsxiv or sxiv). By default, it attempts to launch nsxiv which can be changed by setting the IMAGE_VIEWER environment variable to the desired program.

Features

• Forks the image viewer so as to not block the current shell session.
• Opens in thumbnail mode if any argument is a directory.
• If the argument is a single compatible file, opens all compatible files in its parent directory which can be browsed around.

Runtime dependencies

• util-linux.
• nsxiv or the binary set in the IMAGE_VIEWER environment variable.

Building and installation

• Set up the Dart SDK, instructions are available here.

• Compile the application:

  $ cd xivr
  $ dart compile exe bin/xivr.dart -o <INSTALL_LOCATION_PREFERABLY_IN_PATH>/xivr

• Run the application:

  $ xivr

Caveats

Users would still need to provide an empty argument to options supporting optional arguments due to no current support from the package that this program uses.

Instead of

$ xivr --alpha-layer --anti-alias
$ xivr --alpha-layer=no --anti-alias=no

use

$ xivr --alpha-layer= --anti-alias=
$ xivr --alpha-layer=no --anti-alias=no