Video 12: Installation ImageMagick

mz3Tool, our “development tool” for digital publishing with MegaZine3, makes heavy use of several OpensSource tools. ImageMagick is one of those.

Video 12: Installation ImageMagick shows how to enable this tool.

Reasons for installing ImageMagick

ImageMagick is a VERY powerful tool, and we only need a small fraction of all that functionality. But if you are interested in image manipulation and are willing to learn how to work with ImageMagick (it is mostly command line driven!), then you’ll see that almost everything is possible.

JPG Images for the Javascript Version

In our case the tool helps to convert PNG files into JPG files. The JPG file format is used for thumbnails and in many cases also is the best option for the MegaZine3 Javascript version. Therefore we recommend installing ImageMagick. You then have both image options for the Javascript version (PNG or JPG), and also can create thumbnails “offline”.

JPG Images for prebuilt Thumbnails

The advantage of prebuilt thumbnails is that right after starting an Mz3 Title all thumbnails are available and hovering over the “page bubbles” immediately shows the page content.


Another advantage is that no empty pages with “loading…” will be seen in case of opening a new page outside the proximity of the actual page (i.e. which is set with the book attribute “maxloaded“) . With preloaded thumbnails the (upscaled) thumbnail is shown instead; in many cases the nicer option.
The little downside is:  it takes a bit longer at the beginning before pageflips are as fast and fluent as usual.

With ImageMagick installed you have all these options!

Installing ImageMagick

How ImageMagick is installed on Windows and OSx is shown in Video 12: Installation ImageMagick.

For Windows it is very easy: Select and download the correct version of ImageMagick in the Windows download area and then run the installer – Done!

Since version 7.0.2-9 the tool “convert” mz3Tool is using no longer is installed by default. You explicitely have to set the checkmark with “Install legacy utilities (e.g. convert)”!


For OSx it is a bit more complicated:

  • If not already modified, it will be necessary to change the default settings under “System preferences – Security&Privacy – General” to allow App downloads from “anywhere”
  • If no package manager is installed, first do so first. Either MacPorts or Homebrew are commonly used.
  • The example in the video shows an installation with Homebrew. Details on how to install can be found on the home pages of MacPorts and Homebrew. Also in the download area  of ImageMagick for OSx some details are provided.
  • Once a package manager is available, download the ImageMagick OSx Binary and follow the steps explained there; or watch our video.
  • You need to use the Terminal to get the package manager and then install ImageMagick. But don’t be shy; following the steps provided under the links for Homebrew and ImageMagick and watching the installation in the video will guide you though that process!

Verifying the Installation

Once ImageMagick is installed, mz3Tool will detect it and confirm with a log statement. In the “main configuration” panel you will see that the checkmark to enable prebuilt thumbnails will be enabled and the JPG option can be selected for the Javascript version.


After these steps all features and functions of mz3Tool and MegaZine3 are available!


Categories: Technical and Videos.