This file documents how to use the binary distribution packages built by ImageMagick Group, and found in the ImageMagick 'binaries' subdirectory of ImageMagick ftp sites. Those who want to build ImageMagick from source code should refer to the file README.txt in the ImageMagick source package or http://www.imagemagick.org/www/install.html on the web.

Unix/Linux/Darwin/Cygwin/MinGW Install:

Download the appropriate binary from

ftp://ftp.imagemagick.org/pub/ImageMagick/binaries

Create (or choose) a directory to install the package into and cd to that directory, for example:

         mkdir $HOME/ImageMagick
         cd $HOME/ImageMagick

Extract the contents of the package using the command

gzip -dc /path/to/package.tar.gz | tar -xf -

If the 'bin' subdirectory of the extracted package is not already in your executable search path, add it to your PATH environment variable. For example

export PATH; PATH="$HOME/ImageMagick:$PATH"

Test ImageMagick to see if it is working

         convert "LOGO:" logo.miff
         display logo.miff

If an error is displayed that a file can not be found, you may need to set the MAGICK_HOME environment variable to the path where you extracted the ImageMagick files. For example

export MAGICK_HOME="$HOME/ImageMagick"

Additional Information

Environment Variables:

         In addition to the MAGICK_HOME environment variable defined above,
         you may find these variables useful:

           MAGICK_HOME             path to ImageMagick installation directory
           TMPDIR                  path to store temporary files
           LD_LIBRARY_PATH         path to libMagick.so and other libraries

Configuration Files

          ImageMagick depends on a number of external configuration files
          which include colors.mgk, delegates.mgk, magic.mgk, type.mgk, and
          modules.mgk. ImageMagick searches for configuration files in the
          following order, and will use the first file found:

              <client path>/../lib/ImageMagick/
              $MAGICK_HOME/lib/ImageMagick/
              $HOME/.magick/
              <current directory>/

Font Files

          ImageMagick is able to load raw TrueType and Postscript font files.
          It searches for these files in the following order and uses the
          first match found:

              <current directory>/
              $MAGICK_FONT_PATH/
              $MAGICK_HOME/
              $HOME/.magick/

Module Files

          ImageMagick's file format support is usually provided in the form
          of loadable modules. It searches for loadable modules in the
          following order and it uses the first match found:

              <client path>/../lib/ImageMagick/modules/coders/
              $MAGICK_HOME/lib/ImageMagick/modules/coders/
              $HOME/.magick/
              <current directory>/

XP, Win2K, WinME, NT, Win98, Win95 Install:

Download

ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-i686-pc-windows.exe

and execute it (or "open" it from your browser) to start the installation program.

Once ImageMagick is installed, Select Start->Programs->Command Prompt. In the Command Prompt window type

identify -verbose logo:

If you have an X11 server, from the Command Prompt window type

          set DISPLAY=:0
          display

MAC Install:

Download

ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-powerpc-apple-mac9.2.sit

or

ftp://ftp.imagemagick.org/pub/ImageMagick/binaries/ImageMagick-powerpc-apple-darwin6.6.tar.gz

and double click on it to extract the distribution. Move to the ImageMagick folder and double click on the convert program icon. Next, type

-verbose logo: logo.jpg

in the command window and choose File->Quit to exit.

VMS Install:

Type

          unzip ImageMagick.zip
          set default [.imagemagick]
          @make
          identify -verbose logo:

"Image manipulation software that works like magick"