How to Install GIMP Plugins - Detailed Guide with Troubleshooting

Installing a GIMP plugin should take two minutes - But the wrong folder, a missing execute bit, or a version mismatch can leave it completely invisible. This guide covers exact folder paths for every platform and GIMP version, step-by-step installation for each plugin type, and a full troubleshooting reference.

Plugin Folder Paths by Platform and GIMP Version

GIMP maintains a separate user-writable plug-ins folder for each major version. The path depends on your operating system and which version of GIMP you have installed. Drop your plugin files into the correct folder for your combination.

On Windows, paste %APPDATA%\GIMP\3.0\plug-ins\ directly into the File Explorer address bar and press Enter - It will expand to the full path automatically. The folder may not exist yet; create it if needed. For information on plugin licensing and whether GIMP plugins are free to use, see Are GIMP plugins free?

On macOS, the ~/Library folder is hidden by default. In Finder, press Cmd + Shift + G and paste the path to navigate directly.

You can also confirm or change these paths from inside GIMP: Edit → Preferences → Folders → Plug-ins. This panel lists all folders GIMP scans at startup and lets you add custom locations.

Script-Fu scripts use a different folder

Scripts with a .scm extension are not plugins - They are Script-Fu scripts and must go in the scripts/ folder, not plug-ins/. The scripts folder sits alongside the plug-ins folder at the same level:

• Windows: %APPDATA%\GIMP\3.0\scripts\
• macOS: ~/Library/Application Support/GIMP/3.0/scripts/
• Linux: ~/.config/GIMP/3.0/scripts/

After copying a .scm file there, you do not need to restart GIMP. Go to Filters → Script-Fu → Refresh Scripts and the new script will appear in the menu immediately.

Plugin Types and What They Require

GIMP supports several different plugin formats. Each has different installation requirements.

Python-Fu Plugins (.py)

Python plugins are the most common type for GIMP 3.x. They require Python 3 to be installed and accessible. For writing your own Python-Fu scripts, see the Python-Fu scripting tutorial. On Linux and macOS, the .py file must be marked executable before GIMP will load it:

chmod +x /path/to/plug-ins/myplugin/myplugin.py

On Windows, execute permissions are not a concept - The file just needs to be in the right folder.

Native Compiled Plugins (.so / .dll)

These are compiled binary plugins that extend GIMP at the C level. They are platform-specific - A .so compiled for Linux will not run on Windows. Most well-known plugins in this category have been absorbed into GIMP itself or are distributed as part of packages like GIMP's official repository. Installing them usually means using your package manager rather than copying files manually.

Installation Steps by Plugin Type

1. Script-Fu (.scm) - No Restart Required

1. Copy the .scm file to the scripts/ folder for your platform (see paths above).
2. In GIMP, go to Filters → Script-Fu → Refresh Scripts.
3. The script will appear in the appropriate menu immediately - No restart needed.

2. Python-Fu (.py) - Subfolder Required

GIMP 3.x requires Python plugins to live inside a subfolder named the same as the plugin file. A plugin called myplugin.py must be placed at:

plug-ins/
  myplugin/
    myplugin.py

1. Create a subfolder inside plug-ins/ with the same name as the plugin (without .py).
2. Place the .py file inside that subfolder.
3. On Linux/macOS: chmod +x plug-ins/myplugin/myplugin.py
4. Restart GIMP. The plugin will appear in the Filters menu or wherever it registered itself.

3. Native Compiled (.so / .dll)

1. These plugins usually require compiling from source using GIMP's development headers, or downloading a pre-compiled binary built specifically for your GIMP version and OS.
2. On Linux, many are available via your distribution's package manager (e.g., apt install gimp-plugin-registry).
3. Place the compiled .so or .dll file in the plug-ins folder and restart GIMP.

4. G'MIC - Use the Official Installer

G'MIC (GREYC's Magic for Image Computing) is a large, actively maintained plugin with 500+ filters. Do not try to install it manually. Use the official installer or package:

• Windows / macOS: Download the GIMP-compatible binary from gmic.eu.
• Linux: Install via package manager: apt install gimp-gmic or equivalent.
• Restart GIMP. G'MIC appears under Filters → G'MIC-Qt.

5. Resynthesizer - Platform-Specific Binary

Resynthesizer (used for content-aware fill) requires a platform-specific pre-compiled binary. Installing the wrong build will silently fail.

• Windows: Download the Windows binary from the Bootchk GitHub releases page. Extract the .dll and helper scripts to your plug-ins folder.
• macOS: Homebrew build or manual compile recommended. No official macOS binary for GIMP 3.x as of mid-2025.
• Linux: apt install gimp-plugin-registry includes Resynthesizer on Ubuntu/Debian.

Troubleshooting Plugin Installation

Plugin not appearing in the Filters menu

• Wrong folder: Double-check that you used the correct path for your GIMP version (3.x vs 2.10). Putting a GIMP 3.x plugin in the 2.10 folder (or vice versa) means GIMP will never see it.
• Forgot to restart GIMP: Python plugins and compiled plugins require a full GIMP restart. Only Script-Fu scripts can be refreshed live.
• Python plugin not in a subfolder: GIMP 3.x requires the subfolder structure described above. A .py file dropped directly into plug-ins/ will be ignored.
• Verify the path: Open Edit → Preferences → Folders → Plug-ins and confirm GIMP is actually scanning the folder you placed the plugin in.

Python plugin crashes on import

If GIMP shows an error when loading a Python plugin, the most common causes are:

• Python 3 is not installed or not in the system PATH. On Windows, install Python 3 from python.org and ensure "Add Python to PATH" is checked during installation.
• A required Python library is missing. Check the plugin's README for dependencies and install them with pip install packagename.
• The plugin was written for Python 2 (GIMP 2.10 era) and is incompatible with GIMP 3.x's Python 3 environment.

"Procedure not found" error

This error means GIMP loaded the plugin but when something tried to call it, the registered procedure name was not found. This almost always means the plugin was written for GIMP 2.10 and uses the old PDB API. GIMP 3.x uses a completely rewritten Procedural Database (PDB 3.0). Plugins written for 2.10 must be updated by the plugin author to work in GIMP 3.x - There is no automatic compatibility layer.

Linux: file permission issues

On Linux, check that your plugin files are owned by your user and have the correct permissions:

ls -la ~/.config/GIMP/3.0/plug-ins/

Python plugins must have the execute bit set (-rwxr-xr-x). If you see -rw-r--r--, run:

chmod +x ~/.config/GIMP/3.0/plug-ins/myplugin/myplugin.py

macOS: execute permission on .py files

The same execute permission requirement applies on macOS. After copying a .py plugin to your plug-ins folder, open Terminal and run:

chmod +x ~/Library/Application\ Support/GIMP/3.0/plug-ins/myplugin/myplugin.py

How to Check if a Plugin Installed Correctly

The quickest way to confirm GIMP is running and the plugin environment is intact is through the Script-Fu Console. Go to Filters → Script-Fu → Console and run:

(car (gimp-version))

This returns the current GIMP version string, confirming the scripting environment is working. To check whether a specific plugin's procedure is registered, try:

(cadr (gimp-version))

For Python plugins, GIMP's Error Console (Filters → Script-Fu → Error Console on older versions, or Windows → Dockable Dialogs → Error Console) will show any import errors that prevented the plugin from loading.

You can also browse all registered procedures in Help → Procedure Browser. Search for your plugin's name - If it appears here, GIMP knows about it and it is installed correctly.

For a broader overview of GIMP plugins and our top recommendations, see the GIMP plugins overview page. If you are wondering whether Photoshop plugins work in GIMP, see Photoshop plugins in GIMP for a full explanation.