Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   26626 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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]  [-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  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.

       If you are using GIMP on Linux or another platform with the D-Bus  mes‐
       sage  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.

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.

       -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/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 ALSO
       gimp(1), gimprc(5), gimptool(1)

Version 2.6.9			Januar 23 2007			GIMP-REMOTE(1)

Vote for polarhome