MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: beta
Implementation Media
Description Allows Xcf (GIMP) images to be rendered inside MediaWiki pages.
Author(s) (pttalk)
License GNU General Public License 2.0 or later
Download bundle
Translate the Xcf extension if it is available at translatewiki.net
Check usage and version matrix.

What can this extension do?Edit

The Xcf extension allows GIMP multiple layer images to be embedded/rendered inside MediaWiki pages. It can be used to have thumbnails of specified size to be automatically generated from the uploaded .xcf files. (If no size is given, then the nominal size will be used.)


When rendering multiple layer images, all layers must have the same size as the image!


  • convert - This extension relies on an external conversion program to perform the conversion. By default, convert from the ImageMagick suite is used to perform this conversion, which means that you will need to have it installed on the server.


First copy the Xcf/ directory into the extensions folder of your MediaWiki installation.

To activate the extension, add the following lines to your LocalSettings.php file (near the end):

require_once( "$IP/extensions/Xcf/Xcf.php" ); # Load Xcf extension
$wgFileExtensions[] = 'xcf';                  # Allow uploading of xcf files

Also make sure that you have mediawiki configured to allow for file uploads:

$wgEnableUploads = true;

This setting is already present in LocalSettings.php, however, it defaults to false. To enable uploads, make sure it is set to true.

Furthermore, when relatively large files are used, convert may consume more memory than the default 100MB that MediaWiki grants it. You can increase the memory to 512MB by adding the following line to LocalSettings.php:

$wgMaxShellMemory = 512000;

Configuration parametersEdit