This page documents the installation procedure for the latest plugin version (0.5.1 currently).
If needed, you can find instructions about the older 0.3.0 version here.
Linux
The easy way: repositories and packages
Some distributions include the plugin in their repositories, which provide the easiest way to install it and keep it up to date.
There's a list of available repositories in the Download page, along with instructions for their usage.
Installing precompiled packages is also very easy, as it normally just amounts at double-clicking the file you've downloaded.
Installing from sources
If you are upgrading from version 0.3.0 it is advisable to uninstall the previous version before proceding.
If there are no precompiled packages or repositories available for your distribution, or if they don't include the latest version, you can compile and install from sources.
First of all, you have to make sure to satisfy all the dependencies. The most important ones are the GIMP headers (version 2.4 or later), gettext,
and the Liquid Rescale Library (liblqr1), version 0.2.0 or later.
You can find the liblqr1 Library here, along with precompiled packages and instructions, while all other required packages should be available through
your own distribution.
(Of course, you will also need the compilation tools, in Ubuntu these are included in the build-essential package.)
When you have installed all the other required packages, open a terminal, go to the directory where you downloaded the file, then extract it with:
tar -vxzf gimp-lqr-plugin_X.Y.Z.tar.gz
where X.Y.Z represents the version that you're installing.
This will create a directory called gimp-lqr-plugin_X.Y.Z, enter into it and issue:
./configure && make && sudo make install
The last step requires that you have administrative privileges on your computer.
That's all. You will find the plugin under the Layer menu the next time you restart GIMP.
Uninstalling
Just go back to the plugin directory and issue
sudo make uninstall
Mac OS X
Disclaimer: the following instructions were written for version 0.4.0 and have not been tested with version 0.5.0. They should work however. If anyone tries this, please report (either in the forum or via private message, both in case of failure or success).
Installing GIMP and required dependencies
To install the liquid rescale plugin, you will have to install Gimp.app from the macports package distribution system as well as the X11.app provided on OS X installation CDs (or XDarwin).
There are two reasons for that:
- the gimp.app project DMG distribution doesn't provide all the required headers etc… to compile the plugin,
- Fink gimp version is outdated and only macports provides a Gimp version that is compatible with this plugin.
Once you have installed macports, install the gimp and gimp-app port:
sudo port install gimp gimp-app
You might have errors during this process, and will have to force the activation of perl related ports:
sudo port activate -f p5-pathtools
sudo port activate -f p5-getopt-long
and then relaunch the gimp port installation.
You will also need the Liquid Rescale Library installed (download and instructions here).
Compile and Install the plugin
You can now compile the plugin from source:
- extract the source archive
tar -vxzf gimp-lqr-plugin_X.Y.Z.tar.gz
- go into the decompressed directory
- on the command line, configure the compilation with:
./configure --prefix=/opt/local PKG_CONFIG_PATH=/path/to/liblqr-1-X.Y.Z
where PKG_CONFIG_PATH points to the directory that liblqr was downloaded to (the directory that contains the file "lqr-1.pc").
To install version 0.5.0, you have to edit manually a file before compiling. Edit the file po/Makefile with a text editor and find the lines 47 to 49 that should be:
GMSGFMT=
MSGFMT=
XGETTEXT=
and replace them with:
GMSGFMT=/opt/local/bin/msgfmt
MSGFMT=/opt/local/bin/msgfmt
XGETTEXT=/opt/local/bin/xgettext
You can now compile with:
make
sudo make install
The plugin will be installed and you can use it from /Applications/MacPorts/Gimp.app, under the Layer menu.
Windows
Standard GIMP version installation
If you have a standard installation of GIMP (i.e. not a PortableApps one), use these instructions.
Standard installation (for all users of the system)
Extract the files, with their full directory structure, into the main GIMP folder (usually it is under C:\Program Files\GIMP-2.0, but the Program Files folder has different names in different languages - just find out yours).
Then, you should see the plugin under the Layer menu the next time you restart GIMP (if you don't, the first thing you should do is check that the files gimp-lqr-plugin.exe and plug_in_lqr_iter.exe are located under the folder C:\Program Files\GIMP-2.0\lib\gimp\2.0\plug-ins).
Note: the plugin tranlsations and help will only work correctly if the main GIMP folder is the standard one, and if the actual name of your Program Files directory begins with the letters PROGRA (this is the case for example in Italian and French).
Binary-only installation (for single users)
If you prefer to only install the plugin for one user of the system, and you do not care about the help files and the localization, then open the archive with some program, enter in the folders lib\gimp\2.0\plug-ins and drag-and-drop the two files you find there into your GIMP user folder, that is:
- in XP: C:\Documents and Settings\YOUR_NAME\.Gimp-2.X
- in Vista: C:\Users\YOUR_NAME\.Gimp-2.X
The plugin should then be available under the Layer menu the next time you start GIMP.
GIMPPortable version installation
The installation for PortableApps users proceeds in the same way as the standard GIMP version, i.e. you just need to extract the archive in the right place. Let's say that you have installed PortableApps in drive L:, and that you have GIMP installed under L:\PortableApps\GIMPPortable. Then you have to extract the archive with its full directory structure into the folder L:\PortableApps\GIMPPortable\App\gimp, and the plugin will be available under the Layer menu the next time you start GIMP.
Note: the plugin translations and help will only work correctly if the installation path is the default one, like in the above examples.