Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

The GIMP Plugin Installer command-line tool

Project description

# GIMP Plugin Installer

![Build Status](https://travis-ci.org/tschuy/gpi.svg)

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
------

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


Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
gpi-0.1.1-py2-none-any.whl (5.8 kB) Copy SHA256 hash SHA256 Wheel py2 Jun 21, 2015
gpi-0.1.1.tar.gz (3.4 kB) Copy SHA256 hash SHA256 Source None Jun 21, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page