A Full-Featured Open-Source Framework for Image Processing

• Packages for Fedora: should be available here.

The source code of G'MIC is shared between several GitHub repositories with public access. The code from these repositories is intended to be work-in-progress though, so we don't recommend using them to access the source code, if you just want to compile the various interfaces of the G'MIC project. It is recommended to get the source code from the latest .tar.gz archive instead.

Here are the instructions to compile G'MIC on a fresh installation of Debian (or Ubuntu). It should not be much harder for other distros. First you need to install all the required tools and libraries:

Then, get the G'MIC source:

You are now ready to compile the G'MIC interfaces:

• gmic (command-line tool),
• gmic_gimp_qt (plug-in for GIMP),
• ZArt and
• libgmic (G'MIC C++ library).

Choose one:

(compilation may take a while).

Note that compilation errors (compiler segfault) may occur with older versions of g++ (4.8.1 and 4.8.2). If you encounter these kinds of errors, you probably have to disable the support of OpenMP in G'MIC to make it work, by compiling it with:

Also, please remember that the source code in the git repository is constantly under development and may be a bit unstable, feel free to report any bugs.

On Windows, compiling executables of the different G'MIC interfaces is relatively straightforward. It requires the following steps:

• Set up of the compiling environment:
  
  
  • Install MSYS2, from https://www.msys2.org/.
  • Launch MSYS terminal (MSYS2 MinGW 64-bit), then update default installed packages with:
    $ pacman -Syu
  • Install required additional packages (note: this will require significant time and disk space — around 3GB):
    $ pacman -Sy mingw64/mingw-w64-x86_64-qt5 mingw64/mingw-w64-x86_64-gimp mingw64/mingw-w64-x86_64-pkgconf mingw64/mingw-w64-x86_64-gcc mingw64/mingw-w64-x86_64-fftw make git
  • Add /mingw64/bin to $PATH, by adding following line in file $HOME/.bash_profile:
    PATH="/mingw64/bin:${PATH}"
  • Close terminal, and relaunch it. Now all required tools to compile are available from the terminal.
  • Retrieve source code of G'MIC interfaces:
    $ wget https://gmic.eu/files/source/gmic_4.0.2.tar.gz && tar zxvf gmic_4.0.2.tar.gz && cd gmic-4.0.2
    
  
  
• Compilation of gmic (CLI interface):
  
  
  • Go to src/ source folder:
    $ cd src/
  • Compile with provided Makefile:
    $ make cli
    You may want to disable Link-Time-Optimization to save memory usage when compiling, because g++ eats a lot of memory when LTO is enabled. In that case, type:
    $ make FLTO="" cli
    instead.
  • When compilation succeeds, the G'MIC CLI executable can be found in current directory, i.e. gmic/src/gmic.exe.
  • Copy needed DLL for the gmic.exe executable. They are all found in /mingw64/bin/:
    $ cd /mingw64/bin/ && cp libgcc_s_seh-1.dll libwinpthread-1.dll libgomp-1.dll libstdc++-6.dll libcurl-4.dll libbrotlidec.dll libbrotlicommon.dll libcrypto-1_1-x64.dll libidn2-0.dll libiconv-2.dll libintl-8.dll libunistring-2.dll libnghttp2-14.dll libpsl-5.dll libssh2-1.dll zlib1.dll libssl-1_1-x64.dll libzstd.dll libfftw3-3.dll libjpeg-8.dll libpng16-16.dll libtiff-5.dll liblzma-5.dll PATH_TO_EXE/
  
  
• Compilation of gmic_qt (stand-alone Qt-based interface):
  
  
  • Go to gmic-qt/ source folder:
    $ cd gmic-qt/
  • Generate Makefile with qmake:
    $ qmake HOST=none
    For unknown reasons, qmake may take several minutes to complete, occasionally pausing for about five minutes without displaying any console output. However, it will eventually complete successfully.
  • Compile with generated Makefile:
    $ make -j4 release
  • When compilation succeeds, the G'MIC-Qt executable can be found in directory release/gmic_qt.exe.
  • Copy needed DLL for the gmic_qt.exe executable:
    $ cd /mingw64/bin/ && cp libgcc_s_seh-1.dll libwinpthread-1.dll libgomp-1.dll libstdc++-6.dll libcurl-4.dll libbrotlidec.dll libbrotlicommon.dll libcrypto-1_1-x64.dll libidn2-0.dll libiconv-2.dll libintl-8.dll libunistring-2.dll libnghttp2-14.dll libpsl-5.dll libssh2-1.dll zlib1.dll libssl-1_1-x64.dll libzstd.dll libfftw3-3.dll libpng16-16.dll Qt5Core.dll libdouble-conversion.dll libicuin67.dll libicuuc67.dll libicudt67.dll libpcre2-16-0.dll Qt5Gui.dll libharfbuzz-0.dll libgraphite2.dll libfreetype-6.dll libbz2-1.dll libglib-2.0-0.dll libpcre-1.dll Qt5Network.dll Qt5Widgets.dll PATH_TO_EXE/
  • Copy required Qt platform files:
    $ cp -rf /mingw64/share/qt5/plugins/platforms PATH_TO_EXE/
  
  
• Compilation of gmic_gimp_qt (plug-in for GIMP):

  Same as above, but invoke qmake with:

  $ qmake HOST=gimp
  
  
• Compilation of gmic_paintdotnet_qt (plug-in for Paint.NET):

  Same as above, but invoke qmake with:

  $ qmake HOST=paintdotnet

In order to check if G'MIC works correctly on your system, you may want to execute the command and filter testing procedures. Assuming the CLI tool gmic is installed on your system, here is how to do it (on a Unix-like system, adapt the instructions below for other OS):

These commands scan all G'MIC stdlib commands and G'MIC-Qt filters, and generate the images corresponding to the execution of these commands, with default parameters. Beware, this may take some time to complete!

G'MIC is an open-source software distributed under the CeCILL free software licenses (LGPL-like and/or
GPL-compatible). Copyrights (C) Since July 2008, David Tschumperlé - GREYC UMR CNRS 6072, Image Team.