GIMP-REMOTESection: GIMP Manual Pages (1)
Updated: Januar 23 2007
Index Return to Main Contents
NAMEgimp-remote - tells a running GIMP to open a (local or remote) image file.
SYNOPSISgimp-remote [-h] [--help] [-v] [--version] [--display display] [-e] [--existing] [-q] [--query] [-s] [--no-splash] [-p] [--print-xid] filename ...
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 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.
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.
If you are using GIMP on Linux or another platform with the D-Bus message bus system, chances are good that this functionality is already built into the main GIMP executable and that you will not need to use gimp-remote.
OPTIONSgimp-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.
- -p, --print-xid
- Like -q, but print the X Window ID of the toolbox window if GIMP is already running. If no such window exists nothing is printed.
- -s, --no-splash
When starting GIMP, do not show the splash screen.
- 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.
to get the default host and display number.
AUTHORSSven Neumann and Simon Budig.
SEE ALSOgimp(1), gimprc(5), gimptool(1)