Linux installation

The easiest is to use an installer, if available for your distribution. However, if you do not have root privileges, you can use a binary package. If you want to build directly from source, you will end up with a binary package adapted for your system. Do not forget to set the Imagine_DIR environment variable.


If you are using Debian or derivative distribution (Ubuntu...), you can use the appropriate package, which will automatically fetch the dependencies.

To install, enter the following command in a terminal:

xdg-open Imagine++-4.3.1-Linux-x86_64.deb

If the interface complains about "bad package quality" or proposes to "repair", agree and continue installation.

The last point is to set your Imagine_DIR environment variable. To do it permanently: assuming that you installed into /usr/share/Imagine++, as the Debian package does:

Go to Usage and check the tests.

Alternative: Binary package

If you use another distribution, or if you do not have root privileges, you can download and extract the binary archive, after having installed the dependencies with your package manager: libqt5opengl5-dev, cmake-qt-gui, g++, gdb.

Alternative: Building from source

If for any reason one of the methods above is not appropriate for you, follow carefully these steps to create a binary package adapted to your system.

1. Sources

Get the sources here and decompress them.

2. Tools

Get and install the following with your package manager.

The commands below work with Debian and derivatives (Ubuntu and variants):

sudo apt-get install libqt5opengl5-dev
sudo apt-get install cmake
sudo apt-get install g++
sudo apt-get install doxygen

3. Build

The following commands build the packages.

mkdir BuildImagine
cd BuildImagine
cmake -DCMAKE_BUILD_TYPE:string=Release /path/to/Imagine++-directory
make package

You should see the binary archive and maybe the Debian package. You should then install one of them, following the instructions above (Installers or Alternative: Binary package).

Before installing, you may wish to check the tests, for example:


If the process fails somewhere, please check Troubleshooting.

4. Documentation

If you want to build the documentation, run

make doc

before 'make package'