Welcome to Gimp3-Tools!

The scripts that you will find here are written for Gimp3 and won't work with previous versions (Gimp 2.x).

This site is split into several categories:

• General for general scripts (mostly those that deal with layers)
• Paths for those scripts that deal mostly with paths

Installing the scripts

Scripts are packaged in ZIP files. To install:

1. Check that your instance of Gimp supports Python scripts:

   • Go to Filters > Development > Python-fu > Python console
   • You should get a header announcing Python 3.x
   • At the >>> prompt, enter print(Gimp.directory())
   • The answer tells you where you Gimp user profile is

2. Using your explorer, navigate to that Gimp user profile

3. You should find a plug-ins subdirectory there
4. Enter plug-ins

5. Unzip the downloaded ZIP there, making sure you keep the directory structure. This should create something like this:

   {your user profile}/plug-ins
   └── ofn3-your-installed-script
       ├── Doc
       │   ├── ofn3-your-installed-script.html
       │   └── (some more image files are possible)
       ├── gimphelpers.py
       ├── ofn3-your-installed-script.py
       └── (some more files are possible)
   

6. where:

   • the directory name and the main Python plugin file should have the same name (ofn3-your-installed-script, here)
   • gimphelpers.py is code that is common to most of my plugins
   • Doc contains the documentation. The HTML file it contains (ofn3-your-installed-script.html) can be opened in your internet browser and is a recommended reading. It will tell you how the script works (and in particular, where to find it in the menus)
7. You must restart Gimp to make it appear in the menus.

Notes:

• You can of course also install the plugin in any directory you added in Preferences > Folders > Plug-ins

• On OSX & Linux:

  • the main plugin file must be marked as executable (but not the others). The plugin extracted from the ZIP should have the right flags on the files (but it would be the first thing to check in case of suspected installation problems)
  • the Gimp profile directory may include some dotted names, so make sure your file explorer shows "hidden" files.

Support

For support visit http://www.gimp-forum.net

Enjoy!