GIMP/Installing Plugins

From Wikibooks, open books for an open world
Jump to: navigation, search

Plugins can be very helpful in The GIMP. GIMP Plugins can be quite useful. Take, for example, the DDS plugin. The DDS plugin is a now stable and reliable plugin to load DDS files, supporting the OpenGL S3TC extension. Of course, GIMP plugins are not limited to file loading. There exists a GIMP plugin for using the CMYK color model!

If you want to run Photoshop plugins in The GIMP, Microsoft Windows and Linux users may use the PSPI plugin. http://www.gimp.org/~tml/gimp/win32/pspi.html

Finding and downloading plugins[edit]

The largest known source of GIMP plugins is the GIMP Plug-In Registry. The GIMP Plug-In Registry contains many useful plugins for The GIMP and all of its versions. In addition to regular plugins, you can also find Perl, Script-Fu and Python plugins at the GIMP Plug-In Registry.

You can find the GIMP Plug-In registry at the URL below.

http://registry.gimp.org/

Once you have downloaded the plugin, you need to load it into GIMP. In order to load it into GIMP, it needs to be extracted from the package in which it came.

Extracting plugin packages[edit]

Almost every plugin you download will come in a package. You need to extract this package.

ZIP files can be extracted easily in Windows and GNU/Linux with the utilities included with your OS. Windows includes ZIP support by default. Most (if not all) GNU/Linux distributions include Info-ZIP, which can be used to decompress ZIP files, along with a GUI frontend, such as File Roller for GNOME and Ark for KDE.

RAR files are compressed using a proprietary format. WinRAR is the original tool for RAR, available for many platforms, but it is proprietary shareware. There are alternatives. The free software (as in freedom) unrar can unpack RAR files that do not use RAR 3.0 or later. If RAR 3.0 is needed, taking a newer CVS snapshot may work, which has been done for the unrar-free Debian and Ubuntu packages. The 7-Zip program includes support for RAR 3.0, but the RAR component is proprietary.

TAR.GZ and TAR.BZ2 files are compressed archives originating from GNU/Linux. It is a double extension. The "GZ" or "BZ2" section refers to the fact the compression method is gzip or bzip2. gzip and bzip2 can only compress single files, however, so a program like tar is used to merge the files/folders into one file, hence the "TAR" section of the name. On GNU/Linux, the original tools can be used, usually "tar -xvzf file.tar.gz" (TAR.GZ) or "tar -xvjf file.tar.bz2" (TAR.BZ2). On Windows, the free 7-Zip can be used.

7z files can be done in Windows with 7-Zip, and in GNU/Linux, if the p7zip utility is installed, Ark and File Roller will work, along with the p7zip command directly.

If you find any other file types, a quick search on the internet will help. On the Windows platform, 7-Zip is a piece of software that will extract most file formats, while on GNU/Linux, most free are bundled with the OS and others usually can be found in your package manager.

Copying the plugin to the GIMP plugin directory[edit]

Open up the folder containing the plugin. Now, copy the files to the clipboard (Select the files, right click one and press copy)

Windows[edit]

On Windows, go to folder GIMP is installed in (usually somewhere in Program Files). Once in the GIMP's main folder navigate to lib\gimp\*version*\ where as *version* represents the version of The Gimp. Then double click the "plug-ins" folder. Not all plugins will run in Windows if the OS is 64bit, "normalmap" is one.

To install a script (ends in ".scm") navigate to share\gimp\*version*\. Then double click the "scripts" folder.

GNU/Linux[edit]

On GNU/Linux, you might need to read the manual at the official site first under the section:

"1.3. Installing New Plugins" http://docs.gimp.org/en/gimp-scripting.html#gimp-plugins-install

Plugins may be stored in different locations depending upon your distribution.

Locally installing plugins are easiest because they will usually be stored in a hidden folder under $HOME/.gimp-*.* (where you should replace $HOME with path to your home catalogue and gimp-*.* with the version you use (for example 2.6). In this case, however, the plugins you install will only be available to the user who installed them, which may not be what you want.

If you want to install plugins globally, you might have to look around a bit more. Some boxes will have plugins stored at /opt/gnome/lib/gimp/2.0/plug-ins/ (change lib to lib64 if you've got a 64bit OS), others /usr/lib/gimp/2.0/plug-ins/ (change lib to lib64 if you've got a 64bit OS. Running "$whereis gimp" (or "which gimp") in a terminal might help. For example, if the output was /some/place/bin/gimp, then you could check the /some/place/lib (or lib64 if you've got a 64bit OS). In Ubuntu, plugins are located at /usr/share/gimp/2.0/ for both 32 and 64bit. Note that you have to be root to access these files.


Ubuntu GNU/Linux[edit]

Steps to install GIMP scripts / plugins

  1. Download the relevant GIMP script from the GIMP plug-in registry.
    • Each GIMP script is available in two formats namely – Script-Fu (.scm) and Python script (.py). You can choose to download either one of them but not both. If you are downloading the Script Fu file, then it should be saved in GIMP scripts folder. If you are downloading the Python file, it should be saved in the GIMP plug-ins folder. Let’s assume we have downloaded the python script for the sake of this example.
  2. Save the downloaded python script into the GIMP plug-ins folder. In Ubuntu, it is in the directory /usr/lib/gimp/2.0/plug-ins/ How did I find the correct directory, you ask? I opened a terminal and ran the following command :
    $ dpkg -L gimp | grep plug-ins
    

    Of course, there is another way of finding the GIMP plug-ins folder which is, start GIMP and open “GIMP Preferences” dialog. In this dialog, click on “Folders > Plug-ins” and you will find the directory where GIMP installs all its plug-ins.

    Now you copy the downloaded script (gimp-script.py) into this folder as follows :

    $ sudo cp gimp-script.py /usr/lib/gimp/2.0/plug-ins/.
    
  3. Next open the terminal and set the execute bit for the python script file as follows :
    $ sudo chmod +x /usr/lib/gimp/2.0/plug-ins/gimp-script.py
    
  4. Lastly, if you have GIMP already running, restart it so that it is aware of all the new scripts you have installed.

Mac[edit]

System-wide script-fu scripts are stored in /Applications/Gimp.app/Contents/Resources/share/gimp/2.0/scripts/. Executable and python plugins are located in /Applications/Gimp.app/Contents/Resources/lib/gimp/2.0/plug-ins/

User-private plugins are stored under $HOME/Library/Application Support/Gimp/2.8/plug-ins/.

NOTE: Check "Preferences > Folders" to confirm your plug-ins directory. On some system, it may be set to "Library/Application Support/GIMP/2.8/plug-ins/" which is wrong. Fix this by adding a new path and restarting.

Testing the plugin[edit]

To test the plugin, simply open the GIMP and try the plugin. If this plugin makes a certain image type supported, try opening a file of that type. If the plugin is a filter, test it.

Troubleshooting[edit]

If the plugin appears to not be working, be sure that its for your OS and it is for your version of GIMP.

Also, Scheme ( Script-Fu ) plugins (*.scm) and python plugins go in their own respective folder, up one level from the regular plugins directory. Python plugins also require gimp-python.

The Script-Fu directory is something like /usr/share/gimp/2.0/scripts/.


Blending Exposures · Remove Coherent Noise