chengranaa / quicknii

Quick and easy NIfTI/BV viewer

QuickNii - Quick and easy NIfTI file viewer

QuickNii is a simple NIfTI file viewer that allows you to quickly view NIfTI files in a simple and easy to use interface. It is designed to be a lightweight (only about 3MB!) and fast viewer that can be used to quickly view NIfTI files without the need for a full-featured medical imaging viewer.

Features

• Simple and easy to use interface
• Fast and lightweight
• Supports viewing NIfTI files in both 3D and 4D (Work in progress, 3D support at the moment, can view the first volume of 4D data)
• Supports viewing BrainVoyager files (vmr, fmr) (Work in progress, vmr support at the moment)
• Static Linked (No need to install any dependencies)

Usage

quicknii <NIfTI file/ VMR file> // that's it

Development

Clone the repository and run the following commands:

chmod +x init.sh && ./init.sh
make

The init.sh script will download the necessary dependencies. The make command will build the project and create the QuickNii executable in the build directory.

To install the executable, run the following command:

make install

It require sudo user privileges to install the executable.

License

MIT License

quicknii's Issues

This is a remidner for myself.

• better bounding method needed for the interger slider
• segmentation fault occur when the slider hits the limit, need to invetigate why
• proper orientation slicing for the file, needed to align with one of the software that similar to this (eg. MRIcron)
• support for linux and windows system (compilation flags for windows and linux, changes to DX12 or DX11 API calls for windows)
• mouse and keybord input interaction support
• support for loading a second nifti, vmr or a voi file as a mask. since we support both nifti and bv formate, we have a lot of flexibility here.
• automatic MP2RAGE denoising with three files with INV1, INV2, UNI as inputs.
• don't slice the data if the slice index did not changes.
• change to metal API on macOS.
• disable imgui.ini file saving
• git submodule for imgui implot nifti_clib