headjack is a versatile NIfTI image viewer tailored for the terminal. It offers seamless compatibility with most platforms, including remote clusters and containerized environments, making it an ideal choice for researchers and developers.
To view NIfTI images in the terminal, simply run:
headjack image.nii.gzUse the following controls to navigate and interact with the viewer:
| Key | Action |
|---|---|
| ↑ ↓ or A D | Navigate along the X-axis / Scroll through metadata |
| ← → or W S | Navigate along the Y-axis / Scroll through metadata |
| Z X or Y X | Navigate along the Z-axis |
| Tab | Toggle metadata view |
| C | Toggle color map |
| Q or Esc or Ctrl + C | Quit |
We recommend downloading the latest precompiled binary for your platform from the releases page. Optionally, you can add the binary to your PATH environment variable for easier access. headjack is a self-contained executable with no runtime dependencies.
To simplify access, consider aliasing the binary to hj:
alias hj=/path/to/headjackIf you prefer to build headjack from source, ensure you have the latest Rust compiler installed and then run:
cargo build --releaseThe binary will be located at target/release/headjack.
If your terminal displays colors incorrectly, it may not support 24-bit colors. You can try running headjack with the -a/--ansi flag for 256 ANSI color mode.
If you encounter an error related to libc when starting headjack, such as:
/lib64/libm.so.6: versionGLIBC_2.29' not found
It likely indicates that you are using an older version of glibc. Consider using the *-musl variant available on the releases page, or build headjack from source with the musl target.