Metadata-Version: 2.1
Name: niicat
Version: 0.5.0
Summary: Preview nifti images on the terminal
Home-page: https://github.com/MIC-DKFZ/niicat/
Author: Jakob Wasserthal
Author-email: j.wasserthal@dkfz.de
License: GPL v2
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nibabel>=2.3.0
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: importlib-metadata; python_version < "3.8"
Provides-Extra: libsixel
Requires-Dist: libsixel-python; extra == "libsixel"

# 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](https://github.com/saitoha/libsixel) to display the images.
Niicat can also display png, jpg or similar images.


### Install:

```
pip install niicat
```


### Usage:

```
niicat T1.nii.gz
```

![](niicat/resources/example.gif)


### Possible problems

If nothing is displayed check if your [terminal supports sixel](https://github.com/saitoha/libsixel#terminal-requirements).

Per default niicat is trying to use libsixel-python. If this is causing problems you can also 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`).

Niicat was only tested on python >= 3.5.


### Copyright

Copyright © German Cancer Research Center (DKFZ), Division of Medical Image Computing (MIC).
Please make sure that your usage of this code is in compliance with the [code license](LICENSE).
