How to Automate Tasks in GIMP with Script-Fu?

This article provides a concise guide on how to automate repetitive image editing tasks in GIMP using Script-Fu, its native scripting language. You will learn the core concepts of Script-Fu, how to write a basic Scheme-based script, and the steps to execute your automated workflows directly within the software. By leveraging these scripting capabilities, you can significantly streamline your design pipeline and save valuable time on bulk operations.

Understanding Script-Fu in GIMP

Script-Fu is GIMP’s primary scripting extension, built on a dialect of the Lisp programming language called Scheme. It allows you to interact with GIMP’s internal functions programmatically. Instead of manually clicking through menus to apply filters, resize images, or adjust colors, Script-Fu lets you bundle these actions into a single reusable command.

While the syntax uses a prefix notation—meaning the operator comes before the arguments, such as (+ 2 3)—it is highly efficient for executing sequential image processing tasks once you understand the basic structure.

Writing Your First Script-Fu Script

To create a Script-Fu automation, you need to write a script and save it as a text file with a .scm extension. This file must be placed in GIMP’s scripts folder, which you can locate by navigating to Edit > Preferences > Folders > Scripts inside GIMP.

Here is a simple blueprint of how a Script-Fu script is structured:

(define (script-fu-invert-and-blur image drawable blur-radius)
  (gimp-image-undo-group-start image)
  (gimp-drawable-invert drawable FALSE)
  (plug-in-gauss-iir2 RUN-NONINTERACTIVE image drawable blur-radius blur-radius)
  (gimp-image-undo-group-end image)
  (gimp-displays-flush)
)

(script-fu-register "script-fu-invert-and-blur"
  "Invert and Blur"
  "Inverts the colors of a layer and applies a Gaussian blur."
  "Your Name"
  "Copyright Your Name"
  "2026"
  "RGB*, GRAY*"
  SF-IMAGE    "Image"    0
  SF-DRAWABLE "Current Layer" 0
  SF-ADJUSTMENT "Blur Radius" '(5 1 100 1 10 0 0)
)

(script-fu-menu-register "script-fu-invert-and-blur" "<Image>/Filters/MyScripts")

Key Components Explained

The Function Definition (define): This block contains the actual logic. The commands look up GIMP’s internal Procedures Database (PDB) to execute actions like inverting colors or applying Gaussian blur.
The Registration (script-fu-register): This section tells GIMP about your script, defining its name, description, author, and the parameters it requires (like the image, current layer, and user inputs).
The Menu Placement (script-fu-menu-register): This line dictates exactly where your script will appear within GIMP’s top menu bar interface.

How to Run Your Automated Script

Once your script is saved in the correct directory, you can easily load and run it without restarting the application.

Go to the top menu and select Filters > Script-Fu > Refresh Scripts. GIMP will scan your folder and load the new automation.
Open an image that you want to test.
Navigate to the menu location you defined in your script (e.g., Filters > MyScripts > Invert and Blur).
Adjust any parameters in the pop-up dialog box and click OK to run the automation.

For advanced users, Script-Fu can also be executed via the command line or through GIMP’s batch mode, allowing you to process entire folders of images automatically without ever opening the graphical user interface.