Skip to main content

Installing and Using Scripts

Adding other people's automation to your GIMP

In This Lesson

Why Install Scripts

You don't have to write automation yourself — the GIMP community has produced thousands of free scripts and plug-ins that add features and shortcuts: export-for-web helpers, photo effects, layer utilities, and more. The famous G'MIC plugin is the biggest example. Installing a script is usually just dropping a file into the right folder and refreshing.

Where Scripts Live

GIMP loads scripts from folders it scans at startup. The language decides the folder and file type:

TypeFile extensionFolder
Script-Fu.scmthe scripts folder
Python-Fu.pythe plug-ins folder

Find the exact paths under Edit → Preferences → Folders → Scripts (and → Plug-ins). There are usually two locations: a system one and your personal GIMP user folder. Always install into your personal folder so updates and reinstalls don't wipe your additions.

💡 Use the Personal Folder

Preferences → Folders lists your writable user folder with a small folder icon. Installing there keeps your scripts separate from GIMP's own and safe across upgrades — the same folder you back up from yesterday's lesson.

Finding Good Scripts

  • The GIMP Plugin Registry archives and community forums are traditional sources.
  • G'MIC (gmic.eu) bundles hundreds of filters in one plugin — the best single install for most people.
  • Check that a script targets GIMP 2.10; scripts written for 2.6/2.8 sometimes need small fixes.

⚠️ Scripts Run Code — Be Careful

A script is a program with access to your files. Install only from sources you trust, and be wary of random downloads. Reputable community sites and the official G'MIC are safe bets; unknown code from nowhere is a risk.

Installing a Script

  1. Download the .scm (Script-Fu) or .py (Python-Fu) file.
  2. Copy it into your personal scripts (or plug-ins) folder from Preferences → Folders.
  3. On Linux/macOS, make a .py plug-in executable (its permissions) so GIMP will run it.
  4. Refresh: Filters → Script-Fu → Refresh Scripts for Script-Fu, or restart GIMP (always needed for Python plug-ins).
flowchart LR A[Download script file] --> B[Copy to personal scripts or plug-ins folder] B --> C[Refresh Scripts or restart GIMP] C --> D[New menu item appears]

Drop the file in the right folder, refresh, and the command shows up.

Finding and Running It

Installed scripts add themselves to a GIMP menu — commonly under Filters, Script-Fu, File → Export, or their own submenu. The script's documentation tells you where it lands. Some run instantly; others open a dialog for options. If you can't find it, the script's own registration line names its menu path.

When It Doesn't Appear

⚠️ Common Fixes

  • Wrong folder — .scm must go in scripts, .py in plug-ins. Swapped, they won't load.
  • Didn't refresh/restart — Script-Fu needs Refresh Scripts; Python plug-ins need a full restart.
  • Not executable — a Python plug-in on Linux/macOS must have execute permission.
  • Version mismatch or error — check the Script-Fu Console or the error console for a load error, which names the problem.

Practice Activities

  1. Find your folders. Open Preferences → Folders and note your personal scripts and plug-ins paths.
  2. Install one. Download a simple, reputable Script-Fu script, place it, Refresh Scripts, and locate its new menu item.
  3. Install G'MIC. If you haven't, install G'MIC and confirm it appears under Filters → G'MIC-Qt.

Summary

✅ Key Takeaways

  • The community offers thousands of free scripts and plug-ins — G'MIC chief among them.
  • .scm Script-Fu goes in scripts; .py Python-Fu goes in plug-ins — use your personal folder.
  • Install by copying the file, then Refresh Scripts (Script-Fu) or restart (Python).
  • Installed scripts appear in a GIMP menu named by the script itself.
  • Install only trusted code; check the console for load errors when something doesn't appear.

➡️ What's Next

Put scripting to work: Basic Automation Tasks.

Additional Resources