Installation of precompiled packages
MRtrix3 now provides pre-compiled versions for installation on Windows and macOS. Detailed instructions are provided below.
Download and install the 64-bit version of MSYS2, available from the MSYS2 homepage. This provides all the dependencies required for MRtrix3 to run, along with a Unix-like command-line environment.
Open the 'MSYS2 MinGW 64-bit' application, which should open a terminal window. You should find this in your start menu, within the 'MSYS2 64bit' application folder. Make sure to use the 64-bit MinGW version, not either of the other other options - otherwise MRtrix3 will simply not run.
Bring your MSYS2 installation up to date, as instructed on the MSYS2 homepage. This typically involves typing:
Note that you may need to type this in several times (closing the terminal as instructed each time), until the command reports that it is up to date.
download and install the MSYS2 MRtrix3 package using the
pacmanpackage manager provided by MSYS2. This will also install all required dependencies (warning: this is a big download). This can be achieved by copying the following commands into the 'MSYS2 MinGW 64-bit' terminal window:
wget https://github.com/MRtrix3/mrtrix3/releases/download/3.0_RC3_latest/mingw-w64-x86_64-mrtrix3-3.0_RC3_latest-1-x86_64.pkg.tar.xz pacman -U mingw-w64-x86_64-mrtrix3-3.0_RC3_latest-1-x86_64.pkg.tar.xz
Check your installation by typing
mrviewat the terminal.
Open the Terminal application
Download & extract the macOS package, and finalise the install with the following commands:
wget https://github.com/MRtrix3/mrtrix3/releases/download/3.0_RC3_latest/macOS-mrtrix3-3.0_RC3_latest.tar.gz tar xfz macOS-mrtrix3-3.0_RC3_latest.tar.gz cd mrtrix3 ./set_path
Close the terminal, open a new Terminal window, and verify your install by typing
mrviewin the new terminal window.