gimp-remote(1)

1GIMP-REMOTE(1)                 GIMP Manual Pages                GIMP-REMOTE(1)
2
3
4

NAME

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

SYNOPSIS

10       gimp-remote [-h] [--help] [-v]  [--version]  [--display  display]  [-e]
11       [--existing]  [-q]  [--query]   [-s]  [--no-splash]  [-p] [--print-xid]
12       filename ...
13
14
15

DESCRIPTION

17       gimp-remote is a small utility that tells a running GIMP to open one or
18       more (local or remote) image files.  It does so by searching for a GIMP
19       toolbox on the active display.  If it can find a GIMP toolbox,  a  syn‐
20       thetic  drop  event  is  created which makes GIMP think the files would
21       have been dropped onto the toolbox. More than one filename or  URL  can
22       be specified on the commandline.
23
24
25       If  no GIMP window is found, gimp-remote will start a new GIMP instance
26       and ask it to load the specified images.  If  no  filename  or  URL  is
27       given, gimp-remote will start a new GIMP. This behaviour can be altered
28       using the command-line options described below.
29
30
31       If you are using GIMP on Linux or another platform with the D-Bus  mes‐
32       sage  bus  system,  chances are good that this functionality is already
33       built into the main GIMP executable and that you will not need  to  use
34       gimp-remote.
35
36
37

OPTIONS

39       gimp-remote accepts the following options:
40
41       -h, --help
42               Display a list of all commandline options.
43
44       -v, --version
45               Output the version info.
46
47       --display display
48               Use the designated X display.
49
50       -e, --existing
51               If no running GIMP instance is found, don't start a new one but
52               exit.
53
54       -q, --query
55               Check if GIMP is running and exit. A status code of 0 indicates
56               that a GIMP toolbox window has been found on this display.
57
58       -p, --print-xid
59               Like  -q,  but  print  the X Window ID of the toolbox window if
60               GIMP is already running. If no such window  exists  nothing  is
61               printed.
62
63       -s, --no-splash
64               When starting GIMP, do not show the splash screen.
65
66
67

EXAMPLES

69       gimp-remote http://www.gimp.org/images/wilber_the_gimp.png
70              Loads  the  image  from  the GIMP website into a running GIMP or
71              starts a new one.
72
73       gimp-remote wilber.xcf wilma.xcf
74              Loads the local files wilber.xcf and wilma.xcf  into  a  running
75              GIMP or starts a new one.
76
77
78

ENVIRONMENT

80       DISPLAY to get the default host and display number.
81
82
83

AUTHORS

85       Sven Neumann and Simon Budig.
86
87
88