1
2GIMPRC(5)                     File Formats Manual                    GIMPRC(5)
3
4
5

NAME

7       gimprc - gimp configuration file
8

DESCRIPTION

10       The gimprc file is a configuration file read by GIMP when it starts up.
11       There   are   two   of   these:   one   system-wide   one   stored   in
12       /etc/gimp/2.0/gimprc  and  a per-user $XDG_CONFIG_HOME/GIMP/2.10/gimprc
13       which may override system settings.
14
15       Comments are introduced by a hash sign (#), and continue until the  end
16       of the line.  Blank lines are ignored.
17
18       The  gimprc  file  associates values with properties.  These properties
19       may be set by lisp-like assignments of the form:
20
21              (property-name value)
22
23       where:
24
25       property-name
26                 is one of the property names described below.
27
28       value     is the value the property is to be set to.
29
30       Either spaces or tabs may be used to separate the name from the value.
31

PROPERTIES

33       Valid properties and their default values are:
34
35
36       (temp-path "${gimp_temp_dir}")
37
38              Sets the folder for temporary storage. Files  will  appear  here
39              during  the  course  of running GIMP.  Most files will disappear
40              when GIMP exits, but some files are likely to remain, so  it  is
41              best  if  this  folder not be one that is shared by other users.
42              This is a single folder.
43
44
45       (swap-path "${gimp_cache_dir}")
46
47              Sets the swap file location. GIMP uses a tile based memory allo‐
48              cation scheme.  The swap file is used to quickly and easily swap
49              tiles out to disk and back in. Be aware that the swap  file  can
50              easily  get  very large if GIMP is used with large images. Also,
51              things can get horribly slow if the swap file is  created  on  a
52              folder  that  is mounted over NFS.  For these reasons, it may be
53              desirable to put your swap file in "/tmp".   This  is  a  single
54              folder.
55
56
57       (num-processors 1)
58
59              Sets  how  many threads GIMP should use for operations that sup‐
60              port it.  This is an integer value.
61
62
63       (tile-cache-size 2g)
64
65              When the amount of pixel data  exceeds  this  limit,  GIMP  will
66              start  to swap tiles to disk.  This is a lot slower but it makes
67              it possible to work on images that wouldn't fit into memory oth‐
68              erwise.  If you have a lot of RAM, you may want to set this to a
69              higher value.  The integer size can contain  a  suffix  of  'B',
70              'K',  'M'  or  'G'  which makes GIMP interpret the size as being
71              specified in bytes, kilobytes, megabytes  or  gigabytes.  If  no
72              suffix  is  specified  the  size  defaults to being specified in
73              kilobytes.
74
75
76       (use-opencl no)
77
78              When enabled, uses OpenCL for some operations.  Possible  values
79              are yes and no.
80
81
82
83       Specifies the language to use for the user interface.  This is a string
84       value.
85
86
87       (interpolation-type cubic)
88
89              Sets the level of  interpolation  used  for  scaling  and  other
90              transformations.   Possible  values  are  none,  linear,  cubic,
91              nohalo and lohalo.
92
93
94       (default-threshold 15)
95
96              Tools such as fuzzy-select and bucket fill find regions based on
97              a  seed-fill  algorithm.   The seed fill starts at the initially
98              selected pixel and progresses in all directions until  the  dif‐
99              ference  of  pixel intensity from the original is greater than a
100              specified threshold. This value represents the  default  thresh‐
101              old.  This is an integer value.
102
103
104       (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")
105
106              Sets the plug-in search path.  This is a colon-separated list of
107              folders to search.
108
109
110       (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")
111
112              Sets the module search path.  This is a colon-separated list  of
113              folders to search.
114
115
116       (interpreter-path  "${gimp_dir}/interpreters:${gimp_plug_in_dir}/inter‐
117       preters")
118
119              Sets the interpreter search path.   This  is  a  colon-separated
120              list of folders to search.
121
122
123       (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")
124
125              Sets the environ search path.  This is a colon-separated list of
126              folders to search.
127
128
129       (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")
130
131              Sets the brush search path.  This is a colon-separated  list  of
132              folders to search.
133
134
135       (brush-path-writable "${gimp_dir}/brushes")
136
137              This is a colon-separated list of folders to search.
138
139
140       (dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")
141
142              Sets  the  dynamics search path.  This is a colon-separated list
143              of folders to search.
144
145
146       (dynamics-path-writable "${gimp_dir}/dynamics")
147
148              This is a colon-separated list of folders to search.
149
150
151       (mypaint-brush-path                                "/usr/share/mypaint-
152       data/1.0/brushes:~/.mypaint/brushes")
153
154              Sets  the  brush search path.  This is a colon-separated list of
155              folders to search.
156
157
158       (mypaint-brush-path-writable "~/.mypaint/brushes")
159
160              This is a colon-separated list of folders to search.
161
162
163       (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")
164
165              Sets the pattern search path.  This is a colon-separated list of
166              folders to search.
167
168
169       (pattern-path-writable "${gimp_dir}/patterns")
170
171              This is a colon-separated list of folders to search.
172
173
174       (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")
175
176              Sets the palette search path.  This is a colon-separated list of
177              folders to search.
178
179
180       (palette-path-writable "${gimp_dir}/palettes")
181
182              This is a colon-separated list of folders to search.
183
184
185       (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")
186
187              Sets the gradient search path.  This is a  colon-separated  list
188              of folders to search.
189
190
191       (gradient-path-writable "${gimp_dir}/gradients")
192
193              This is a colon-separated list of folders to search.
194
195
196       (tool-preset-path  "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-pre‐
197       sets")
198
199              Sets the dynamics search path.  This is a  colon-separated  list
200              of folders to search.
201
202
203       (tool-preset-path-writable "${gimp_dir}/tool-presets")
204
205              This is a colon-separated list of folders to search.
206
207
208       (font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")
209
210              Where to look for fonts in addition to the system-wide installed
211              fonts.  This is a colon-separated list of folders to search.
212
213
214       (default-brush "2. Hardness 050")
215
216              Specify a default brush.  The brush is searched for in the spec‐
217              ified brush path.  This is a string value.
218
219
220       (default-dynamics "Dynamics Off")
221
222              Specify a default dynamics.  The dynamics is searched for in the
223              specified dynamics path.  This is a string value.
224
225
226       (default-mypaint-brush "Fixme")
227
228              Specify a default MyPaint brush.  This is a string value.
229
230
231       (default-pattern "Pine")
232
233              Specify a default pattern.  This is a string value.
234
235
236       (default-palette "Default")
237
238              Specify a default palette.  This is a string value.
239
240
241       (default-gradient "FG to BG (RGB)")
242
243              Specify a default gradient.  This is a string value.
244
245
246       (default-tool-preset "Current Options")
247
248              Specify a default tool preset.  The tool preset is searched  for
249              in the specified tool prests path.  This is a string value.
250
251
252       (default-font "Sans-serif")
253
254              Specify a default font.  This is a string value.
255
256
257       (global-brush yes)
258
259              When  enabled,  the  selected  brush will be used for all tools.
260              Possible values are yes and no.
261
262
263       (global-dynamics yes)
264
265              When enabled, the selected dynamics will be used for all  tools.
266              Possible values are yes and no.
267
268
269       (global-pattern yes)
270
271              When  enabled,  the selected pattern will be used for all tools.
272              Possible values are yes and no.
273
274
275       (global-palette yes)
276
277              When enabled, the selected palette will be used for  all  tools.
278              Possible values are yes and no.
279
280
281       (global-gradient yes)
282
283              When  enabled, the selected gradient will be used for all tools.
284              Possible values are yes and no.
285
286
287       (global-font yes)
288
289              When enabled, the selected font will  be  used  for  all  tools.
290              Possible values are yes and no.
291
292
293       (default-image
294                  (width 1920)
295                  (height 1080)
296                  (unit pixels)
297                  (xresolution 300.000000)
298                  (yresolution 300.000000)
299                  (resolution-unit inches)
300                  (image-type rgb)
301                  (precision u8-gamma)
302                  (color-managed yes)
303                  (color-profile NULL)
304                  (fill-type background)
305                  (comment "Created with GIMP"))
306
307              Sets  the  default  image  in  the "File/New" dialog.  This is a
308              parameter list.
309
310
311       (default-grid
312                  (style solid)
313                  (fgcolor (color-rgba 0.000000 0.000000 0.000000 1.000000))
314                  (bgcolor (color-rgba 1.000000 1.000000 1.000000 1.000000))
315                  (xspacing 10.000000)
316                  (yspacing 10.000000)
317                  (spacing-unit inches)
318                  (xoffset 0.000000)
319                  (yoffset 0.000000)
320                  (offset-unit inches))
321
322              Specify a default image grid.  This is a parameter list.
323
324
325       (undo-levels 5)
326
327              Sets the minimal number of operations that can be  undone.  More
328              undo  levels  are  kept  available  until the undo-size limit is
329              reached.  This is an integer value.
330
331
332       (undo-size 1g)
333
334              Sets an upper limit to the memory that is used per image to keep
335              operations  on  the  undo  stack. Regardless of this setting, at
336              least as many undo-levels as  configured  can  be  undone.   The
337              integer  size can contain a suffix of 'B', 'K', 'M' or 'G' which
338              makes GIMP interpret the size as being specified in bytes, kilo‐
339              bytes,  megabytes  or  gigabytes.  If no suffix is specified the
340              size defaults to being specified in kilobytes.
341
342
343       (undo-preview-size large)
344
345              Sets the size of the previews in  the  Undo  History.   Possible
346              values are tiny, extra-small, small, medium, large, extra-large,
347              huge, enormous and gigantic.
348
349
350       (plug-in-history-size 10)
351
352              How many recently used filters and plug-ins to keep on the  Fil‐
353              ters menu.  This is an integer value.
354
355
356       (pluginrc-path "${gimp_dir}/pluginrc")
357
358              Sets the pluginrc search path.  This is a single filename.
359
360
361       (layer-previews yes)
362
363              Sets whether GIMP should create previews of layers and channels.
364              Previews in the layers and channels dialog are nice to have  but
365              they  can slow things down when working with large images.  Pos‐
366              sible values are yes and no.
367
368
369       (group-layer-previews yes)
370
371              Sets whether GIMP should create previews of layer groups.  Layer
372              group  previews are more expensive than ordinary layer previews.
373              Possible values are yes and no.
374
375
376       (layer-preview-size medium)
377
378              Sets the preview size used for layers and  channel  previews  in
379              newly  created  dialogs.  Possible values are tiny, extra-small,
380              small, medium, large, extra-large, huge, enormous and gigantic.
381
382
383       (thumbnail-size normal)
384
385              Sets the size of the thumbnail shown in the Open dialog.  Possi‐
386              ble values are none, normal and large.
387
388
389       (thumbnail-filesize-limit 4M)
390
391              The  thumbnail  in the Open dialog will be automatically updated
392              if the file being previewed is smaller than the size  set  here.
393              The  integer  size  can contain a suffix of 'B', 'K', 'M' or 'G'
394              which makes GIMP interpret the size as being specified in bytes,
395              kilobytes, megabytes or gigabytes. If no suffix is specified the
396              size defaults to being specified in kilobytes.
397
398
399       (color-management
400                  (mode display)
401                  (display-profile-from-gdk no)
402                  (display-rendering-intent relative-colorimetric)
403                  (display-use-black-point-compensation yes)
404                  (display-optimize yes)
405                  (simulation-rendering-intent perceptual)
406                  (simulation-use-black-point-compensation no)
407                  (simulation-optimize yes)
408                  (simulation-gamut-check no)
409                  (out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000))
410                  (display-module "CdisplayLcms"))
411
412              Defines the color management  behavior.   This  is  a  parameter
413              list.
414
415
416       (save-document-history yes)
417
418              Keep  a  permanent  record  of all opened and saved files in the
419              Recent Documents list.  Possible values are yes and no.
420
421
422       (quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000))
423
424              Sets the default quick mask color.  The color  is  specified  in
425              the  form  (color-rgba red green blue alpha) with channel values
426              as floats in the range of 0.0 to 1.0.
427
428
429       (import-promote-float no)
430
431              Promote imported images to floating point  precision.  Does  not
432              apply to indexed images.  Possible values are yes and no.
433
434
435       (import-promote-dither yes)
436
437              When promoting imported images to floating point precision, also
438              add minimal noise in order to distribute  color  values  a  bit.
439              Possible values are yes and no.
440
441
442       (import-add-alpha no)
443
444              Add an alpha channel to all layers of imported images.  Possible
445              values are yes and no.
446
447
448       (import-raw-plug-in "")
449
450              Which plug-in to use for importing  raw  digital  camera  files.
451              This is a single filename.
452
453
454       (export-file-type png)
455
456              Export file type used by default.  Possible values are png, jpg,
457              ora, psd, pdf, tif, bmp and webp.
458
459
460       (export-color-profile yes)
461
462              Export the image's color profile by  default.   Possible  values
463              are yes and no.
464
465
466       (export-metadata-exif yes)
467
468              Export  Exif  metadata  by default.  Possible values are yes and
469              no.
470
471
472       (export-metadata-xmp yes)
473
474              Export XMP metadata by default.  Possible values are yes and no.
475
476
477       (export-metadata-iptc yes)
478
479              Export IPTC metadata by default.  Possible values  are  yes  and
480              no.
481
482
483       (debug-policy fatal)
484
485              Try  generating  debug  data for bug reporting when appropriate.
486              Possible values are warning, critical, fatal and never.
487
488
489       (transparency-size medium-checks)
490
491              Sets the size of the checkerboard used to display  transparency.
492              Possible  values  are  small-checks,  medium-checks  and  large-
493              checks.
494
495
496       (transparency-type gray-checks)
497
498              Sets the manner in which transparency is  displayed  in  images.
499              Possible  values  are  light-checks,  gray-checks,  dark-checks,
500              white-only, gray-only and black-only.
501
502
503       (snap-distance 8)
504
505              This is the distance in pixels where  Guide  and  Grid  snapping
506              activates.  This is an integer value.
507
508
509       (marching-ants-speed 200)
510
511              Speed  of marching ants in the selection outline.  This value is
512              in milliseconds (less time indicates faster marching).  This  is
513              an integer value.
514
515
516       (resize-windows-on-zoom no)
517
518              When  enabled, the image window will automatically resize itself
519              when zooming into and out of images.  This  setting  only  takes
520              effect in multi-window mode.  Possible values are yes and no.
521
522
523       (resize-windows-on-resize no)
524
525              When  enabled, the image window will automatically resize itself
526              whenever the physical image  size  changes.  This  setting  only
527              takes  effect in multi-window mode.  Possible values are yes and
528              no.
529
530
531       (default-dot-for-dot yes)
532
533              When enabled, this will ensure that each pixel of an image  gets
534              mapped  to  a  pixel on the screen.  Possible values are yes and
535              no.
536
537
538       (initial-zoom-to-fit yes)
539
540              When enabled, this will ensure that the full  image  is  visible
541              after  a  file  is opened, otherwise it will be displayed with a
542              scale of 1:1.  Possible values are yes and no.
543
544
545       (cursor-mode tool-crosshair)
546
547              Sets the type of mouse pointers to  use.   Possible  values  are
548              tool-icon, tool-crosshair and crosshair.
549
550
551       (cursor-updating yes)
552
553              Context-dependent  mouse pointers are helpful.  They are enabled
554              by default.  However, they require overhead that you may want to
555              do without.  Possible values are yes and no.
556
557
558       (show-brush-outline yes)
559
560              When enabled, all paint tools will show a preview of the current
561              brush's outline.  Possible values are yes and no.
562
563
564       (show-paint-tool-cursor yes)
565
566              When enabled, the mouse pointer will be  shown  over  the  image
567              while using a paint tool.  Possible values are yes and no.
568
569
570       (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
571
572              Sets  the text to appear in image window titles.  This is a for‐
573              mat string; certain % character  sequences  are  recognised  and
574              expanded as follows:
575
576              %%  literal percent sign
577              %f  bare filename, or "Untitled"
578              %F  full path to file, or "Untitled"
579              %p  PDB image id
580              %i  view instance number
581              %t  image type (RGB, grayscale, indexed)
582              %z  zoom factor as a percentage
583              %s  source scale factor
584              %d  destination scale factor
585              %Dx  expands to x if the image is dirty, the empty string other‐
586              wise
587              %Cx expands to x if the image is clean, the empty string  other‐
588              wise
589              %B   expands  to  (modified)  if  the  image is dirty, the empty
590              string otherwise
591              %A  expands to (clean) if the image is clean, the  empty  string
592              otherwise
593              %Nx  expands to x if the image is export-dirty, the empty string
594              otherwise
595              %Ex expands to x if the image is export-clean, the empty  string
596              otherwise
597              %l  the number of layers
598              %L  the number of layers (long form)
599              %m  memory used by the image
600              %n  the name of the active layer/channel
601              %P  the PDB id of the active layer/channel
602              %w  image width in pixels
603              %W  image width in real-world units
604              %h  image height in pixels
605              %H  image height in real-world units
606              %M  the image size expressed in megapixels
607              %u  unit symbol
608              %U  unit abbreviation
609              %x  the width of the active layer/channel in pixels
610              %X  the width of the active layer/channel in real-world units
611              %y  the height of the active layer/channel in pixels
612              %Y  the height of the active layer/channel in real-world units
613              %o  the name of the image's color profile
614
615
616
617       (image-status-format "%n (%m)")
618
619              Sets  the text to appear in image window status bars.  This is a
620              format string; certain % character sequences are recognised  and
621              expanded as follows:
622
623              %%  literal percent sign
624              %f  bare filename, or "Untitled"
625              %F  full path to file, or "Untitled"
626              %p  PDB image id
627              %i  view instance number
628              %t  image type (RGB, grayscale, indexed)
629              %z  zoom factor as a percentage
630              %s  source scale factor
631              %d  destination scale factor
632              %Dx  expands to x if the image is dirty, the empty string other‐
633              wise
634              %Cx expands to x if the image is clean, the empty string  other‐
635              wise
636              %B   expands  to  (modified)  if  the  image is dirty, the empty
637              string otherwise
638              %A  expands to (clean) if the image is clean, the  empty  string
639              otherwise
640              %Nx  expands to x if the image is export-dirty, the empty string
641              otherwise
642              %Ex expands to x if the image is export-clean, the empty  string
643              otherwise
644              %l  the number of layers
645              %L  the number of layers (long form)
646              %m  memory used by the image
647              %n  the name of the active layer/channel
648              %P  the PDB id of the active layer/channel
649              %w  image width in pixels
650              %W  image width in real-world units
651              %h  image height in pixels
652              %H  image height in real-world units
653              %M  the image size expressed in megapixels
654              %u  unit symbol
655              %U  unit abbreviation
656              %x  the width of the active layer/channel in pixels
657              %X  the width of the active layer/channel in real-world units
658              %y  the height of the active layer/channel in pixels
659              %Y  the height of the active layer/channel in real-world units
660              %o  the name of the image's color profile
661
662
663
664       (monitor-xresolution 96.000000)
665
666              Sets  the monitor's horizontal resolution, in dots per inch.  If
667              set to 0, forces the X server to be queried for both  horizontal
668              and vertical resolution information.  This is a float value.
669
670
671       (monitor-yresolution 96.000000)
672
673              Sets  the  monitor's  vertical resolution, in dots per inch.  If
674              set to 0, forces the X server to be queried for both  horizontal
675              and vertical resolution information.  This is a float value.
676
677
678       (monitor-resolution-from-windowing-system yes)
679
680              When enabled, GIMP will use the monitor resolution from the win‐
681              dowing system.  Possible values are yes and no.
682
683
684       (navigation-preview-size medium)
685
686              Sets the size of the navigation preview available in  the  lower
687              right  corner  of  the  image window.  Possible values are tiny,
688              extra-small, small, medium, large, extra-large,  huge,  enormous
689              and gigantic.
690
691
692       (default-view
693                  (show-menubar yes)
694                  (show-statusbar yes)
695                  (show-rulers yes)
696                  (show-scrollbars yes)
697                  (show-selection yes)
698                  (show-layer-boundary yes)
699                  (show-guides yes)
700                  (show-grid no)
701                  (show-sample-points yes)
702                  (snap-to-guides yes)
703                  (snap-to-grid no)
704                  (snap-to-canvas no)
705                  (snap-to-path no)
706                  (padding-mode default)
707                  (padding-color (color-rgb 1.000000 1.000000 1.000000)))
708
709              Sets the default settings for the image view.  This is a parame‐
710              ter list.
711
712
713       (default-fullscreen-view
714                  (show-menubar yes)
715                  (show-statusbar yes)
716                  (show-rulers yes)
717                  (show-scrollbars yes)
718                  (show-selection yes)
719                  (show-layer-boundary yes)
720                  (show-guides yes)
721                  (show-grid no)
722                  (show-sample-points yes)
723                  (snap-to-guides yes)
724                  (snap-to-grid no)
725                  (snap-to-canvas no)
726                  (snap-to-path no)
727                  (padding-mode default)
728                  (padding-color (color-rgb 1.000000 1.000000 1.000000)))
729
730              Sets the default settings  used  when  an  image  is  viewed  in
731              fullscreen mode.  This is a parameter list.
732
733
734       (activate-on-focus yes)
735
736              When  enabled,  an  image  will become the active image when its
737              image window receives the focus. This is useful for window  man‐
738              agers using "click to focus".
739               Possible values are yes and no.
740
741
742       (space-bar-action pan)
743
744              What  to  do  when the space bar is pressed in the image window.
745              Possible values are none, pan and move.
746
747
748       (zoom-quality high)
749
750              There's a tradeoff between speed and quality of  the  zoomed-out
751              display.  Possible values are low and high.
752
753
754       (use-event-history no)
755
756              Bugs  in  event history buffer are frequent so in case of cursor
757              offset problems turning it off helps.  Possible values  are  yes
758              and no.
759
760
761       (move-tool-changes-active no)
762
763              If  enabled,  the  move  tool  sets  the edited layer or path as
764              active.  This used to be the default  behaviour  in  older  ver‐
765              sions.  Possible values are yes and no.
766
767
768       (filter-tool-max-recent 10)
769
770              How  many  recent settings to keep around in filter tools.  This
771              is an integer value.
772
773
774       (filter-tool-use-last-settings no)
775
776              Default to the last used settings  in  filter  tools.   Possible
777              values are yes and no.
778
779
780       (filter-tool-show-color-options no)
781
782              Show  advanced  color  options in filter tools.  Possible values
783              are yes and no.
784
785
786       (trust-dirty-flag no)
787
788              When enabled, GIMP will not save an image if  it  has  not  been
789              changed since it was opened.  Possible values are yes and no.
790
791
792       (save-device-status yes)
793
794              Remember the current tool, pattern, color, and brush across GIMP
795              sessions.  Possible values are yes and no.
796
797
798       (devices-share-tool no)
799
800              When enabled, the same tool and tool options will  be  used  for
801              all  input  devices. No tool switching will occur when the input
802              device changes.  Possible values are yes and no.
803
804
805       (save-session-info yes)
806
807              Save the positions and sizes  of  the  main  dialogs  when  GIMP
808              exits.  Possible values are yes and no.
809
810
811       (restore-session yes)
812
813              Let GIMP try to restore your last saved session on each startup.
814              Possible values are yes and no.
815
816
817       (restore-monitor no)
818
819              When enabled, GIMP will try to restore windows  on  the  monitor
820              they  were  open  before.  When disabled, windows will appear on
821              the currently used monitor.  Possible values are yes and no.
822
823
824       (save-tool-options yes)
825
826              Save the tool options when GIMP exits.  Possible values are  yes
827              and no.
828
829
830       (show-tooltips yes)
831
832              Show  a  tooltip when the pointer hovers over an item.  Possible
833              values are yes and no.
834
835
836       (tearoff-menus yes)
837
838              When enabled, menus can be torn off.  Possible  values  are  yes
839              and no.
840
841
842       (can-change-accels no)
843
844              When  enabled,  you can change keyboard shortcuts for menu items
845              by hitting a key combination while the menu item is highlighted.
846              Possible values are yes and no.
847
848
849       (save-accels yes)
850
851              Save  changed keyboard shortcuts when GIMP exits.  Possible val‐
852              ues are yes and no.
853
854
855       (restore-accels yes)
856
857              Restore saved keyboard shortcuts on each GIMP startup.  Possible
858              values are yes and no.
859
860
861       (last-opened-size 10)
862
863              How  many  recently  opened  image filenames to keep on the File
864              menu.  This is an integer value.
865
866
867       (max-new-image-size 128M)
868
869              GIMP will warn the user if an attempt is made to create an image
870              that  would  take more memory than the size specified here.  The
871              integer size can contain a suffix of 'B', 'K', 'M' or 'G'  which
872              makes GIMP interpret the size as being specified in bytes, kilo‐
873              bytes, megabytes or gigabytes. If no  suffix  is  specified  the
874              size defaults to being specified in kilobytes.
875
876
877       (toolbox-color-area yes)
878
879              Show  the  current foreground and background colors in the tool‐
880              box.  Possible values are yes and no.
881
882
883       (toolbox-foo-area no)
884
885              Show the currently selected brush, pattern and gradient  in  the
886              toolbox.  Possible values are yes and no.
887
888
889       (toolbox-image-area no)
890
891              Show the currently active image in the toolbox.  Possible values
892              are yes and no.
893
894
895       (toolbox-wilber yes)
896
897              Show the GIMP mascot at the top of the toolbox.  Possible values
898              are yes and no.
899
900
901       (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
902
903              Sets  the  theme search path.  This is a colon-separated list of
904              folders to search.
905
906
907       (theme "Dark")
908
909              The name of the theme to use.  This is a string value.
910
911
912       (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
913
914              Sets the icon theme search path.  This is a colon-separated list
915              of folders to search.
916
917
918       (icon-theme "Symbolic")
919
920              The name of the icon theme to use.  This is a string value.
921
922
923       (icon-size auto)
924
925              The  size of the icons to use.  Possible values are auto, theme,
926              small, medium, large and huge.
927
928
929       (use-help yes)
930
931              When enabled, pressing F1 will open the help browser.   Possible
932              values are yes and no.
933
934
935       (show-help-button yes)
936
937              When  enabled, dialogs will show a help button that gives access
938              to the related help page.  Without this button,  the  help  page
939              can  still  be  reached by pressing F1.  Possible values are yes
940              and no.
941
942
943       (help-locales "")
944
945              Specifies the language preferences used by the help system. This
946              is  a colon-separated list of language identifiers with decreas‐
947              ing priority. If empty, the language is taken  from  the  user's
948              locale setting.  This is a string value.
949
950
951       (help-browser gimp)
952
953              Sets  the  browser used by the help system.  Possible values are
954              gimp and web-browser.
955
956
957       (search-show-unavailable-actions no)
958
959              When enabled, a search of  actions  will  also  return  inactive
960              actions.  Possible values are yes and no.
961
962
963       (action-history-size 100)
964
965              The  maximum  number  of  actions  saved in history.  This is an
966              integer value.
967
968
969       (user-manual-online no)
970
971              When enabled, the online user manual will be used  by  the  help
972              system.  Otherwise the locally installed copy is used.  Possible
973              values are yes and no.
974
975
976       (user-manual-online-uri "https://docs.gimp.org/2.10")
977
978              The location of the online user manual. This is used  if  'user-
979              manual-online' is enabled.  This is a string value.
980
981
982       (dock-window-hint utility)
983
984              The window type hint that is set on dock windows and the toolbox
985              window. This may affect the way your  window  manager  decorates
986              and  handles these windows.  Possible values are normal, utility
987              and keep-above.
988
989
990       (cursor-handedness right)
991
992              Sets the handedness for cursor positioning.  Possible values are
993              left and right.
994
995
996       (playground-npd-tool no)
997
998              Enable  the  N-Point  Deformation tool.  Possible values are yes
999              and no.
1000
1001
1002       (playground-seamless-clone-tool no)
1003
1004              Enable the Seamless Clone tool.  Possible values are yes and no.
1005
1006
1007       (color-profile-policy ask)
1008
1009              How to handle embedded color profiles when opening a file.  Pos‐
1010              sible values are ask, keep and convert.
1011
1012
1013
1014       Sets  the default folder path for all color profile file dialogs.  This
1015       is a
1016              single filename.
1017
1018
1019       (image-convert-profile-intent relative-colorimetric)
1020
1021              Sets the default rendering intent for the 'Convert to Color Pro‐
1022              file'  dialog.  Possible values are perceptual, relative-colori‐
1023              metric, saturation and absolute-colorimetric.
1024
1025
1026       (image-convert-profile-black-point-compensation yes)
1027
1028              Sets the default 'Black Point Compensation' state for the  'Con‐
1029              vert to Color Profile' dialog.  Possible values are yes and no.
1030
1031
1032       (image-convert-precision-layer-dither-method none)
1033
1034              Sets  the default layer dithering method for the 'Convert Preci‐
1035              sion' dialog.  Possible values are none, floyd-steinberg, bayer,
1036              random,  random-covariant,  add,  add-covariant,  xor  and  xor-
1037              covariant.
1038
1039
1040       (image-convert-precision-text-layer-dither-method none)
1041
1042              Sets the default text layer dithering method  for  the  'Convert
1043              Precision'  dialog.   Possible values are none, floyd-steinberg,
1044              bayer, random, random-covariant,  add,  add-covariant,  xor  and
1045              xor-covariant.
1046
1047
1048       (image-convert-precision-channel-dither-method none)
1049
1050              Sets  the default channel dithering method for the 'Convert Pre‐
1051              cision' dialog.   Possible  values  are  none,  floyd-steinberg,
1052              bayer,  random,  random-covariant,  add,  add-covariant, xor and
1053              xor-covariant.
1054
1055
1056       (image-convert-indexed-palette-type generate)
1057
1058              Sets the default palette type for the 'Convert to Indexed'  dia‐
1059              log.  Possible values are generate, web, mono and custom.
1060
1061
1062       (image-convert-indexed-max-colors 256)
1063
1064              Sets  the  default  maximum number of colors for the 'Convert to
1065              Indexed' dialog.
1066               This is an integer value.
1067
1068
1069       (image-convert-indexed-remove-duplicates yes)
1070
1071              Sets the default 'Remove duplicate colors' state for  the  'Con‐
1072              vert to Indexed' dialog.  Possible values are yes and no.
1073
1074
1075       (image-convert-indexed-dither-type none)
1076
1077              Sets  the  default  dithering  type for the 'Convert to Indexed'
1078              dialog.  Possible values are none, fs, fs-lowbleed and fixed.
1079
1080
1081       (image-convert-indexed-dither-alpha no)
1082
1083              Sets the default  'Dither  alpha'  state  for  the  'Convert  to
1084              Indexed' dialog.  Possible values are yes and no.
1085
1086
1087       (image-convert-indexed-dither-text-layers no)
1088
1089              Sets  the default 'Dither text layers' state for the 'Convert to
1090              Indexed' dialog.  Possible values are yes and no.
1091
1092
1093       (image-resize-fill-type transparent)
1094
1095              Sets the default fill type for the 'Canvas Size' dialog.  Possi‐
1096              ble  values  are  foreground, background, white, transparent and
1097              pattern.
1098
1099
1100       (image-resize-layer-set none)
1101
1102              Sets the default set of layers to resize for the  'Canvas  Size'
1103              dialog.  Possible values are none, all, image-sized, visible and
1104              linked.
1105
1106
1107       (image-resize-resize-text-layers no)
1108
1109              Sets the default 'Resize text  layers'  state  for  the  'Canvas
1110              Size' dialog.  Possible values are yes and no.
1111
1112
1113       (layer-new-name "Layer")
1114
1115              Sets the default layer name for the 'New Layer' dialog.  This is
1116              a string value.
1117
1118
1119       (layer-new-mode normal)
1120
1121              Sets the default mode for the 'New Layer' dialog.  Possible val‐
1122              ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1123              screen-legacy,  overlay-legacy,   difference-legacy,   addition-
1124              legacy,   subtract-legacy,   darken-only-legacy,   lighten-only-
1125              legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1126              hsv-value-legacy,   divide-legacy,   dodge-legacy,  burn-legacy,
1127              hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1128              merge-legacy,  color-erase-legacy, overlay, lch-hue, lch-chroma,
1129              lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1130              ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1131              hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1132              light,  softlight, grain-extract, grain-merge, vivid-light, pin-
1133              light, linear-light,  hard-mix,  exclusion,  linear-burn,  luma-
1134              darken-only,  luma-lighten-only,  luminance, color-erase, erase,
1135              merge, split, pass-through, replace and anti-erase.
1136
1137
1138       (layer-new-blend-space auto)
1139
1140              Sets the default blend space for the 'New Layer' dialog.  Possi‐
1141              ble values are auto, rgb-linear, rgb-perceptual and lab.
1142
1143
1144       (layer-new-composite-space auto)
1145
1146              Sets  the  default  composite  space for the 'New Layer' dialog.
1147              Possible values are auto, rgb-linear, rgb-perceptual and lab.
1148
1149
1150       (layer-new-composite-mode auto)
1151
1152              Sets the default composite mode  for  the  'New  Layer'  dialog.
1153              Possible values are auto, union, clip-to-backdrop, clip-to-layer
1154              and intersection.
1155
1156
1157       (layer-new-opacity 1.000000)
1158
1159              Sets the default opacity for the 'New Layer' dialog.  This is  a
1160              float value.
1161
1162
1163       (layer-new-fill-type transparent)
1164
1165              Sets the default fill type for the 'New Layer' dialog.  Possible
1166              values are foreground, background, white, transparent  and  pat‐
1167              tern.
1168
1169
1170       (layer-resize-fill-type transparent)
1171
1172              Sets the default fill type for the 'Layer Boundary Size' dialog.
1173              Possible values are foreground, background,  white,  transparent
1174              and pattern.
1175
1176
1177       (layer-add-mask-type white)
1178
1179              Sets the default mask for the 'Add Layer Mask' dialog.  Possible
1180              values are white, black, alpha, alpha-transfer, selection,  copy
1181              and channel.
1182
1183
1184       (layer-add-mask-invert no)
1185
1186              Sets  the  default  'invert mask' state for the 'Add Layer Mask'
1187              dialog.  Possible values are yes and no.
1188
1189
1190       (layer-merge-type expand-as-necessary)
1191
1192              Sets the default merge type for the 'Merge Visible Layers'  dia‐
1193              log.   Possible  values  are expand-as-necessary, clip-to-image,
1194              clip-to-bottom-layer and flatten-image.
1195
1196
1197       (layer-merge-active-group-only yes)
1198
1199              Sets the default 'Active group only' for the 'Merge Visible Lay‐
1200              ers' dialog.  Possible values are yes and no.
1201
1202
1203       (layer-merge-discard-invisible no)
1204
1205              Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1206              ers' dialog.  Possible values are yes and no.
1207
1208
1209       (channel-new-name "Channel")
1210
1211              Sets the default channel name  for  the  'New  Channel'  dialog.
1212              This is a string value.
1213
1214
1215       (channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000))
1216
1217              Sets the default color and opacity for the 'New Channel' dialog.
1218              The color is specified in the form (color-rgba  red  green  blue
1219              alpha) with channel values as floats in the range of 0.0 to 1.0.
1220
1221
1222       (path-new-name "Path")
1223
1224              Sets the default path name for the 'New Path' dialog.  This is a
1225              string value.
1226
1227
1228
1229       Sets the default folder path for the 'Export Path' dialog.  This  is  a
1230       single
1231              filename.
1232
1233
1234       (path-export-active-only yes)
1235
1236              Sets  the default 'Export the active path' state for the 'Export
1237              Path' dialog.  Possible values are yes and no.
1238
1239
1240
1241       Sets the default folder path for the 'Import Path' dialog.  This  is  a
1242       single
1243              filename.
1244
1245
1246       (path-import-merge no)
1247
1248              Sets  the  default  'Merge imported paths' state for the 'Import
1249              Path' dialog.  Possible values are yes and no.
1250
1251
1252       (path-import-scale no)
1253
1254              Sets the default 'Scale imported paths to fit  size'  state  for
1255              the 'Import Path' dialog.  Possible values are yes and no.
1256
1257
1258       (selection-feather-radius 5.000000)
1259
1260              Sets the default feather radius for the 'Feather Selection' dia‐
1261              log.  This is a float value.
1262
1263
1264       (selection-grow-radius 1.000000)
1265
1266              Sets the default grow radius for the  'Grow  Selection'  dialog.
1267              This is a float value.
1268
1269
1270       (selection-shrink-radius 1.000000)
1271
1272              Sets  the  default shrink radius for the 'Shrink Selection' dia‐
1273              log.  This is a float value.
1274
1275
1276       (selection-shrink-edge-lock no)
1277
1278              Sets the default 'Selected areas  continue  outside  the  image'
1279              setting  for the 'Shrink Selection' dialog.  Possible values are
1280              yes and no.
1281
1282
1283       (selection-border-radius 5.000000)
1284
1285              Sets the default border radius for the 'Border  Selection'  dia‐
1286              log.  This is a float value.
1287
1288
1289       (selection-border-style smooth)
1290
1291              Sets the default border style for the 'Border Selection' dialog.
1292              Possible values are hard, smooth and feathered.
1293
1294
1295       (selection-border-edge-lock no)
1296
1297              Sets the default 'Selected areas  continue  outside  the  image'
1298              setting  for the 'Border Selection' dialog.  Possible values are
1299              yes and no.
1300
1301
1302       (fill-options
1303                  (style solid)
1304                  (antialias yes)
1305                  (feather no)
1306                  (feather-radius 10.000000))
1307
1308              The default fill options for the fill dialogs.  This is a param‐
1309              eter list.
1310
1311
1312       (stroke-options
1313                  (style solid)
1314                  (antialias yes)
1315                  (feather no)
1316                  (feather-radius 10.000000)
1317                  (method line)
1318                  (width 6.000000)
1319                  (unit pixels)
1320                  (cap-style butt)
1321                  (join-style miter)
1322                  (miter-limit 10.000000)
1323                  (dash-offset 0.000000)
1324                  (dash-info 0)
1325                  (emulate-brush-dynamics no))
1326
1327              The  default  stroke  options for the stroke dialogs.  This is a
1328              parameter list.
1329
1330
1331       (fractalexplorer-path                           "${gimp_dir}/fractalex‐
1332       plorer:${gimp_data_dir}/fractalexplorer")
1333
1334              Where  to search for fractals used by the Fractal Explorer plug-
1335              in.  This is a colon-separated list of folders to search.
1336
1337
1338       (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1339
1340              Where to search for Gfig figures used by the Gfig plug-in.  This
1341              is a colon-separated list of folders to search.
1342
1343
1344       (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1345
1346              Where to search for gflares used by the GFlare plug-in.  This is
1347              a colon-separated list of folders to search.
1348
1349
1350       (gimpressionist-path  "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1351       pressionist")
1352
1353              Where  to  search  for  data used by the Gimpressionist plug-in.
1354              This is a colon-separated list of folders to search.
1355
1356
1357       (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1358
1359              This path will be searched for scripts when the Script-Fu  plug-
1360              in is run.  This is a colon-separated list of folders to search.
1361
1362

PATH EXPANSION

1364       Strings  of  type  PATH  are  expanded  in a manner similar to bash(1).
1365       Specifically: tilde (~) is expanded to the user's home directory.  Note
1366       that  the  bash  feature  of  being  able to refer to other user's home
1367       directories by writing ~userid/ is not valid in this file.
1368
1369       ${variable} is expanded to the current value of  an  environment  vari‐
1370       able.  There are a few variables that are pre-defined:
1371
1372       gimp_dir
1373              The  personal  gimp  directory  which is set to the value of the
1374              environment   variable   GIMP2_DIRECTORY   or    to    $XDG_CON‐
1375              FIG_HOME/GIMP/2.10.
1376
1377       gimp_data_dir
1378              Base  for  paths to shareable data, which is set to the value of
1379              the environment variable GIMP2_DATADIR  or  to  the  compiled-in
1380              default value /usr/share/gimp/2.0.
1381
1382       gimp_plug_in_dir
1383              Base  to  paths  for architecture-specific plug-ins and modules,
1384              which  is  set  to  the  value  of  the   environment   variable
1385              GIMP2_PLUGINDIR    or   to   the   compiled-in   default   value
1386              /usr/lib64/gimp/2.0.
1387
1388       gimp_sysconf_dir
1389              Path to configuration files, which is set to the  value  of  the
1390              environment  variable  GIMP2_SYSCONFDIR  or  to  the compiled-in
1391              default value /etc/gimp/2.0.
1392
1393       gimp_cache_dir
1394              Path to cached files, which is set to the value of the  environ‐
1395              ment  variable  GIMP2_CACHEDIR or to the system default for per-
1396              user cached files.
1397
1398       gimp_temp_dir
1399              Path to temporary files, which is set to the value of the  envi‐
1400              ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1401              porary files.
1402
1403

FILES

1405       /etc/gimp/2.0/gimprc
1406              System-wide configuration file
1407
1408       $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1409              Per-user configuration file
1410
1411

SEE ALSO

1413       gimp(1)
1414
1415
1416
1417GIMP Manual Pages               Version 2.10.10                      GIMPRC(5)
Impressum