This page documents the installation procedure for the latest plugin version (0.6.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 (just take care to uninstall any older version you might have installed through your package manager first, to avoid problems with future updates).
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, intltool, and the Liquid Rescale Library (liblqr1), version 0.3.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, enter into the directory where you downloaded the plugin, then issue these commands:
tar -vxjf gimp-lqr-plugin_0.6.1.tar.bz2
cd gimp-lqr-plugin_0.6.1
./configure && make && sudo make install
The last step requires that you have administrative privileges on your computer.
If you're installing a different version then 0.6.1, just substitute the correct version number in all of the above commands.
That's all. If everything went right, 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
The plugin is already included with the latest GIMP on OS X bundle and is automatically installed when you get GIMP from MacPorts.
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)
The installation file is a self-extractig executable. If you have GIMP installed in the default location, i.e. in the GIMP-2.0 folder under your main Program Files folder, just execute the file and click the Extract button, and you'll find the plugin under the Layer menu the next time you start GIMP.
If you have GIMP installed in a non-standard location, just use a program which is able to read zip files and use it to open the file you downloaded and extract the files contained in it, with their full directory structure, into the main GIMP folder.
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 self-extracting archive with some program which is able to read zip files, 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 similarly to the standard GIMP version, but the extractor will ask for the installation location. If you have a default installation, you will just need to select the correct drive letter (the default is arbitrarily chosen as L:), and leave the default path as it is; otherwise, just make sure that you install it under the GIMPPortable\App\gimp subdirectory of your main PortableApps installation folder.
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 (independently from the drive letter).
