GIMP-REMOTE(1) GIMP Manual Pages 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] [--display display] [-e]
[--existing] [-q] [--query] [-s] [--no-splash] filename ...
DESCRIPTION
gimp-remote is a small utility that tells a running GIMP to open one or
more (local or remote) image files. It does so by searching for a GIMP
toolbox on the active display. If it can find a GIMP toolbox, a syn‐
thetic 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.
If no GIMP window is found, gimp-remote will start a new GIMP instance
and ask it to load the specified images. If no filename or URL is
given, gimp-remote will start a new GIMP. This behaviour can be altered
using the command-line options described below.
OPTIONS
gimp-remote accepts the following options:
-h, --help
Display a list of all commandline options.
-v, --version
Output the version info.
--display display
Use the designated X display.
-e, --existing
If no running GIMP instance is found, don't start a new one but
exit.
-q, --query
Check if GIMP is running and exit. A status code of 0 indicates
that a GIMP toolbox window has been found on this display.
-s, --no-splash
When starting GIMP, do not show the splash screen.
EXAMPLES
gimp-remote http://www.gimp.org/images/wilber_the_gimp.png
Loads the image from the GIMP website into a running GIMP or
starts a new one.
gimp-remote wilber.xcf wilma.xcf
Loads the local files wilber.xcf and wilma.xcf into a running
GIMP or starts a new one.
ENVIRONMENT
DISPLAY to get the default host and display number.
AUTHORS
Sven Neumann and Simon Budig.
SEE ALSOgimp(1), gimprc(5), gimptool(1)Version 2.3.10 March 23 2004 GIMP-REMOTE(1)