nsxiv

Open images

$ nsxiv [path/to/file1 path/to/file2 ...]

$ nsxiv [path/to/directory1 path/to/directory2 ...]

$ nsxiv [[-r|--recursive]] [path/to/directory1 path/to/directory2 ...]

$ <q>

$ <Enter>

$ <n>

$ <p>

nsxiv [options] [image_files...]

[-b]
    Force bitmap mode, even if the image format implies otherwise.

[-c]
    Clear cache. Forces nsxiv to reload all images.

[-C ]
    Use as configuration file.

[-d]
    Dump information about the image(s) to standard output.

[-g ]
    Specify initial window geometry (e.g., 800x600).

[-G]
    Disable geometry hints; allow window to shrink below minimum size.

[-h]
    Display help message and exit.

[-i]
    Start in index mode, showing thumbnails.

[-I]
    Only show images in index mode.

[-l ]
    Loop the image list forever. An optional argument 'n' can be specified to specify how many times to loop, defaults to infinity if no argument is passed.

[-n]
    Start in normal mode; forces standard viewing.

[-N]
    No background image. Useful for transparent images.

[-o

nsxiv is a lightweight and minimalist image viewer for the X Window System. It's designed for speed and simplicity, focusing on basic image viewing functionalities like navigating through images, zooming, panning, and basic image manipulation. nsxiv is highly configurable through keybindings and external commands, allowing users to customize the viewer to their specific needs and integrate it seamlessly into their workflow. It is often used in tiling window manager environments due to its efficiency and command-line friendly nature. nsxiv primarily supports bitmap images and relies on external programs such as ffmpeg for displaying other image formats. It is designed to be scriptable and is often used in conjunction with shell scripts to perform more advanced image processing tasks.
The name is a recursive acronym meaning "nsxiv simple X image viewer".

nsxiv's functionality is limited without external tools. Image format support is dependent on external libraries like ffmpeg. Configuration relies heavily on editing the config file and defining keybindings. Transparency may have inconsistent behavior depending on the image format and window manager

The configuration file (usually ~/.config/nsxiv/config) allows for customization of keybindings, external commands, and other settings. It's a plain text file where each line defines a keybinding or setting using a simple syntax.
Example: key_next n

nsxiv can execute external commands based on keypresses. This allows for integration with other tools for image editing, manipulation, and file management. This feature enables creating workflows tailored to the user's specific needs.

The index mode (accessed with the `-i` flag) displays thumbnails of images in the current directory. This provides a quick overview of the available images and allows for easy navigation using keyboard shortcuts.

nsxiv development focuses on maintaining a small footprint and fast performance. It has gained popularity within the tiling window manager community due to its configurable nature and command-line control.
The name is a recursive acronym meaning "nsxiv simple X image viewer".

feh(1), display(1), imv(1)