niicat 0.3.1

Preview nifti images on the terminal

niicat

This is a tool to quickly preview nifti images on the terminal. This can be helpful if you are working on a remote server via SSH and do not have a -X connection. It uses libsixel to display the images.

Install:

pip install niicat

Usage:

niicat T1.nii.gz

Possible problems

If nothing is displayed check if your terminal supports sixel.

You might also encounter the following error message:

ctypes.ArgumentError: argument 2: <class 'TypeError'>: wrong type

This is a known problem when using libsixel-python. In this case try using niicat with the option -ic if you are using iterm2 (this will use imgcat from iterm2) or with the option -lb (this will use libsixel-bin which can be installed via sudo apt install libsixel-bin).

This code is based on the following code:

niipre