Installation

Requirements

Batcher requires GIMP 3.0.0 or later.

On Windows, if you downloaded GIMP 3 before March 19, 2025, you will need to update GIMP (or download and install GIMP again if GIMP does not offer an update). There was originally an issue that prevented several plug-ins, including Batcher, from working.

If you installed GIMP from an unofficial source (i.e. outside gimp.org), you might need to install Python 3.7 or later separately.

Download

Batcher can currently be installed only manually by copying files from a ZIP archive.

Download latest release (1.0.2, April 01, 2025)

Windows

If you downloaded GIMP 3 before March 19, 2025, you will need to update GIMP (or download and install GIMP again if GIMP does not offer an update). There was originally an issue that prevented several plug-ins, including Batcher, from working.
If you installed GIMP from gimp.org, make sure you enabled support for Python plug-ins (this is checked by default). The Microsoft Store version of GIMP enables Python support automatically.
Locate the folder containing GIMP plug-ins - open GIMP and go to Edit → Preferences → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.
Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:
```
 plug-ins/
     ...other plug-in folders...
     batcher/
         ...other Batcher files and folders...
         batcher.py
```
If you have GIMP opened, you must restart GIMP.

Linux

Flatpak installation

Open GIMP, go to Edit → Preferences → Folders → Plug-Ins and add a custom folder. While there are existing folders where you can insert plug-ins, these may or may not work.
Copy the batcher folder from the downloaded archive to the folder created in the previous step. The folder hierarchy should look like this:
```
 plug-ins/
     ...other plug-in folders...
     batcher/
         ...other Batcher files and folders...
         batcher.py
```
If you have GIMP opened, you must restart GIMP.

AppImage and other installers

Locate the folder containing GIMP plug-ins - open GIMP and go to Edit → Preferences → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.
Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:
```
 plug-ins/
     ...other plug-in folders...
     batcher/
         ...other Batcher files and folders...
         batcher.py
```
If you have GIMP opened, you must restart GIMP.

macOS

Locate the folder containing GIMP plug-ins - open GIMP and go to Edit → Preferences → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.
Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:
```
 plug-ins/
     ...other plug-in folders...
     batcher/
         ...other Batcher files and folders...
         batcher.py
```
If you have GIMP opened, you must restart GIMP.