How to install Python plugins under GIMP

Please read the comments – some important stuff may have shown up!

Linux – with GUI

Check that the packet gimp-python is installed.

Copy your .py file into the directory .gimp2.4/plug-ins (replace 2.4 with your GIMP version number, 2.6, 2.7, soon 2.8 or, to be future proof, 3.0 ;-)) . This is a hidden directory, you don’t see it in the file browser. With Nautilus you can toggle the display of the hidden files with Ctrl-H.

Then make the file executable by right clicking, selecting “Properties” from the menue and activate “Execute” in the permissions tab.

If GIMP was running, restart it.

Linux – with commandline

Check (with synaptic) that the packet gimp-python is installed.

Enter this:

cp myfile.py ~/.gimp2.4/plug-ins
chmod u+x ~/.gimp2.4/plug-ins/myfile.py

If GIMP was running, restart it.

Mac OS

Please write an instruction into the comments – I’ll pull it up to here.

Look through the comments for a solution – but I think there must be a better one.

EDIT by monoceros84: There is a new discussion going on in the forum. Have a look at: http://forum.meetthegimp.org/index.php/topic,227.0

Windows

Copy the files to ~/.gimp2.4/plug-ins

With the following prerequisites:

– PyGTK, PyCairo and PyGobject (all available from the GNOME FTP mirrors as installers) are installed prior to installing GIMP
– ~ is %USERPROFILE%

If GIMP was running, restart it.

26 thoughts on “How to install Python plugins under GIMP

  1. Microsoft Windows
    ——————–

    Copy the files to ~/.gimp2.4/plug-ins

    With the following prerequisites:

    – PyGTK, PyCairo and PyGobject (all available from the GNOME FTP mirrors as installers) are installed prior to installing GIMP
    – ~ is %USERPROFILE%

    Making them executable isn’t necessary, as all files are executable on Microsoft Windows.

  2. The same approach used for Linux works fine for me with MacOSX. But I had to create the .gimp2.4/plugins directory in my $HOME first, then I copied the plugin in this directory and made it executable. GIMP couldn’t find the plugin first, I had to provide the path to the just created directory in the preferences (Preferences -> Folders -> Plugins). Now it’s working like a charm. Maybe there is a more convenient way to install plugins for the GIMP on MacOSX, but this works fine for me and I don’t hesitate to fiddle with the terminal 😉

  3. MissM@rple: The reason you had to provide the path is because you didn’t use ~/.gimp-2.4/plug-ins/
    , which is the normal path that gimp looks at by default.

  4. @David: Thanks for the hint, but it didn’t make any difference to me. In my home didn’t exist any .gimp[whatsoever]/ directory so I had to create it anyway. The preset paths to have GIMP look for plugins where /<myuserhome/Library/Application Support/Gimp/plug-ins and /tmp/skl/Gimp.app/Contents/Resources/lib/gimp/2.0/plug-ins
    So maybe I should have put my plugins in the first mentioned directory but I feel more convenient to put it that way I mentioned in my first comment.

  5. @MissM@rple (and any other Mac users)

    – put the python script in the “normal” ‘plug-in’ folder (Home/~/Library/Application Support/Gimp/plug-ins)
    – open the terminal and ‘cd’ your way to that folder
    – make it executable with ‘chmod u+x [scriptname]’ – default name for this script is zoneadjust.py

    I”m not overly happy with command-line stuff in the terminal, although I’m a little better having played with Xubuntu on a eeePC, but I reckon if I can do it then anyone can …

    To make this a little easier – is there a way of making a script executable without using the terminal?

    • “open terminal and cd your way”

      1)
      you could have used drag n drop into terminal

      2)
      now you can use services “open terminal here”

  6. hy
    the python-gimp-pack for windows is now updated and works with last gimp 2.6.1, included the updated version of all the libraries listed by
    Michael Schumacher in his message

    But note

    1 for peculiar architecture (ie X86) may be better download a speciphic version of python 2.5.2 directly to the python side
    2 even if there is a more recent version of python ,2.6 that is not compatible
    you need python 2.5, last for win should be 2.5.2

    link for the pack remain the same :http:/photocomix-resources.deviantartart.com/gallery/

  7. Hi There,

    I’ve been trying to install plug-ins in Gimp. But I can’t find the Plug-ins folder. I tried Ctrl+H, but that too does not show the hidden folder. Any help?

    Lazybug

  8. Windows XP user: I’ve downloaded the plugin, installed at C:Program FilesGIMP-2.0libgimp2.0plug-ins – nothing happened

    Then, I downloaded the script and installed it at: C:Program FilesGIMP-2.0sharegimp2.0scripts
    Nothing happened.

    So I’ve downloaded the plugin, installed at C:Documents and Settingsaponstingl.gimp-2.6plug-ins – nothing happened.

    Finally, I downloaded the script and installed it at C:Documents and Settingsaponstingl.gimp-2.6scripts.

    Yep, nothing happened.

    any thoughts?

  9. Same problem with StraightenCrop.py in Win XP Home (SP3, fully patched) …
    It won’t run nor appear in any menu.

    >> PyGTK, PyCairo and PyGobject (all available from the GNOME FTP mirrors as installers) are installed prior to installing GIMP

    – “prior to installing GIMP” is a priori impossible. Does this mean that I have to deinstall and reinstall afterwards ??
    Is there no other way ?
    – Seems a lot of work for running a script …

  10. Pingback: A plugin to export layers in GIMP file to single pdf file | Ecostudies

  11. Pingback: InsaneBump GIMP Plugin Would Be Great For #SLMaterials If Only It Worked | Chameleonic Possessions

  12. Pingback: GIMP Plugin Day – 10/4/13 – LayerFx | The Linux Darkroom

  13. Pingback: Origami Fill | Arpit Sheth

  14. Install GIMP Plugins on a Mac OS:
    1) ‘Right Click’ on the GIMP application in your Finder (I know you can’t really ‘right click’ but you can use Ctrl Click, or a two-finger tap on your trackpad to achieve the same effect.) This should give you the option to “Show Package Contents”.
    2) Go to Contents > Resources > lib > gimp > 2.0 > plug-ins.
    3) Drag the unpacked plugin file into the plug-ins folder.
    4) Restart GIMP so that it recognizes the plugin you just installed

    http://pareandfocus.com/index.htm/how-to-install-gimp-plugins/

    • NO!! DO NOT follow simdude’s directions. Add to GIMP from your respective user’s folder.

      Open a finder window.

      Click menu “go”, “go to folder”

      ~/Library/Application Support/GIMP

      The tilde is important. It means “start from my user folder and go deeper so I can use it with any user I’m logged in as”

      Pick the current version number. Right now that is 2.8

      Open the plug-ins folder (directory) under 2.8

      Or Go to folder:

      ~/Library/Application Support/GIMP/2.8/plug-ins

      If python files (extension py) also make executable:

      System preferences
      Keyboard
      Shortcuts
      Services

      enable: New Terminal at Folder

      right-click on plug-ins (in finder)

      context menu: services: New Terminal at Folder

      a terminal window will open. You will enter:

      chmod +x *.py

      — now (re)start GIMP

      for best tinkering results also install G’MIC 😉

Anything to add from your side of the computer?