Custom Keyboard Shortcuts for GIMP Scripts

Assigning custom keyboard shortcuts to third-party scripts in GIMP streamlines your graphic design workflow by giving you one-touch access to your most frequently used automated tasks and plugins. This guide details the step-by-step process of installing a third-party script, locating it within GIMP's shortcut management interface, assigning a unique key combination, and saving your preferences for future editing sessions.

Step 1: Install and Verify the Third-Party Script

Before setting a shortcut, make sure GIMP recognizes your script or plugin:

  1. Place your script file (.scm for Script-Fu or .py for Python-Fu) in GIMP’s designated directory:
    • Scripts: Preferences > Folders > Scripts
    • Plug-ins: Preferences > Folders > Plug-ins
  2. Restart GIMP or reload scripts by navigating to Filters > Script-Fu > Refresh Scripts.
  3. Verify that the script appears in its designated menu location (such as Filters, Image, Layer, or Tools).

Step 2: Open the Keyboard Shortcuts Editor

  1. Click on Edit in the top menu bar.
  2. Select Keyboard Shortcuts from the drop-down menu to open the Configure Keyboard Shortcuts dialog window.

Step 3: Locate Your Custom Script

  1. In the search bar at the bottom of the dialog, type the exact name of the third-party script.
  2. Alternatively, expand the menu tree categories (e.g., Filters, Layer) in the central list to locate the script manually based on where it appears in your GIMP interface.

Step 4: Assign the Key Combination

  1. Click directly on the row containing your script name, specifically targeting the Shortcut column (which usually displays Disabled by default).
  2. The text will change to New accelerator....
  3. Press the key combination you wish to use on your keyboard (for example, Ctrl + Shift + Q or Alt + K).
  4. If the key combination is already used by another action, GIMP will prompt you to reassign it or choose a different combination.

Step 5: Save and Test

  1. Click the Save button (or ensure Save keyboard shortcuts on exit is checked in your main preferences).
  2. Click Close to exit the shortcut editor.
  3. Open an active canvas and press your new key combination to verify that the script executes properly.