GIMP-REMOTE(1)

NAME
gimp-remote - tells a running GIMP to open a (local or remote) image file.

SYNOPSIS
gimp-remote [-h] [--help] [-v] [--version] [-n] [--new] filename...

DESCRIPTION

gimp-remote is a small utility that tells a running GIMP to open a (local or remote) image file. It does so by searching for a GIMP toolbox on the active display. If it can find a GIMP toolbox, a synthetic drop event is created which makes GIMP think the files would have been dropped onto the toolbox. More than one filename or URL can be specified on the commandline.

OPTIONS
gimp-remote accepts the following options:

-h, --help
    Display a list of all commandline options.

-v, --version
    Output the version info.

-n, --new
    If no running GIMP is found, a new instance of GIMP is started. The files to open are passed to the new GIMP.

EXAMPLES

gimp-remote http://www.gimp.org/icons/frontpage-small.gif
    Loads the image from the GIMP website into a running GIMP.

gimp-remote -n wilber.xcf  wilma.xcf
    Loads the local files wilber.xcf and wilma.xcf into a running GIMP. If no GIMP is running, a new one is started.

ENVIRONMENT

DISPLAY
    to get the default host and display number.

AUTHORS
Sven Neumann and Simon Budig.

SEE ALSO
gimp(1), gimprc(5), gimptool(1)