## Installing mrViewer

Installation of mrViewer can be done simply by decompressing the zip file (Windows) or the gzip tar file (Linux). This can be done with the utilities unzip or winzip (Windows) or tar in Linux.
$ unzip mrViewer-v${VERSION}-Windows-32.zip
$ tar -xf mrViewer-v${VERSION}-Linux-64.tgz
Since v2.6.7, mrViewer is distributed with installers for each platform. The Windows installer will run and create a menu item to the start menu and, optionally, create an icon in the desktop, as well as modify the PATH environment variable. Note that if you modify the PATH variable, you may not run the 32 bits version of mrViewer together with the 64 bits version. You may also run into problems with other programs that use some of the libraries of mrViewer. The Linux installers, must be run as root, like:
sudo dpkg -i mrViewer-v${VERSION}-${PLATFORM}.deb
They will register an entry in the DEB or RPM databases and install in:
/usr/local/mrViewer-v${VERSION}-${PLATFORM}.
The utilities dpkg (DEB) or rpm (RPM) will additionally create symlinks in /usr/bin/ and install the icon in /usr/share/applications which will show in the menus (Graphics). The icon will also be copied to the user's Desktop. On recent Linux distros, you may need to grant the Desktop icon the ability to launch the application (RMB menu).
The
mrViewer-v${VERSION}-${PLATFORM}/bin
directory among all things contains the file mrViewer.exe (Windows) or mrViewer.sh (Linux). Running this file or any of the icons will start the viewer.
On Macs, mrViewer is distributed as a .dmg file. You can decompress it if you click on it twice or run the standalone utility hdiutil from the terminal, like:
hdiutil attach mrViewer-${VERSION}-Darwin-64.dmg
You will be prompted to accept the mrViewer license and then the installation will create a volume for mrViewer. Opening that icon will reveal a mrViewer application and a symbolic link to the Applications directory. You can run mrViewer directly from the Finder window or install it by dragging the icon to the Applications folder (the recommended approach).
Note that the first time you run mrViewer, you should run it with
to grant permissions as the mrViewer executable is not notarized by Apple. If that does not work, another option is running the viewer twice in sucession which should prompt you with an Open requester.