Enabling ImageMagick

Introduction

FileRun requires ImageMagick utility for generating thumbnails and previews for image files, PDF, PSD and other file formats.

GraphicsMagick (http://www.graphicsmagick.org) can also be used, and in some cases it can be faster and more efficient than ImageMagick

Installing ImageMagick

PDF Support

For ImageMagick to be able to generate thumbnails for PDF documents you might also need to install Ghostscript (http://www.ghostscript.com/download/gsdnld.html).

Make sure the Ghostscript app also has permissions to write to the server's temporary folder.

RAW Support

ImageMagick might require “dcraw” and “ufraw” utilities in order to support RAW image files. If you can't get ImageMagick to work with your raw files, give GraphicsMagick a try as it has better support for it.

Setting up FileRun

To enable ImageMagick please follow these steps:

  1. Login as superuser (default username “admin”).
  2. Open “Control Panel”.
  3. Go to “System configuration” » “Interface” » “Thumbnails and preview”.
  4. Use the “ImageMagick support” section to either set the path to the ImageMagick binary (convert on older versions, magick on newer) or use the PHP IMagick extension, if it's available.

Example of valid paths:

Windows servers: C:/ImageMagick/magick.exe
Windows servers: "C:/Program Files/ImageMagick/magick.exe" (Using double-quotes because of the space character in the path)
Linux servers: /usr/bin/convert

Troubleshooting

If you see broken icons instead of thumbnails:

  1. Make sure ImageMagick is working, running the following command: convert logo: image.jpg
  2. Make sure the path to ImageMagick is correctly configured in FileRun's control panel.
  3. Make sure the folder the image files are in, are writable by PHP. FileRun needs to cache the generated thumbnails in a hidden folder next to the files. If the folder should be read-only, then configure FileRun with an external location for the thumbnail cache (see $config['path']['thumbnail_cache'] on this page)
  4. For PDF files: make sure that Ghostscript is working. Try converting a PDF document using the command line: convert example.pdf example.png
  5. On Windows servers: make sure PHP can run external application. You need to give the Internet Guest User (IURSR or IUSR_<your-computer-name> on older servers) “read & execute” permission on the file that PHP is trying to run ImageMagick trough. That would be “cmd.exe” (located usually inside the folder “C:/Windows/System32”), the file used for running programs trough the command line.
  6. On Windows servers: you might also need to adjust the permissions of the system temporary folder, to allow ImageMagick, Ghostscript and most importantly IUSR to write temporary data in there. Without the permissions, generating thumbnails from the command line might work, but it won't work for FileRun.
  7. If still having troubles: right-click a file, select the Control panel option under “More options”. You will find in there troubleshooting tools which will help you find out what happens behind the scene and where the problem might be.