<div style="text-align: center;"><img src="https://i.imgur.com/1CjRXJu.png"></div>
- - - -

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](general) for general scripts (mostly those that deal with layers)
* [Paths](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](http://www.gimp-forum.net)

Enjoy!
