Porting Scripts for GIMP 3.0

26 November 2025

GIMP 3.0 hit my Linux machines a while ago, and all my personal and 3rd-party scripts broke.

I finally took a moment to look at the errors and figure out what needed to be updated.

My simplest script merely sets the current layer’s blend mode to Soft Light, but even that broke. Why’s that useful? Once there’s an action in the menu, I can bind a keyboard shortcut (Ctrl-S) to it. I need to switch lots of new layers to Soft Light: High Pass for sharpening, or a layer for dodging and burning.

Registering the menu is what often failed:

attempted to install procedure ""
with a full menu path "<Image>/Shortcuts/_Change to Softlight" as menu label,
this is not supported any longer.

To fix it, we move the menu path into a separate call, instead of all at once in script-fu-register.

Here’s the fixed script:

(define (softlight-layer img inLayer)
  (gimp-layer-set-mode inLayer LAYER-MODE-SOFTLIGHT)
    (gimp-displays-flush))

(script-fu-register
    "softlight-layer"                         ;function name
    "Change to Softlight"                     ;menu label
    "Change current layer to Softlight mode"  ;description
    "John Flinchbaugh"                        ;author
    "Copyright 2025, John Flinchbaugh"        ;copyright notice
    "November 26, 2025"                       ;date created
    "RGB* GRAY*"                              ;image type that the script works on
    SF-IMAGE "image" 0
    SF-DRAWABLE "drawable" 0)

(script-fu-menu-register "softlight-layer" "<Image>/Shortcuts")


Podcast List for November 2022

03 November 2022

I have 73 feeds I currently follow. I have a whole system of prioritization, so I can listen to important things first. I’ve listed them alphabetically here:


2018-07-24 Podcast List

24 July 2018


Watching for GIMP 2.10.1

13 May 2018

I was seeing the new GIMP 2.10.0 doing bad things with multiple gradients on a transparent layer, so I logged Bug 795866. They quickly fixed the bug within 48 hours, but now I’m sitting here reloading the GIMP news page to see if they’ve cut the newest release.

Update: GIMP 2.10.2 just hit Debian Unstable!


All the Posts

November 2025

November 2022

July 2018

May 2018

April 2017

February 2016

February 2010

January 2008

October 2007

August 2007

June 2007

March 2007

January 2007

November 2006

September 2006