It is currently Sat Jun 20, 2026 3:04 pm


All times are UTC - 5 hours [ DST ]



Post new topic Reply to topic  [ 8 posts ] 
Author Message
 Post subject: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Mon Jul 21, 2025 8:54 am  (#1) 
Offline
GimpChat Member

Joined: Jul 21, 2025
Posts: 24
Hi everyone,
I’m trying to get some of my old Python plugins (originally written for GIMP 2.10) to work with GIMP 3.0.4 on macOS Sequoia, but they don’t seem to run.

Here’s what I’ve done so far:
• I copied the script to the plug-ins folder.
• I made the script executable and added the correct shebang (#!/usr/bin/env python3).
• I installed GIMP from the official DMG, which should include Python support.
• The plugin path in Preferences > Folders > Plug-ins is correctly set.

My question:

Does GIMP 3 still support Python plugins like GIMP 2.10 did? If so, are there major changes in the API or plugin structure I need to be aware of to make them work?

Any tips or helpful links would be greatly appreciated. Thanks in advance!


Share on Facebook Share on Twitter Share on Orkut Share on Digg Share on MySpace Share on Delicious Share on Technorati
Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Mon Jul 21, 2025 10:21 am  (#2) 
Offline
Administrator
User avatar

Joined: Aug 10, 2012
Posts: 14042
Location: Native to NYC living in Arizona, Gimp 2.8 - 3.0, Win 11 PC.
Hello Daguerre and welcome to Gimp Chat!
:jumpclap :clap :jumpclap

As of now (mid-2025),
GIMP 3 does not have full support for Python plugins in the same way GIMP 2.10 did.
GIMP 3 uses GTK 3 (or 4) and has made significant architectural changes,
including moving away from Python 2 entirely.

You can still write plugins in Scheme (Script-Fu) or C.
I keep GIMP 2.10 installed alongside GIMP 3,
so I can utilize these plugins.

The GIMP team is working toward restoring full Python 3 scripting support,
but there's no stable version with feature parity as of yet.




If I'm incorrect,
someone please chime in?

_________________
Image
"A wise man learns more from a foolish question than a fool can learn from a wise answer"
Image


Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Mon Jul 21, 2025 11:46 am  (#3) 
Offline
GimpChat Member

Joined: Jul 21, 2025
Posts: 24
Thank you very much for your reply — I really appreciate it.
Like you (and many others, it seems), I’ve decided to continue using GIMP 2.10 for now, mainly because of its full and stable support for Python plugins.

I’ll keep GIMP 3 installed to follow its development, but for all scripting purposes, I’ll stick with 2.10. Thanks again!


Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Mon Jul 21, 2025 1:22 pm  (#4) 
Offline
GimpChat Member

Joined: Apr 11, 2024
Posts: 298
You can still write python plug-ins. It's still fully supported.
But they must be Python3 now.
The API has changed completely, so plug-ins from 2.10 have to be rewritten.
A tutorial is here: https://testing.docs.gimp.org/3.0/en/gi ... orial.html
and here: https://testing.developer.gimp.org/reso ... al-python/
also here: https://medium.com/@kamilburda/how-to-w ... b81fc2c98d

Then ... each plug-in goes in its own sub-folder named like the plug-in without ending.
Linux/ Mac users have to make it executable.

So quite a lot of changes necessary.


Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Mon Jul 21, 2025 2:50 pm  (#5) 
Offline
GimpChat Member

Joined: Jul 21, 2025
Posts: 24
Thanks a lot for the clarification and the very useful links!
Yes, I now understand that Python 3 is supported in GIMP 3, but the API is completely different — and legacy gimpfu scripts require a full rewrite.

I tried rewriting one of my plugins using the new gi.repository.Gimp system, following the structure and async model, but unfortunately I couldn’t get it to run correctly despite placing it in its own folder, making it executable, and launching GIMP from terminal to check logs.

So for now, like many users, I’ve decided to keep using GIMP 2.10 for all my scripting needs, where everything still works reliably.
That said, I’ll keep watching the evolution of Python support in GIMP 3 — and I truly appreciate the resources you shared.

Thanks again!


Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Sat Sep 27, 2025 5:01 am  (#6) 
Offline
GimpChat Member

Joined: Jul 21, 2025
Posts: 24
Hello everyone,
I’m bringing up this post to ask if there are any updates regarding writing Python plugins for GIMP 3.0.4 on Mac. Thanks


Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Mon Nov 10, 2025 8:44 am  (#7) 
Offline
GimpChat Member

Joined: Jul 21, 2025
Posts: 24
Hi, any news for this problem? So far I don't see any update for Python 3 script under MacOs


Top
 Post subject: Re: Python scripts not working in GIMP 3.0.4 on macOS
PostPosted: Wed Feb 18, 2026 5:58 am  (#8) 
Offline
GimpChat Member

Joined: Jul 21, 2025
Posts: 24
Hi,
just to inform, in case somebody was interested in, that, thanks to Chat GPT, I was able to convert some scripts for GIMP 3.0.6 on Mac. Now they are correctly running on my Mac.
What i did is:
1. one script that add a Watermark to the current image in GIMP;
2. one script that add a Watermrk to a set of pictures in a directory;
3. one script that add reduce the long side to 1920, apply a little bit of Saturation, Contrast, Sharpness, and finally add the watermark to a set of pictures in a directory.

The last script is very useful whan I have a lot of pictures to publish or share with other people and I have not time to apply changes to them.


Top
Post new topic Reply to topic  [ 8 posts ] 

All times are UTC - 5 hours [ DST ]



* Login  



Powered by phpBB3 © phpBB Group