GIMP Plugin Installer
Install GIMP plugins from the command line with a simple, easy to use package manager.
Usage
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": "https://github.com/tschuy/gimp-export-to-imgur",
"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.
Issues
- Remove empty folders on uninstall
- Catch duplicate files and disallow uninstallation (or fix GIMP to allow recursive plugin finding)
- Install plugins from git
- Documentation
- Code cleanup
- Allow the use of a virtualenv to install packages from pip
- Add verbose mode