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] [-p] [--print-xid] 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  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 func-
     tionality is already built into the main GIMP executable and
     that you will not need to use gimp-remote.



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



Version 2.4.6      Last change: Januar 23 2007                  1






GIMP Manual Pages                                  GIMP-REMOTE(1)



             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.



EXAMPLES
     gimp-remote http:/www.gimp.org/images/wilberthegimp.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 ALSO
     gimp(1), gimprc(5), gimptool(1)


















Version 2.4.6      Last change: Januar 23 2007                  2