Skip to main content

The GIMP Plugin Installer command-line tool

Project description

# GIMP Plugin Installer

![Build Status](

Install GIMP plugins from the command line with a simple, easy to use package


Install from gpi-web:

$ gpi install imguruploader

Uninstall an installed package:
$ gpi uninstall imguruploader

Install from a locally downloaded file:
$ gpi install -f ~/imgur-uploader.tar.gz

Anatomy of a gpi package (aka how to package your plugin)

The root level of a gpi package requires two things: a ``gpi.json`` manifest
file, and a ``contents/`` directory. The ``contents/`` directory will be
extracted directly to the user's GIMP plugin directory, so make sure you only
include files necessary for your plugin. You can put other content, like a
LICENSE or CHANGELOG, in the root of the package. Files outside of ``contents/``
will be ignored.

Your ``gpi.json`` file should look like this:

"version": "0.1.0",
"name": "Imgur Uploader",
"identifier": "imguruploader",
"author": "tschuy",
"license": "MIT",
"url": "",
"description": "Upload your images to Imgur directly from the Save menu"
To test your plugin, pass your ``.tar.gz`` to gpi with the ``-f`` flag. Open
GIMP, and verify your plugin works as expected.

Testing gpi

Currently, ``gpi`` has no tests. This is a major issue and will be rectified as
soon as possible.


1. Remove empty folders on uninstall
2. Catch duplicate files and disallow uninstallation (or fix GIMP to allow recursive plugin finding)
3. Install plugins from git
4. Documentation
5. Code cleanup
6. Allow the use of a virtualenv to install packages from pip
7. Add verbose mode

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gpi, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size gpi-0.1.1-py2-none-any.whl (5.8 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size gpi-0.1.1.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page