Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
GIMP(1)			       GIMP Manual Pages		       GIMP(1)

       gimp - an image manipulation and	paint program.

       gimp  [-h]  [--help]  [--help-all] [--help-gtk] [-v] [--version]	[--li-
       cense] [--verbose] [-n] [--new-instance]	[-a] [--as-new]	[-i] [--no-in-
       terface]	  [-d]	 [--no-data]   [-f]  [--no-fonts]  [-s]	 [--no-splash]
       [--no-shm] [--no-cpu-accel] [--display display] [--session _name_] [-g]
       [--gimprc  _gimprc_] [--system-gimprc _gimprc_] [--dump-gimprc] [--con-
       sole-messages]	 [--debug-handlers]    [--stack-trace-mode     _mode_]
       [--pdb-compat-mode   _mode_]   [--batch-interpreter  _procedure_]  [-b]
       [--batch	_command_] [filename] ...

       GIMP is the GNU Image Manipulation Program. It is used to edit and  ma-
       nipulate	 images.  It  can load and save	a variety of image formats and
       can be used to convert between formats.

       GIMP can	also be	used as	a paint	program. It features a set of  drawing
       and  painting  tools  such as airbrush, clone, pencil, and paint	brush.
       Painting	and drawing tools can be applied to an image with a variety of
       paint modes.  It	also offers an extensive array of selection tools like
       rectangle, ellipse, fuzzy select, bezier	select,	intelligent  scissors,
       and select by color.

       GIMP  offers  a variety of plug-ins that	perform	a variety of image ma-
       nipulations.  Examples include bumpmap, edge detect, gaussian blur, and
       many  others.  In addition, GIMP	has several scripting extensions which
       allow for advanced non-interactive processing and creation of images.

       GIMP ships with a second	binary called gimp-console. This binary	 is  a
       console-only  version  and  behaves  as	if  gimp  was  called with the
       --no-interface command-line option.

       On platforms with the D-Bus message bus system, GIMP  will  by  default
       check if	an instance is already running in this user session. If	it de-
       tects that, it will pass	all filenames given on the command-line	to the
       already running GIMP instance and quit.

       GIMP accepts the	following options:

       -h, --help
	       Show GIMP command-line options.

	       Show all	command-line options.

	       Show GTK+ command-line options.

	       Show GEGL command-line options.

       -v, --version
	       Output  version	information  and  exit.	When combined with the
	       --verbose option, version information about libraries  used  by
	       GIMP is shown as	well.

	       Output license information and exit.

	       Be verbose and create information on standard output.

       -n, --new-instance
	       Do  not	attempt	to reuse an already running GIMP instance. Al-
	       ways start a new	one.

       -a, --as-new
	       Open filenames passed on	the command-line as new	images,	 don't
	       set the filename	on them.

       -i, --no-interface
	       Run without a user interface.

       -d, --no-data
	       Do  not	load  patterns,	gradients, palettes, or	brushes. Often
	       useful in non-interactive situations where startup time	is  to
	       be minimized.

       -f, --no-fonts
	       Do  not load any	fonts. No text functionality will be available
	       if this option is used.

       --display display
	       Use the designated X display.

       -s, --no-splash
	       Do not show the splash screen.

	       Do not use shared memory	between	GIMP and  its  plug-ins.   In-
	       stead of	using shared memory, GIMP will send the	data via pipe.
	       This will result	in slower performance than using  shared  mem-

	       Do  not	use  CPU accelerations such as MMX or SSE even if GIMP
	       detects that your CPU provides this functionality.

       --session _name_
	       Use a different sessionrc for this GIMP session.	The given ses-
	       sion name is appended to	the default sessionrc filename.

       -g, --gimprc _gimprc_
	       Use an alternative gimprc instead of the	default	one. Useful in
	       cases where plug-in paths or machine specs may be different.

       --system-gimprc _gimprc_
	       Use an alternate	system gimprc file.

	       Output a	gimprc file with default settings.

	       Enable debugging	signal handlers.

       -c, --console-messages
	       Do not popup dialog boxes on errors or warnings.	Print the mes-
	       sages on	the console instead.

       --stack-trace-mode {never|query|always}
	       If a stack-trace	should be generated in case of fatal signals.

       --pdb-compat-mode {off|on|warn}
	       If the PDB should provide aliases for deprecated	functions.

       --batch-interpreter _procedure_
	       Specifies the procedure to use to process batch events. The de-
	       fault is	to let Script-Fu evaluate the commands.

       -b, --batch _command_
	       Execute _command_ non-interactively.  This  option  may	appear
	       multiple	 times.	  The  _command_ is passed to the batch	inter-
	       preter. When _command_ is - the commands	are read from standard

       GIMP respects a number of environment variables.

       DISPLAY to get the default host and display number.

	       to  get	the  name  of  the  personal  GIMP directory. If unset
	       $XDG_CONFIG_HOME/GIMP/2.10 is used.  If	this  is  an  absolute
	       path,  it is used as is.	 If it is a relative path, it is taken
	       to be a subdirectory of $XDG_CONFIG_HOME.

	       to get the base location	for data files	such  as  brushes  and
	       patterns.  If unset ${datarootdir}/gimp is used.

	       to get the base location	for translations. If unset ${dataroot-
	       dir}/locale is used.

	       to get the base location	for plug-ins  and  modules.  If	 unset
	       ${exec_prefix}/libexec/gimp/2.2 is used.

	       to  get	the  location  of configuration	files. If unset	${pre-
	       fix}/etc/gimp/2.2 is used.

	       to get the location for caches files. If	unset the  system  de-
	       fault for per-user cached files is used.

	       to get the location of temporary	files. If unset	the system de-
	       fault for temporary files is used.

	       On Linux	GIMP can be compiled with support for binary relocati-
	       bility.	This will cause	data, plug-ins and configuration files
	       to be searched relative to the location of the gimp  executable
	       file  unless  overridden	by the environment variables mentioned

       GIMP's data files are stored in ${datarootdir}/gimp, where  ${dataroot-
       dir} is set on install, but is typically	/usr/share. GIMP's system-wide
       configuration files are stored in ${prefix}/etc/gimp/2.2, where	${pre-
       fix} is typically /usr.

       Most GIMP configuration is read in from the user's init file, $XDG_CON-
       FIG_HOME/GIMP/2.10/gimprc. The system  wide  equivalent	is  in	${pre-
       fix}/etc/gimp/2.2/gimprc.  The system wide file is parsed first and the
       user   gimprc   can   override	 the	system	  settings.	${pre-
       fix}/etc/gimp/2.2/gimprc_user  is  the  default gimprc placed in	users'
       home directories	the first time GIMP is run.

       $XDG_CONFIG_HOME/GIMP/2.10/devicerc - holds settings for	input  devices
       together	 with the tool,	colors,	brush, pattern and gradient associated
       to that device.

       $XDG_CONFIG_HOME/GIMP/2.10/gtkrc	- users	set of GIMP-specific GTK+ con-
       fig  settings.  Options such as widget color and	fonts sizes can	be set

       ${prefix}/etc/gimp/2.2/gtkrc - system wide default set of GIMP-specific
       GTK+ config settings.

       $XDG_CONFIG_HOME/GIMP/2.10/menurc - user's set of keybindings.

       $XDG_CONFIG_HOME/GIMP/2.10/parasiterc - Stores all persistent GIMP par-
       asites. This file will be rewritten every time you quit GIMP.

       $XDG_CONFIG_HOME/GIMP/2.10/sessionrc - This file	takes session-specific
       info  (that  is	info, you want to keep between two GIMP	sessions). You
       are not supposed	to edit	it manually, but of course you	can  do.  This
       file  will be entirely rewritten	every time you quit GIMP. If this file
       isn't found, defaults are used.

       $XDG_CONFIG_HOME/GIMP/2.10/templaterc - Image  templates	 are  kept  in
       this file. New images can conveniently created from these templates. If
       this file isn't found, defaults are used.

       ${prefix}/etc/gimp/2.2/unitrc - default user unit database. It contains
       the  unit definitions for centimeters, meters, feet, yards, typographic
       points and typographic picas and	is placed in  users  home  directories
       the  first  time	 GIMP  is  ran.	If this	file isn't found, defaults are

       $XDG_CONFIG_HOME/GIMP/2.10/unitrc - This	file contains your  user  unit
       database.  You  can  modify this	list with the unit editor. You are not
       supposed	to edit	it manually, but of course you can do.	This file will
       be entirely rewritten every time	you quit GIMP.

       $XDG_CONFIG_HOME/GIMP/2.10/plug-ins  - location of user installed plug-

       $XDG_CONFIG_HOME/GIMP/2.10/pluginrc - plug-in initialization values are
       stored here. This file is parsed	on startup and regenerated if need be.

       $XDG_CONFIG_HOME/GIMP/2.10/modules  -  location	of user	installed mod-

       $XDG_CONFIG_HOME/GIMP/2.10/tmp -	default	location  that	GIMP  uses  as
       temporary space.

       ${datarootdir}/gimp/brushes - system wide brush files.

       $XDG_CONFIG_HOME/GIMP/2.10/brushes  -  user created and installed brush
       files. These files are in the .gbr, .gih	or .vbr	file formats.

       $XDG_CONFIG_HOME/GIMP/2.10/curves - Curve profiles and presets as saved
       from the	Curves tool.

       $XDG_CONFIG_HOME/GIMP/2.10/gimpressionist  -  Presets  and user created
       brushes and papers are stored here.

       $XDG_CONFIG_HOME/GIMP/2.10/levels - Level profiles and presets as saved
       from the	Levels tool.

       ${datarootdir}/gimp/palettes - the system wide palette files.

       $XDG_CONFIG_HOME/GIMP/2.10/palettes - user created and modified palette
       files. This files are in	the .gpl format.

       ${datarootdir}/gimp/patterns - basic set	of patterns for	use in GIMP.

       $XDG_CONFIG_HOME/GIMP/2.10/patterns - user created and  installed  gimp
       pattern files. This files are in	the .pat format.

       ${datarootdir}/gimp/gradients  -	 standard  system wide set of gradient

       $XDG_CONFIG_HOME/GIMP/2.10/gradients - user created and installed  gra-
       dient files.

       ${datarootdir}/gimp/scripts  - system wide directory of scripts used in
       Script-Fu and other scripting extensions.

       $XDG_CONFIG_HOME/GIMP/2.10/scripts  -  user   created   and   installed

       ${datarootdir}/gimp/gflares  - system wide directory used by the	gflare

       $XDG_CONFIG_HOME/GIMP/2.10/gflares - user created and installed	gflare

       ${datarootdir}/gimp/gfig	- system wide directory	used by	the gfig plug-

       $XDG_CONFIG_HOME/GIMP/2.10/gfig	-  user	 created  and  installed  gfig

       ${datarootdir}/gimp/images/gimp-splash.png - the	default	image used for
       the GIMP	splash screen.

       ${datarootdir}/gimp/images/gimp-logo.png	- image	used in	the GIMP about

       ${datarootdir}/gimp/tips/gimp-tips.xml  - tips as displayed in the "Tip
       of the Day" dialog box.

       GIMP comes with a default image for the splash  screen  but  it	allows
       system  administrators and users	to customize the splash	screen by pro-
       viding other images. The	image to be used with  the  splash  screen  is
       chosen as follows:

       1.     GIMP  tries  to  load  a random splash screen from the directory

       2.     It     then     falls	back	  to	  using	     $XDG_CON-

       3.     If  the  user  didn't install any	custom splash images, a	random
	      image is picked from ${datarootdir}/gimp/splashes.

       4.     As a last	resort,	GIMP uses the default splash image located  at

       Any  bugs  found	 should	 be reported to	the online bug-tracking	system
       available on the	web at Be-
       fore  reporting	bugs,  please check to see if the bug has already been

       When reporting GIMP bugs, it is important to include a reliable way  to
       reproduce  the bug, version number of GIMP (and probably	GTK+), OS name
       and version, and	any relevant hardware specs. If	a  bug	is  causing  a
       crash,  it  is  very  useful  if	 a stack trace can be provided.	And of
       course, patches to rectify the bug are even better.

       The canonical place to find  GIMP  info	is  at
       Here you	can find links to just about many other	GIMP sites, tutorials,
       data sets, mailing list archives, and more.

       There is	also a GIMP User Manual	 available  at
       that goes into much more	detail about the interactive use of GIMP.

       The  latest  versions of	GIMP and the GTK+ libs are always available at

       Spencer Kimball,	Peter Mattis and the GIMP Development Team.

       With patches, fixes, plug-ins, extensions, scripts, translations, docu-
       mentation and more from lots and	lots of	people all over	the world.

       gimprc(5), gimptool(1),

Version	2.10.20			 March 23 2008			       GIMP(1)


Want to link to this manual page? Use this URL:

home | help